FootLib

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.
DON'T WORRY THIS MOD IS STILL GETTING UPDATES AND NEW FEATURES, I ALSO JUST HAPPEN TO HAVE MORE PROJECTS IN MIND SO GETTING THEM COMPLETED IS KEY

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="[min_version, max_version)"
#Put an actual version in min_version and max_version