Awesome
Steamworks.gml
Quick links: documentation · sample project · donate
A native extension for GameMaker (GMS1, GMS2, GMS2.3+) that implements various Steam API features not covered by the built-in functions - most importantly, P2P networking, lobbies, and matchmaking.
Usage
- Set up GameMaker for Steamworks SDK development (GMS1, GMS2).
- Enable Steamworks support for desired platform(s) in Global Game Settings, "Steam" tab. Don't forget to set the game ID.
- Import the "Steamworks.gml" extension (from ./Steamworks.gmx/extensions) to your desired project.
- Have the game call
steam_gml_update
once per step (required for steam events to dispatch).
If all is well, upon running the game you'll see Steamworks.gml initialized successfully.
in the CompileForm.
Steamworks.gml failed to link with Steam API.
means that either the Steam client is not running, or you have specified an incorrect App ID.
Steamworks.gml binary is not loaded.
means that the DLL/DyLib/SO could not be loaded, usually due to the native extension file missing or being otherwise inaccessible.
Note: If you are grabbing the sample project straight from this repository, you will need to compile it first using Visual Studio (Windows) or via included .sh scripts (Mac, Linux). Sample project page has pre-compiled binaries.
Building
Download or clone the repository.
Create a steamworks_sdk_135a
directory and place Steamworks SDK 1.35a there (for GMS1).
Create a steamworks_sdk_142
directory and place Steamworks SDK 1.42 there (for GMS2).
For both directories, Readme.txt
should be directly inside the directory (steamworks_sdk_135a/Readme.txt
) - no subdirectories!
- Windows:
- GMS1: Open the included Visual Studio solution, switch the solution platform (in toolbar) to
x86
, switch configuration (also in toolbar) toGMS1 Release
, and pick menu:Build➜Build Solution. - GMS2: Same as above, but with
GMS2 Release
configuration. - GMS2.3 with x64 runtime: Same as above, but with
GMS2 Release
configuration andx64
platform.
GmxGen.exe
next tovcxproj
file), GmxGen will be ran automatically in post-build step. - GMS1: Open the included Visual Studio solution, switch the solution platform (in toolbar) to
- Linux:
- GMS1: Run
build_linux_gms1.sh
. You'll need cpp:i386, gcc:i386, and g++:i386 installed. - GMS2: Run
build_linux_gms2.sh
.
- GMS1: Run
- Mac:
- GMS1: Apple dropped support for x86 binaries that GMS1 exports! My condolences.
- GMS2: Run
build_mac_gms2.sh
.
Meta
Author: Vadim "YellowAfterlife" Dyachenko
License: MIT https://opensource.org/licenses/mit-license.php
Special thanks
- YoYo Games, for making and continuously improving GameMaker: Studio.
- Russell and Peter of YoYo Games in particular, for answering my questions on native extensions.
- Alex Fernandez, for helping build the OSX version of the extension.
- /id/volnes, for answering my various Linux-related questions.
- Riley Labrecque, for being a source of inspiration to making this kind of project open-source (see Steamworks.NET).