Getting Started - boxgaming/gx GitHub Wiki

Prerequisites

First, you need to install QB64. Go ahead and do that now if you haven't already. I'll wait here.

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.