Install

Note: For the moment, the Build Tool is only compatible with Windows OS.

Mandatory steps

1️⃣ Create a directory (name it "MSXgl" e.g.).

2️⃣ Install the engine:

• Clone the Git repository https://github.com/aoineko-fr/MSXgl.git (v0.3.0-alpha tag),
• or Download and unzip the latest version of the engine.

3️⃣ Install SDCC version 4.1.12 or newer (in "MSXgl\tools\SDCC" e.g.).

• If you use an other directory to install SDCC, change the SDCC path in "MSXgl\project\build_config.cmd".

✅ You are done! You can start testing library samples or create your own brand new game!

Optional steps

Recommended: To allow the Build Tool to launch your game after building, please install an MSX emulator (here the list of supported emulators).

For example, install OpenMSX in \tools\openMSX (or change the path to emulator in "MSXgl\project\build_config.cmd)