SGDK Helper

This is a helper script for developing on Linux with Stephane Dallongeville's excellent SGDK.

To generate a suitable cross compiler, SGDK Helper uses Andrew DeRosier's m68k-gcc-toolchain Makefile.

Usage

SGDK Helper supports both containerized and native workflows. The advantage of the former is you don't need to install loads of dependencies on your machine, just a container tool.

To check if you have a container tool run:

./sgdk-helper.sh container_tool

It will report podman or docker if you have either tool installed.

Note: If you have both, podman is used in preference.

If you don't have one, either install one now or continue with native setup. To install podman on a Debian based system, run:

sudo apt install podman

Container setup

We build our own container with the dependencies we need for SGDK development based on a slimmed down Debian container.

./sgdk-helper.sh container

Native setup

./sgdk-helper.sh toolchain
./sgdk-helper.sh deps

SGDK development

Now that the setup is complete, we can use SGDK Helper for development of a Mega Drive project.

From the top directory of an SGDK project, build the ROM with:

sgdk-helper.sh rom

Note: An SGDK project looks like this example from SGDK. There are many others both in the SGDK project and around GitHub.

And you can run the built ROM in BlastEm, if it's installed natively, with:

sgdk-helper.sh run

Note: Further documentation coming soon. For now, see the documentation in the script.