https://github.com/asiekierka/gbsenpai

GB Studio Extended Nominal Player Adaptation/Interface
https://github.com/asiekierka/gbsenpai

Last synced: about 2 months ago
JSON representation

GB Studio Extended Nominal Player Adaptation/Interface

• Host: GitHub
• URL: https://github.com/asiekierka/gbsenpai
• Owner: asiekierka
• License: mit
• Created: 2021-06-13T10:50:20.000Z (over 3 years ago)
• Default Branch: main
• Last Pushed: 2021-07-14T17:41:09.000Z (about 3 years ago)
• Last Synced: 2024-04-16T21:19:36.588Z (5 months ago)
• Language: C
• Homepage:
• Size: 208 KB
• Stars: 91
• Watchers: 8
• Forks: 2
• Open Issues: 5
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-gba-dev-zh - gbsenpai - GB Studio 播放器 GBA 端口有了一些增强。 (工具包)
• awesome-gbadev - gbsenpai - GB Studio player GBA port with some enhancements. (Toolkits / Other places)

README

        
# gbsenpai

**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.

![GB Studio v2 color sample running within gbsenpai.](https://img.asie.pl/atKY.png)

[Proof of concept video](https://img.asie.pl/adKi.mp4)

## Compatibility

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

## Porting your game

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.

### GBA

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](https://gbstudiocentral.com/tips/gbsenpai/).

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

### NDS

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.

## License

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