Description
Questions or ideas? Ask here: https://tally.so/r/GepONO

Bestiary Almanac keeps a living record of every creature you encounter. Each mob starts as a mysterious dark card with a question mark; get a clear look to reveal its card, defeat it to learn its combat stats, and keep hunting to master it completely!
⚠️ Early Development (v0.0.2): This mod is under active development. Settings, configs, and saved data structures may still evolve between
0.0.xversions. Always back up your worlds before updating!



- Automatic Mod Compatibility: Organizes creatures into chapters (Overworld, Nether, The End, plus dedicated chapters for every installed mod that adds living entities). Requires zero setup or custom code from other mod authors!
- Collector Cards: Grid-based pages featuring real animated 3D models of each creature, current rank status, and kill counts. Unmet creatures appear as shrouded silhouettes.
- Interactive 3D Drawer: Click any unlocked card to open a detailed drawer. Inspect a slowly rotating 3D model, drag to rotate it freely, and view habitat details, combat stats, and drops.
- Robust Search & Filtering: Instantly search by name across all chapters, or toggle filters to display only creatures you have seen or defeated.
- Intuitive Navigation: Seamlessly browse cards using keyboard arrow keys and turn pages with your mouse scroll wheel.

| Rank | Requirements | What You Learn & Unlock |
|---|---|---|
| I. Seen | Get a clear look at it (within 24 blocks) | Where it lives (habitat biomes & structures) |
| II. Defeated | 1 Kill | Health, attack speed, armor, and drops you have actually witnessed |
| III. Veteran | 25 Kills | Combat traits and weaknesses (e.g., Smite vulnerability, fire immunity) |
| IV. Master | 100 Kills | Complete lore background and a permanent +10% damage bonus against that mob type! |
Note: Boss creatures require 5x fewer kills to rank up. Every numerical threshold is fully configurable in the server settings.

You can access your Bestiary in four convenient ways:
- Codex Hub: Open with
H(from the Arcane Framework) to see the book alongside your other Almanac volumes. - Dedicated Hotkey: Bind a custom key in your Controls menu (Open the Bestiary).
- Inventory Screen Icon: Pin the book inside the Codex Hub, then drag its shortcut icon anywhere on your inventory screen.
- Physical Bestiary Item: Right-click the item in your hand. Craft it shapelessly from a Book and a Spyglass, or grab it from the creative Tools tab.

- Real Habitats: Spawning data is read directly from active world generation lists, automatically including biomes and structures from datapacks and mods.
- Dynamic Attributes: Stats are pulled straight from the game engine. No compatibility patches are needed for modded creatures to be fully tracked.
- Custom Lore & Tags: Mods or resource packs can inject lore using a single lang key (
bestiary_almanac.lore.<mod>.<creature>). Use tags likebestiary_almanac:hiddento exclude a mob orbestiary_almanac:bossto apply boss thresholds. - Server-Authoritative Progress: Progression is saved per player on the server side. Modified clients cannot cheat or unlock cards illegitimately, and player deaths do not reset your progress.
- Spell Atlas Integration: If you are upgrading from Spell Atlas 2.0+, your previous magic mob kill counts are automatically imported into the Bestiary the first time you join a world (can be toggled off via
importSpellAtlas).

/bestiary grant <players> <creature> <rank 0-4>— Instantly sets a creature's rank for specified players./bestiary import <players>— Re-runs the one-time Spell Atlas kill import./bestiary reset <players>— Clears all Bestiary progress.

📌 Requirements
- Minecraft 1.21.1 (Client & Server)
- NeoForge 21.1.250+ (Java 21 required)
- Arcane Framework 0.0.1+ (Required library)
- Optional: Spell's Atlas (v2.0+ for one-time kill data import)
📚 Same Author Mods & Ecosystem
- Spell's Atlas — Unified settings hub, progression tracking, and spell encyclopedia.
- Arcane Framework — Core library providing the Codex Hub and rendering engine.
- Artificer's Almanac — Modular magical engineering and craft.
- Tempest Almanac — Weather manipulation, storm magic, and atmospheric rituals.
- Bookbinder's Almanac — Custom tomes and scriptorium craft.

- Gameplay Impact: The Rank IV damage bonus is the only active combat modifier (set
masterBonusPercentto0in configs to disable it). The mod adds just one item and recipe, with zero world-gen changes. - Feedback & Suggestions: Your input helps shape the mod! Leave a comment below or open an issue on GitHub.
- AI Disclosure: Created with the assistance of AI tools.
- Modpacks: Free to include in any modpack hosted on CurseForge or Modrinth!









