Skip to content

GodotModding/godot-mod-loader

Repository files navigation

GDScript Mod Loader

Godot Modding Logo

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 Mod Loader is developed for Godot 3 and 4.
You can find a stable Godot 3 version on the releases page Godot 3.x - v6.3.0 and the Godot Asset Lib.
For Godot 4 you can find the latest releases on the Releases Page and the Godot Asset Lib.

Development

The latest work-in-progress build can be found on the 4.x-dev branch for Godot 4 and 3.x-dev for Godot 3.

Compatibility

The Mod Loader supports the following platforms:

  • Windows
  • macOS
  • Linux
  • Android
  • iOS

Keep in Touch

For more details and updates join us on our Discord.

Games Made Moddable by This Project