Description
🐾 Familiar's Almanac
Every creature in your world—vanilla or modded—can become your spirit companion! Win the trust of a cow, subdue the fury of a zombie, or gather the essence of a squid, and a translucent spirit of that species will float beside you, granting subtle stat bonuses and asking only for a treat now and then.
Familiar's Almanac is a standalone companion mod integrated directly into the Arcane Framework Codex Hub (H), sitting right alongside the rest of the Almanac series.
Supports Minecraft 1.21.1 (NeoForge).
🤝 Two Ways to Form a Bond
- The Pact (Peaceful or Combat):
- Passive & Neutral Mobs: Sneak + right-click a creature with its favorite food to build trust. Once trusted, use a Pact Sigil to form a bond.
- Hostile Mobs: Monsters do not trust easily—weaken them below 25% health first, then apply a Pact Sigil. The creature itself is never harmed or altered by the ritual.
- Soul Essences: Defeated creatures occasionally drop species-specific Essences. Gather eight matching essences and bind them at a Familiar's Hearth (essences of different species never mix).
👻 Your Spirit Companion
- Universal 3D Rendering: Your familiar renders using the creature's actual 3D model—scaled down with a soft translucent tint—working automatically for any vanilla or modded living entity. If a custom mod model cannot be rendered safely, a rotating amethyst shard appears in its place so the game never crashes.
- Intangible & Safe: Spirits hover peacefully at your side; they cannot be hurt, blocked by arrows, or interacted with by other players.
📈 Bond Levels, Balanced Stats & Perks
- 5 Bond Levels: Spending time together, defeating foes, and offering treats levels your bond from Level 1 to Level 5.
- Flavor Over Meta: Every species grants the exact same total stat budget, distributed automatically according to what the creature naturally excels at—swift mobs grant Movement Speed, sturdy ones grant Max Health, and lucky ones grant Luck. Pick your favorite companion without worrying about min-maxing!
- Level 3 Perks & Wardsight:
- Species Perks: Fire-immune creatures grant Fire Resistance, flyers grant Slow Falling, and aquatic mobs grant Water Breathing.
- Wardsight: Every Level 3+ familiar highlights nearby hostile mobs within 12 blocks with a subtle glow.
- Dual Companions (Level 5): Reaching Level 5 unlocks a second active familiar slot, allowing two spirits to follow you simultaneously.
- Transparent Attributes: All bonuses use standard attribute modifiers visible on every stats screen, subject to a configurable total cap.
🍖 Care & Mood
- Simple Upkeep: A familiar's mood slowly decreases while summoned. Restore it by right-clicking your spirit with its favorite food or resting near a Familiar's Hearth.
- Forgiving Mechanics: A worn-out familiar stays by your side and simply pauses its stat bonuses until rested. Bonds are permanent unless you intentionally enable Hard Mode in the server config.
📖 The Almanac (Codex Hub Integration)
- Multiple Ways to Open: Access your book via the Arcane Framework Codex Hub (
H), a dedicated hotkey, the physical book item, or a pinned shortcut icon on your inventory screen. - Interactive Collector Cards: Browse discovered species cards showing live 3D models, bond levels, and mood. Click any card to inspect its stat distribution, Level 3 perk, favorite foods, and built-in guide—and summon, dismiss, or swap active familiars directly from the page.
🔒 Server-Authoritative Multiplayer
All bonds, levels, mood values, and attribute modifiers are managed and validated strictly on the server. Clients only render synced state, and only a familiar's owner can feed, summon, or dismiss it.
🔌 Requirements & Mod Compatibility
📌 Required Mods (Install on both Client & Server)
- Minecraft:
1.21.1(NeoForge 21.1+) - Arcane Framework 0.0.1+ (Required library providing the Codex Hub and book reader)
📚 Same Author Mods & Ecosystem
- Arcane Framework — Core library powering the Codex Hub (
H) and Almanac book engine. - Bestiary Almanac — Collector's album for tracking every vanilla and modded creature you encounter.
- Spell's Atlas — Living spell encyclopedia, mastery ranks, and unified settings hub.
- Artificer's Almanac — Modular staffs, staff salvaging, mana infusion, and arcane seals.
- Tempest Almanac — Weather manipulation, storm magic, and atmospheric rituals.
- Bookbinder's Almanac — Custom tomes, enchanting expansion, and scriptorium craft.
- Quintessence: Elemental Spellcraft & Runes — Elemental spellcraft, runes, and dimensional travel.
- Player System — Rank progression, attributes, and skill trees.
🔧 For Server Owners & Modpack Creators
- Zero-Setup Modded Support: Any modded mob without a custom file automatically derives its favorite foods, stat weights, and perks from its public entity attributes.
- Datapack Customization: Override or define species behavior via
data/<namespace>/familiars_almanac/species/<entity>.json(favorite_foods,weights,perks), and control exclusions using entity type tagsfamiliars_almanac:blacklistandfamiliars_almanac:no_essence. - Granular Configs & Commands: Tune essences per bond, trust/weaken thresholds, bonus caps, essence drop rates/cooldowns, XP curves, Wardsight range, and Hard Mode. Includes full operator commands (
/familiar bond,unbond,mood,essence,summon,dismiss,reset).
📝 Feedback, Notes & Permissions
- Feedback & Suggestions: Your input helps shape the mod! Have ideas for new species perks or balance tweaks? 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!



