GDScript Mod Loader

A generalized Mod Loader for GDScript-based Godot games.
The Mod Loader allows users to create mods for games and distribute them as zips.
Importantly, it provides methods to change existing scripts, scenes, and resources without modifying and distributing vanilla game files.

Features

Loading ZIPs as mods into the running game
- Makes every script and resource moddable
- Vanilla game files are not shared in mods
- Disabled mods leave no trace
- since Godot 4: workaround to mod scripts using class_name
- Mod metadata
  - Compatibility checks between game and mod version
  - Load order/dependencies between mods
  - General info like author and version
Mod Configs
- Settings for each individual mod
Mod Profiles
- Lists of mods and configurations that can easily be enabled and disabled
Unified logging system for mods
Mod Loader Options
- allowing different Mod Loader settings per-feature
Built in Mod Sources:
- Steam Workshop
- Thunderstore
- Local /mods folder
Self Setup for mods that don't have the Mod Loader preinstalled

Getting Started

You can find quickstart guides and more on the Wiki.

Godot Version

The current version of the Mod Loader is developed for Godot 3.
The Godot 4 version is nearing release on the 4.x branch.
For more details and updates on the Godot 4 version, please follow this issue or join us on our Discord.

Development

The latest work-in-progress build can be found on the development branch.

Compatibility

The Mod Loader supports the following platforms:

Windows
macOS
Linux
Android
iOS