Botz Library

The shared core of the Botz mod suite.

Botz Lib is the foundation library for the Botz family of mods on NeoForge 1.21.1 — starting with BotzMobLeveling, with more of the suite on the way. If a Botz mod asks for it, drop this jar in alongside. That's the whole install.

There's nothing to configure and nothing player-facing — Botz Lib works entirely behind the scenes so the mods built on it can stay lean, compatible, and fast.

🧩 What it provides

• Cross-mod stat capabilities — a shared interface for entity levels and stats, so Botz mods (and yours!) can read each other's data with zero hard dependencies. One mod levels the mob, another reads the level, neither imports the other.
• Shared mob taxonomy — one suite-wide answer to "is this mob basic, a nemesis, or a boss?", fed by whichever mods know. Supports the c:bosses entity tag convention out of the box, so vanilla and well-behaved modded bosses are recognized automatically.
• The tick-budget engine — a per-tick microsecond ledger, budgeted work queues, and load-aware staggering that keep the whole suite TPS-friendly. Heavy work is measured, amortized, and deferred to leftover tick time instead of stealing it.
• Async worker pool — a shared thread pool with snapshot-based safety rules, so expensive computation happens off the main thread without touching live world state.
• Combat signal registry — lightweight hooks that let combat-focused Botz mods share state (weak spots, wound status) with the rest of the suite.

🛠 For mod & pack developers

• MIT licensed — build on it freely.
• Provider-pattern APIs: every integration point defaults to a safe no-op when the providing mod is absent. Install only what you need.
• The /botztick command shows the live per-system tick ledger — see exactly what every Botz system costs, in microseconds, in-game.

📦 Which mods need this?

• BotzMobLeveling — level-based mob stats and datapack bosses (requires 1.1.0+)
• More of the Botz suite is in development and will land here as it releases.

Part of the Botz mod suite powering the Bossborne: Eventyr Reach modpack.