Docs / Building Your Game
Clicking the Play button in the top right of the Project Editor window will start a build of your game and once complete will open a new window where you can play your game. See Keyboard Shortcuts for details on how to play your game in the Play Window.
Clicking the Project Navigator and selecting Build & Run will take you to the Build Terminal where you can see a log of the project build. You also get to this screen by clicking the Play button while a build is taking place. This screen will show you if there's any errors in your build to help you correct them.
Build as ROM
Clicking the Export button and clicking Export ROM will build your game and create a ROM file in your project's build folder as
$PROJECT_ROOT/build/rom/game.gb. You can play this ROM file in any compatible emulator such as OpenEMU or KiGB.
Build and deploy for Web
Clicking the Export button and clicking Export Web will build your game and create a HTML5 web build in the folder
$PROJECT_ROOT/build/web. You can upload this folder to any web server and navigate to the
index.html file to play your game in a web browser. If you use a mobile or tablet web browser the game will also include touch controls.
If you zip the
build/web folder you can upload it to Itch.io as a HTML game. In this case the recommended viewport size to use is
On macOS if you're having trouble building or running your game you may also need to install Apple's Command Line Tools by opening
Applications/Terminal.app and entering the following command.
On Windows you may need to whitelist the application in your Anti Virus software to perform a build.