HemoLoader is a mod loader and a framework for Godot 4 that also helps you build games in a modular way, so extensible that even HemoLoader itself can be modified using mods.

You can split features into small modules, enable or disable them easily, and let players add mods without breaking the game.

Simple to use, easy to extend.

---

Why HemoLoader?

Godot projects often grow into large, tightly connected systems that are hard to change later.

HemoLoader keeps things modular.

Features live in isolated modules, so you can add, remove, or update them without touching the rest of the project.

---

Features

Modular Development

Build features as modules stored in:

res://mods/

Turn systems on or off without changing core scripts.

---

HemoAPI

A helper API with utilities for:

• finding nodes
• saving data
• modifying UI
• interacting with modules

This keeps mods and systems consistent.

---

Hot Reloading

Edit scripts or assets while the game is running.

Changes apply instantly — no restart needed.

---

Hemotool (Editor Panel)

Built-in tools inside the Godot editor to help with:

• creating manifests
• managing dependencies
• generating hooks

---

Modding Support

If you want players to mod your game, HemoLoader already includes everything.

Hooks

Mods can intercept functions without replacing scripts.
Multiple mods can safely modify the same behavior.

Dependency Handling

Modules load in the correct order automatically.

Mod Browser

Games can connect to the HemoLoader ecosystem so players can browse and install mods directly in-game using the built-in mod menu.

---

Core Systems

• PCK and ZIP mounting – load external resource packs
• Logging system – unified logs for game and mods
• Module loading – automatic module discovery and initialization, along with hot-reloading.

---

Getting Started

After enabling the plugin:

func _ready():
    HemoLoader.set_repository_url("https://hemoloader.com/api/mods-json?game=your_game_name")

(to have your own mods-json url, go onto hemoloader.com and add your game!)

Optional:

HemoLoader.setup_essential_mods(["Core-Systems-Author"]) #used for mods you want to include in the game by default.

See the documentation for full guides for both mod makers and game developers. Documentation has extensive explaination on all of the 300+ functions you can use thorough your game or mods, this README doesn't do it justice.

---

Platform Support

Works with all Godot 4.x export templates:

• Windows
• macOS
• Linux
• Android
• iOS

---

Author: Olivia Maxwell
License: Boost Software License 1.0