Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/gvaliente/butano

Modern C++ high level GBA engine
https://github.com/gvaliente/butano

game-boy-advance game-engine gba modern-cpp

Last synced: 2 days ago
JSON representation

Modern C++ high level GBA engine

Awesome Lists containing this project

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), 

[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): 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): 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): 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).