FootLib

FootLib is a lightweight API and utility library used by Foot‑series mods. It provides shared systems such as:

Foot Economy API

Currency definitions

Exchange‑rate systems

Auto‑rate engine hooks

Service injection for mod interoperability

FootLib is intentionally minimal, stable, and designed to act as the backbone for the entire Foot ecosystem.

Versioning

FootLib uses a four‑segment versioning system:

Overhaul.Major.Semi‑major.Patch/Hotfix/Minor‑alpha/beta/release

Example: 0.0.1.0 → Semi‑major update (1 in the third position)

Meaning of each segment

• Overhaul
  A complete rewrite of the codebase, API, and systems. This is a new era of FootLib. Backward compatibility is not preserved.

• Major Large feature wave. New systems, new mechanics, or major expansions. Backward compatible unless stated otherwise.

• Semi‑major Significant content or system additions. Big‑minor updates that don’t break API.

• Patch / Hotfix / Minor Small updates, bugfixes, micro‑features, or emergency fixes.

Pre‑release tags

‑alpha → Experimental, unstable

‑beta → Feature‑complete, stabilizing

(blank) → Release build/stable

Important Note

An Overhaul (1.x.x.x, 2.x.x.x, etc.) ends support for all previous Foot mods unless explicitly stated otherwise.

This is why FootLib does not use SemVer — SemVer cannot express the difference between a major update and a full architectural overhaul. FootLib’s versioning makes the reason for incompatibility explicit. Usage Maven Repo

repositories { maven { url = "https://api.modrinth.com/maven" } }

Gradle (Groovy)

dependencies { implementation("maven.modrinth:footlib:${footlib_version}") }

neoforge.mods.toml

[[dependencies.yourmod]] modId="footlib" mandatory=true versionRange="[1.0.0,)"