Engine Eject copies the GBVM game engine that GB Studio uses into a folder in your project, named
assets/engine. You can edit these source files to your liking using an IDE to have more control over how your GB Studio game is built. This feature is only recomended for developers familiar with GBDK.
To use Engine Eject, click on Game at the top of the GB Studio window and navigate to the Advanced tab to show the Engine Eject button.
After clicking Eject your project will gain a new folder named
/engine with the subfolders
To revert any GBDK file back to its GB Studio default, delete it from the
assets/engine folder. Deleting the whole
assets/engine folder ensures that all GBDK code reverts back to the GB Studio defaults. You can also do this by pressing Engine Eject again, which will overwrite your
assets/engine folder with the GB Studio defaults.
If you have bugged or incompatible files in the
/engine folder, GB Studio will not be able to build your game. Error messages can be found in the Build & Run window.
The error message will often explain which files have problems and point you to the line number where the problem was found, for example this error is showing that line 77 of
src/core/actor.c is using a variable that has not yet been defined:
src/core/actor.c:77: error 20: Undefined identifier 'emote_offsets'
src/core/actor.c:77: error 22: Array or pointer required for '' operation
src/core/actor.c:77: error 47: indirections to different types assignment
These errors will not be caused by missing files. GB Studio refers to its default engine in place of any missing
assets/engine files. Fixing or removing the files that caused the error will allow your game to build and run again.