gbsenpai - GB Studio Extended Nominal Player Adaptation/Interface - is a project to port the GB Studio player to additional, non-GB/GBC platforms, with support for potential enhancements.

Proof of concept video

gbsenpai should be compatible with source exports made in GB Studio v2.0.0-beta5. Other versions are currently not supported.

First, you need to prepare your game's source code.

1. Create a directory, for example "source_sample". This will be your "game directory".
2. Open GB Studio. From the menu, run Game -> Advanced -> Export project source.
3. There should now be a "build/src" directory in your project folder. From there, copy the following files to your "game directory":
   • all files from src/data,
   • all files from src/music,
   • include/banks.h,
   • include/data_ptrs.h.

Note that if you ejected the engine and made modifications to it, you will have to make equivalent modifications in gbsenpai. This is not an emulator! However, as it is a port, it tries to stick fairly closely to the original source code - the process shouldn't be too difficult.

In addition, you will need:

• a reasonably recent version of Python 3.x.

From here, the instructions differ depending on port.

The GBA port is currently based on the devkitARM toolchain created by the devkitPro organization, alongside the libtonc library.

Alternatively, you can find a tutorial provided by the GB Studio Central here.

1. Edit Makefile.gba. In particular:
   • Set GAME_DIR to your game directory name,
   • Set GAME_CGB to true if your game targets the GBC, and to false otherwise.
2. Run make -f Makefile.gba.
3. Enjoy. (Hopefully. I've only tested this on Linux...)

The NDS port is currently based on the devkitARM toolchain created by the devkitPro organization, alongside the libnds library.

There is some missing functionality:

• Sound is not yet implemented.
• Saving is not yet implemented.

1. Edit Makefile.nds. In particular:
   • Set GAME_DIR to your game directory name,
   • Set GAME_CGB to true if your game targets the GBC, and to false otherwise.
2. Run make -f Makefile.nds.
3. Enjoy.

gbsenpai is licensed under the terms of the MIT license, similar to the original GB Studio engine.