OpenGMK is a modern, open-source rewrite of the proprietary GameMaker Classic engines, providing a full sourceport of the runner, a decompiler, and the ability to record TASes. It's being worked on almost every day! We’re constantly adding new features and updating the code.
Please remember that this project is a work in progress and is unreleased. Until there's an official release, please note that your saves may break in future releases. See runtime errors section below on how to work around this.
OpenGMK currently runs games made with GameMaker 8.x, and runs on Windows 7 or later. It will support Unix-like operating systems (e.g. Linux or macOS) in the future.
This project is written in the Rust programming language. Download the toolchain manager directly from the official site or a package manager of your choice.
We use the nightly
branch of the Rust toolchain. If you have a recent version of rustup
(1.24 or later), it will automatically download it for you the first time you run Cargo within
the project (by reading the rust-toolchain.toml
override file).
You can update rustup and your toolchains by running rustup update
, and install nightly
manually with
rustup install nightly
.
Next, clone the OpenGMK repository. We use a few git submodules, so initialise them while cloning like so:
git clone --recurse-submodules https://github.com/OpenGMK/OpenGMK.git
Once that's set up, cd
to the repository and build the entire project
in the release profile so it's optimized (this will take a while):
cargo build --release
The build artifacts will be located in (repo folder)/target/release/
.
If you're on Windows 64-bit and would like to play games with GM8Emulator
that require 32-bit DLLs to function (such as GMFMODSimple or supersound)
you'll also need to build the WoW64 server, preferably in the release profile.
It requires the additional installation of the i686-pc-windows-msvc
target with rustup.
rustup target add --toolchain=nightly i686-pc-windows-msvc
cd gm8emulator-wow64
cargo build --release
The build artifacts for the WoW64 server will be in
(repo folder)/gm8emulator-wow64/target/i686-pc-windows-msvc/release/
.
The binary should either be manually copied to the same folder as gm8emulator
to work,
or the OPENGMK_WOW64_BINARY
environment variable should be set
with the path to the binary.
A much easier alternative to this is building the project as 32-bit on Windows, where the WoW64 server is not required and the DLL loading logic is bundled inside GM8Emulator. It should be noted that cross-platform extension emulation is planned for the long-term future.
- Play a game normally:
gm8emulator <game_exe_location>
- Record a TAS:
gm8emulator <game_exe_location> -n <project_name>
- If this is a new project, it'll be created in
(working directory)/projects/project_name/
. - If this is an existing project, it'll resume it from that same path if it exists.
- If this is a new project, it'll be created in
- Replay a TAS:
gm8emulator <game_exe_location> -f <save#{.bin,.gmtas}>
- A
save#.bin
file is generated for each savestate in record mode. - A
save#.gmtas
can be exported from record mode, which is inputs only. - A
save#.gmtas
can be used to recreate a savestate if-o path/to/save#.bin
is passed.- You may want to pass
-l
to disable the framelimiter which makes replaying thesave#.gmtas
much quicker. - Full example:
gm8emulator <game_exe_location> -l -f path/to/save#.gmtas -o path/to/save#.bin
- You may want to pass
- A
Note that all command-line steps will be streamlined in a future release.
Loading a game gives "failed to load 'filename' - unknown format, could not identify file"
OpenGMK is made to support GameMaker Classic games. At the moment, OpenGMK only supports loading games made with GameMaker 8.x, but GameMaker 7.x and older releases will be supported in the future.
Additionally, it’s possible that the game you are trying to load was actually made with the newer GameMaker: Studio, which OpenGMK does not support at the moment. Whether it will in the future is unclear right now.
Loading a savestate gives "invalid u8 while decoding bool" or "expected variant index" (or similar)
This means that the
save#.bin
format in your current project directory has changed and is incompatible with the current GM8Emulator. This is a byproduct of the emulator being actively developed and changing a lot. This will not be an issue when it's fully released.There are two ways to fix this:
- You can export a
save#.gmtas
file from the old build, and then create asave#.bin
out of it.
- Instructions for this are available in the recording section.
- You can downgrade your local repository to the last version it worked on.
- View the latest commit in your cloned repo:
git log -1
(or look on GitHub)- Make sure you're up to date with the remote repo:
git fetch --all
- Seek to a specific commit:
git reset --hard <hash>
- Rebuild the project as per instructions above.
Loading a game or during a game "called unimplemented kernel function" or "not yet implemented" (or similar)
Your game tried to access functionality that's yet to be implemented. The full GameMaker standard library is massive and there's a good bit left to cover.
GameMaker is an engine for creating Windows games, developed by YoYo Games.
GameMaker 8 ("GM8") was the last of the numbered releases of GameMaker,
released on December 22nd 2009 (surpassing GameMaker 7)
and succeeded by the vastly more popular GameMaker: Studio in 2011.
The pre-Studio versions are often referred to as GameMaker Classic.
Due to the huge behavioral differences, as well as Studio's lack of backward-compatibility,
the classic engines are still very widely used, with thousands of games to their name.
One of GameMaker's original strengths as a game engine were
its ability to compile an entire project into a single executable.
No external dependencies or installers, just compile,
send the .exe
file to your friend and they will be able to play your game.
This is achieved by having the target executable act as a phase file
for the entire collection of assets required to run the game.
In other words, the executable contains not only the game engine code,
but all of the objects, scripts, sprites, room layouts, everything required for the game logic.
This behaviour was made optional in Studio, giving the creator a choice between
a standalone executable or .msi
installer, however the standalone builds
just extract the contents of the installer to a temporary folder when they're launched.
This project was originally started as
GM8Emulator
,
a program that can load
GameMaker Classic games and accurately play the game within.
It should mimic the behaviour of the original engine as closely as possible,
down to the sub-frame and ideally implementation detail (if observable).
Strictly speaking, emulator was not a correct term.
In computing, an emulator is a piece of software on a computer system
which emulates the behaviour of a different computer system.
We aren't emulating any computer system, just the engine.
A more accurate term would be sourceport but emulator sounded cooler at the time.
The project required us to write a decompiler to get the assets,
and since we were already maintaining a fork of the 2013
gm81decompiler
we made our own much faster version out of the new codebase,
GM8Decompiler
,
which was originally a separate repository but was eventually merged
into the unified repository known as OpenGMK
where all related (and future) projects will be hosted.
Releases of the decompiler are still available to download from the
decompiler repository.
This project has only been worked on by a few people so far in their little free time. Contributions are always welcome, although it's highly preferred to get in contact beforehand to discuss details.
- DatZach's decompiler for "documenting" the loading sequence.
- Jabberwock-RU for the new project (& organization) icon.