This project is a demonstration of how to utilise the mod.io SDK in Godot via godot-cpp bindings.
This proof-of-concept demonstration has been compiled for Windows on Intel processors. It should work on all other platforms supported by Godot and the mod.io SDK, but has not been tested there.
It is possible to download the source code as a zip file from this webpage. However, a recursive clone downloads all dependencies. Therefore, the suggestion is to perform the following:
git clone --recurse-submodule https://github.com/modio/modio-integration-godot
cd modio-integration-godotThis repository contains:
-
Binding code that uses godot-cpp to implement a thin adaptor around the mod.io SDK’s C++ interface
-
CMake scripts to build godot-cpp, the mod.io C++ SDK as a static library, and the binding code, linking them together in a dynamic library
-
A precompiled version of the dynamic library for Windows on Intel processors
This demonstration includes a sample project for Godot 4.5 or newer, and will work out of the box.
Open the project from the modio-godot subdirectory in the Godot editor:
Configure the project for your test game using the following settings:
Once configured, mod.io functionality can be tested with the scenes provided:
If you wish to try the integration on other platforms, ensure MODIO_PLATFORM is set correctly in the root CMakeLists.txt. Once that is done, adjust other CMake variables and build the dynamic library for your target platform. You can then alter the sample project’s settings as appropriate.
Godot is not currently an officially supported platform for the mod.io C SDK. All Godot code is provided on an as-is basis, and is intended as a demonstration of using godot-cpp with our SDK's C interface.
If you need assistance with 1st party approvals, or require a private, white-label UGC solution. Contact us to discuss.
Our repository is public and open source. Game developers are welcome to utilize it directly, to add support for mods in their games, or fork it for their customized use. If you want to contribute to the repository, submit a pull request with your recommended changes for review.
mod.io provides an open API for user-generated content. You are welcome to view, fork and contribute to other codebases we release.


