gbforth

A Forth-based Game Boy development kit

It features a Forth-based assembler, a cross-compiler with support for lazy code generation and a library of useful words.

Contributing

The best way to contribute would be try to write a game! Then we can, at the same time, improve gbforth to make it more useful.

For more detailed guidelines read the contribution guide.

Also have a look to the issues in GitHub:

brew install gforth

To build the examples, run

make examples

To run the tests, you need to have nodejs and yarn installed. Make sure to install the dependencies in the test/ directory first:

( cd test/; yarn )

After that you can run the tests:

make check

You can run gbforth in Docker using the amshackers/gbforth image:

docker run amshackers/gbforth

To compile your project, mount your project directory as a volume and pass the input and output file as CLI arguments:

docker run --rm -v "$PWD":/data amshackers/gbforth game.fs game.gb