Standalone release guide

Getting Started

Download a fresh copy of the latest version of MegaZeux and extract it to a new folder.

Which architectures do I need to release under?

Releasing simply a copy of Windows x86 should be enough to satisfy the majority of people who will play your game. For Mac OS X users, it is recommended that you use the Universal DMG. Standalone releases for Linux platforms are not recommended, as most Linux users will be able to figure out how to use MegaZeux normally and play the standard release of your game.

Which files do I need to include?

These are the only files mandatory to run a MegaZeux game--all other files can be safely deleted for your standalone release. Please note that as of MegaZeux 2.84c, several features will not correctly work from this setup, including the editor, help file, and updater.

mzxrun.exe        (this can be renamed or have the icon changed)
core.dll          MegaZeux core library
sdl.dll           SDL library
config.txt        Config file (see #Configuration).
assets/           Most of this directory is mandatory. For best results include the entire thing; otherwise, MZX will fail to start.
docs/COPYING.DOC  Mandatory to fulfill GPL requirements

In addition to including COPYING.DOC in your release, it is recommended that you provide a link to http://digitalmzx.net/ on any other website your game is released to, as releases of GPL software such as MegaZeux must have accessible source code.

Not that it is not necessary that many of these files be the same as those that ship with MZX; the files must only exist in name.

Configuration

Your game can be further integrated into MegaZeux by the following config.txt options:

startup_file      Specifies a local path from the startup path to a .MZX file.  This file is loaded automatically upon starting MegaZeux.
startup_path      Specifies an absolute path for MZX to startup in.  May be necessary for Mac OS X due to unreliable default startup paths.
standalone_mode   See below.
no_titlescreen    See below.

Standalone mode disables the load world menu (L/F3), causes the counters ESCAPE_MENU, HELP_MENU, F2_MENU, LOAD_MENU, ENTER_MENU, EXIT_GAME to work on the title screen, and adds the new function counter PLAY_GAME which, when set, causes MZXRun to enter the gameplay state. When the no_titlescreen option is enabled AND standalone_mode is enabled, MZXRun will immediately enter the gameplay state on startup (completely bypassing the titlescreen). Using EXIT_GAME or the escape menu will cause MZXRun to exit entirely instead of changing to the titlescreen state.

See the config.txt that ships with MegaZeux 2.90+ for more information on these features.