Docs / Engine Eject
New in 2.0.0
Engine Eject copies the GBDK code 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 build your game. Error messages can be found in the Build & Run window.
Errors for problematic files will claim that the compiler couldn't find a file that was meant to be included:
..\_gbstools\gbdk\bin\lcc: can't find 'C:/.../_gbsbuild/obj/Platform.o'
..\_gbstools\gbdk\bin\lcc: can't find 'C:/.../_gbsbuild/obj/TopDown.o'
These errors will not be caused by missing files. GB Studio refers to its GBDK defaults 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.