Getting Started - boxgaming/gx GitHub Wiki

Prerequisites

If you're planning to build a GX game in QBJS, there is no additional setup required. Just go to https://qbjs.org and start coding. You can skip the rest of this page.

If you are planning to do your development in QB64 you'll first need to download and install the QB64 compiler from either the QB64 Official or QB64 Phoenix repository.

Installing GX

Download the latest release here. Unzip the contents into your project directory.

Building the GX engine tools

The following step will build the GX Map Maker and any other project binaries.

In a command window change the current directory to the location where you unzipped the gx project. Next, let's set an environment variable to let the build script know where you installed QB64.

On Windows:

> set QB64_HOME=C:\basic\qb64

On MacOS and Linux:

> export QB64_HOME=~/qb64

Then run the build script:

On Windows:

> build.bat

On MacOS and Linux:

: /bin/sh build.sh

You should see the following message:

QB64 Compiler V2.0.2

Beginning C++ output from QB64 code... 

Beginning C++ output from QB64 code... 
[..................................................] 100%

Compiling C++ code into executable...

Try it out

Go to the samples directory and open one of the samples in QB64. Press F5 to run the sample.

When you're ready to learn more, check out the Basic Concepts page for an overview of the engine or head over to the Tutorial page to build your first game.