# butano **Repository Path**: pppppppppppppppppppp/butano ## Basic Information - **Project Name**: butano - **Description**: No description available - **Primary Language**: Unknown - **License**: Zlib - **Default Branch**: master - **Homepage**: None - **GVP Project**: No ## Statistics - **Stars**: 0 - **Forks**: 0 - **Created**: 2025-05-01 - **Last Updated**: 2025-05-01 ## Categories & Tags **Categories**: Uncategorized **Tags**: None ## README # Butano Butano is a modern C++ high level engine for the [Game Boy Advance](https://en.wikipedia.org/wiki/Game_Boy_Advance). ![](docs_tools/images/examples_mode_7.gif) ![](docs_tools/images/bf_title.gif) ![](docs_tools/images/vr3d_race.gif) ## Features * Create and display sprites, backgrounds, text, raster effects and more with only one line of C++ code. * Custom standard library without heap allocations nor exceptions, based on [ETL](https://www.etlcpp.com/). * Import and use your own assets [with ease](https://gvaliente.github.io/butano/import.html). * Multiple development tools like [asserts](https://gvaliente.github.io/butano/group__assert.html), [emulator logging](https://gvaliente.github.io/butano/group__log.html) and [code profiling](https://gvaliente.github.io/butano/group__profiler.html). * Based on modern C++ concepts like shared ownership and RAII. * Detailed [documentation](https://gvaliente.github.io/butano). * Multiple [examples](https://gvaliente.github.io/butano/examples.html) of most aspects of the engine. * The source code and assets of two full games ([Butano Fighter](#made-with-butano-butano-fighter) and [Varooom 3D](#made-with-butano-varooom-3d)) are provided with this project. ## Supported platforms Butano is built on top of the [devkitARM](https://devkitpro.org/) toolchain, so it supports Windows, macOS and Unix-like platforms. ## What's new Curious about what was added or improved recently? Check out the [changelog](https://gvaliente.github.io/butano/changelog.html) in the documentation. ## Getting started The best way to get started is to read the [download, install and start using Butano guide](https://gvaliente.github.io/butano/getting_started.html). If everything went as expected, you should: * Play around with the [examples](https://gvaliente.github.io/butano/examples.html) as they cover most of what Butano offers. * Learn how to [import your assets](https://gvaliente.github.io/butano/import.html) in your project. * Take a look at the [frequently asked questions (FAQ)](https://gvaliente.github.io/butano/faq.html), as they answer most of the initial questions. ## Third party libraries Butano would have not been possible without these libraries: * GBA hardware access and more provided by [Tonclib](https://www.coranac.com/projects/#tonc), [Universal GBA Library](https://github.com/AntonioND/libugba) and [agbabi](https://github.com/felixjones/agbabi). * Music and sound effects provided by [Maxmod](https://maxmod.devkitpro.org), [Apex Audio System](https://github.com/stuij/apex-audio-system), [GBT Player](https://github.com/AntonioND/gbt-player) and [VGM player](https://github.com/copyrat90/gbadev-ja-test). * Fast number to string conversion provided by [posprintf](http://danposluns.com/danposluns/gbadev/posprintf/index.html). * Fast math routines provided by [gba-modern](https://github.com/JoaoBaptMG/gba-modern) and [Universal GBA Library](https://github.com/AntonioND/libugba). * Fast decompression routines provided by [Cult-of-GBA BIOS](https://github.com/Cult-of-GBA/BIOS). * Multiplayer support provided by [gba-link-connection](https://github.com/rodri042/gba-link-connection). * Pool containers provided by [ETL](https://www.etlcpp.com/). * Unique type ID generation without RTTI provided by [CTTI](https://github.com/Manu343726/ctti). * Stateless random number generator provided by [whisky](https://github.com/velipso/whisky). ## Contact and support If you spotted a bug, need a feature or have an awesome idea, the best you can do is to head over to the [issues page](https://github.com/GValiente/butano/issues), to the [gbadev.net forums](https://forum.gbadev.net) or to the [gbadev Discord server](https://discord.gg/ctGSNxRkg2). ## Licenses Butano is licensed under the zlib license, see the [LICENSE](LICENSE) file for details. Third party libraries are licensed under other licenses, please check the [licenses](licenses) folder for details. Assets used in games, examples and other projects are licensed under other licenses, please check the `credits` folders for details. ## Made with Butano: Butano Fighter Stay alive while you shoot at everything that moves! What else do you need? The full source code and the creative commons assets of this game are in [its project folder](games/butano-fighter). Get the latest Butano Fighter ROM from [itch.io](https://gvaliente.itch.io/butano-fighter). ![](docs_tools/images/bf_title.gif) ![](docs_tools/images/bf_intro.gif) ![](docs_tools/images/bf_bomb.gif) ## Made with Butano: Varooom 3D Action-packed with revolutionary 60FPS 3D technology and 3D glasses (not included) that will have you believing you're in the middle of a circuit race at speeds of 200 KMH! The full source code and the creative commons assets of this game are in [its project folder](games/varooom-3d). Get the latest Varooom 3D ROMs from [itch.io](https://gvaliente.itch.io/varooom-3d). ![](docs_tools/images/vr3d_title.gif) ![](docs_tools/images/vr3d_race.gif) ![](docs_tools/images/vr3d_viewer.gif) ## Also made with Butano * [GBA Microjam '23](https://gbadev.itch.io/gba-microjam-23): a spooky microgame collection for the Game Boy Advance created by the members of the [gbadev.net](https://gbadev.net) community. ![](docs_tools/images/gba_microjam_23_title.png) ![](docs_tools/images/gba_microjam_23_gameplay.png) * [Demons of Asteborg DX](https://neofidstudios.itch.io/demons-of-asteborg-dx): a GBA remake of the infamous Mega Drive game! ![](docs_tools/images/doadx_title.png) ![](docs_tools/images/doadx_gameplay.png) * [BeatBeast](https://afska.itch.io/beat-beast): help Joaquín shoot his way out of this rhythmic world! ![](docs_tools/images/beat_beast_title.png) ![](docs_tools/images/beat_beast_gameplay.png) * [Discrete Orange](https://tardigrade-nx.itch.io/discrete-orange): a turn-based puzzle-platformer with discrete movement. ![](docs_tools/images/discrete_orange_title.png) ![](docs_tools/images/discrete_orange_gameplay.png) * [Feline](https://foopod.itch.io/feline) ([working source code](https://github.com/GValiente/gbaGamejam2021)): explore the world as a cat, meet new people, learn new languages, face difficult foes and save your family! ![](docs_tools/images/feline_title.png) ![](docs_tools/images/feline_gameplay.png) * [Symbol★Merged](https://copyrat90.itch.io/sym-merged): a puzzle platformer game where you can merge items (symbols) in hands, and use the superpower of the merged symbol. ![](docs_tools/images/symbol_merged_title.png) ![](docs_tools/images/symbol_merged_gameplay.png) * [Green Memories](https://tengukaze.itch.io/green-memories-gba): the year is 300 a.f. and protagonist Cytra tries to survive the extreme climate of a post-apocalyptic desert while collecting data from her scientific research. ![](docs_tools/images/green_memories_title.png) ![](docs_tools/images/green_memories_gameplay.png) * [notenogram](https://kva64.itch.io/notenogram): chill analog-styled picross/nonogram/hanjie/griddler game, with story and create modes. ![](docs_tools/images/notenogram_title.png) ![](docs_tools/images/notenogram_gameplay.png) * [LRO - Luggage Retrieval Officer](https://foopod.itch.io/lro) ([working source code](https://github.com/GValiente/lro)): you will work your way to being a highly ranked member off staff, retrieving important missing luggage for the likes of the Natural History Museum, NASA and even the FBI! ![](docs_tools/images/lro_title.png) ![](docs_tools/images/lro_gameplay.png) * [Sleep Paradox](https://staticlinkage.itch.io/sleep-paradox): as student Fredericko you'll explore the school, leveling up as you fight through the hordes, searching for some kind of answer to what is going on. ![](docs_tools/images/sleep_paradox_title.png) ![](docs_tools/images/sleep_paradox_gameplay.png) * [GBA pseudo-3D demo](https://github.com/chrislewisdev/gba-pseudo-3d): Sonic Battle's pseudo-3D rendering demo. ![](docs_tools/images/gba_pseudo_3d_demo_gameplay.png) * [Bridge Quest](https://fixxiefixx.itch.io/bridge-quest): find the way to the desert, but beware, because enemies and an evil tree boss will try to stop you! ![](docs_tools/images/bridge_quest_title.png) ![](docs_tools/images/bridge_quest_gameplay.png) * [Advance! Adventures Of The Math & Logic Club](https://kva64.itch.io/advance-demo-adventures-of-the-math-logic-club): small demo/prototype of a visual novel about joining an ordinary math club. ![](docs_tools/images/advance_amlc_title.png) ![](docs_tools/images/advance_amlc_gameplay.png) * [Toll Runner](https://jenkalab.itch.io/toll-runner): complete 17 levels to find out why the mouse had to run! ![](docs_tools/images/toll_runner_title.png) ![](docs_tools/images/toll_runner_gameplay.png) * [Happy Dawn](https://luife.itch.io/happy-dawn): a hilarious story unfolds about a day in the life of Carlitos, a boy who wakes up on a new, happy day to go to school. ![](docs_tools/images/happy_dawn_gameplay.png) * [Space Evangelion](https://fixxiefixx.itch.io/space-evangelion): you play as an angel fighting evil beeings in space. ![](docs_tools/images/space_evangelion_title.png) ![](docs_tools/images/space_evangelion_gameplay.png) * [Knight Owls](https://blaise-rascal.itch.io/knight-owls) ([working source code](https://github.com/GValiente/KnightOwls)): build up a powerful spellbook and take on many enemies, gather owls and upgrades while managing your health and money and defeat the final boss to win! ![](docs_tools/images/knight_owls_title.png) ![](docs_tools/images/knight_owls_gameplay.png) * [Collie Defense](https://xvayan.itch.io/collie-defense): you're a Border Collie and you need to protect your flock of sheep! ![](docs_tools/images/collie_defence_title.png) ![](docs_tools/images/collie_defence_gameplay.png) * [Detective Monroe: Murder at Sea](https://eragnarok.itch.io/detective-monroe-murder-at-sea): play as Detective Alex Monroe in his new adventure where he solves a murder mystery, while on vacation on a cruise ship! ![](docs_tools/images/detective_monroe_title.png) ![](docs_tools/images/detective_monroe_gameplay.png) * [Sips](https://foopod.itch.io/sips): enjoy watching people while you earn money to upgrade your cafe. ![](docs_tools/images/sips_gameplay.png) * [Work Life](https://jeffzzq.itch.io/work-life): visual novel focusing on relationships in a modern workplace. ![](docs_tools/images/work_life_title.png) ![](docs_tools/images/work_life_gameplay.png) * [Bata Dubnos](https://fralacticus.itch.io/bata-dubnos): shoot the possessed portrait faces and ??? ![](docs_tools/images/bata_dubnos_title.png) ![](docs_tools/images/bata_dubnos_gameplay.png) * [Sys*Crusher](https://drkylstein.itch.io/syscrusher): take on contracts to steal files, crash systems and commit industrial sabotage! ![](docs_tools/images/sys_crusher_title.png) ![](docs_tools/images/sys_crusher_gameplay.png) * [Nuclear Love](https://foopod.itch.io/nuclear-love): have fun getting to know other survivors in this dating-show, who knows, maybe you might find your future Mr. or Mrs Right? ![](docs_tools/images/nuclear_love_title.png) ![](docs_tools/images/nuclear_love_gameplay.png) * [Globlins!](https://jeremyelkayam.itch.io/globlins): early prototype for a single player action platformer with RPG elements and multiple endings. ![](docs_tools/images/goblins_title.png) ![](docs_tools/images/goblins_gameplay.png) * [Tremblay Island](https://cinemint.itch.io/tremblay-island): take on the role of any island villager and interact with the others, taking part in the drama while eventually trying to keep a grouchy alligator from taking over the island. ![](docs_tools/images/tremblay_island_title.png) ![](docs_tools/images/tremblay_island_gameplay.png) * [Frost Princess](https://squishyfrogs.itch.io/frost-princess): place tiles down on the board to create a path to your opponent's base, then place tiles on their base to damage them. ![](docs_tools/images/frost_princess_title.png) ![](docs_tools/images/frost_princess_gameplay.png) * [GBA-NICCC](https://github.com/GValiente/gba-niccc): Game Boy Advance port of the Atari ST demo STNICCC 2000. ![](docs_tools/images/gba-niccc_1.png) ![](docs_tools/images/gba-niccc_2.png) ## More Butano related stuff * [gba-free-fonts](https://github.com/laqieer/gba-free-fonts): free fonts for GBA development. It comes with tools and examples to import them into a Butano project. ![](docs_tools/images/gba_free_fonts_1.png) ![](docs_tools/images/gba_free_fonts_2.png) * [Wavefront To Varooom 3D](https://github.com/nikku4211/wavefront2varooom3d): converter that takes [Wavefront .obj](https://en.wikipedia.org/wiki/Wavefront_.obj_file) files and converts them into the format used by [Varooom 3D](#made-with-butano-varooom-3d).