HelpLib is a lightweight RPG API framework for Minecraft Forge 1.20.1.

Designed as a shared library so multiple mods can build on top of it without duplicating common RPG logic. No gameplay on its own — install it alongside mods that require it.

Features

Player Data — persistent per-player data (energy, custom states) via Forge Capabilities, synced to client automatically.
Ability System — register abilities with cooldowns, energy costs, and use conditions. Fire and forget.
Event System — AbilityUseEvent and PlayerDataChangedEvent for hooking into gameplay logic.
Network Sync — built-in packet handler keeps server and client in sync out of the box.
Config — TOML config via helplib-common.toml for tuning energy regen and other values.

For mod developers

Add HelpLib as a dependency in your build.gradle:

dependencies {
    implementation fg.deobf(files('libs/helplib-1.0.0.jar'))
}

Then access everything through HelpLibAPI — no need to touch internals.

Requirements

Minecraft 1.20.1
Forge 47.2.0 or higher
Java 17

MIT License.

help lib