Bell of Companions

Bell of Companions turns your tamed pets into real adventure partners. Register them with a tap, call them back from anywhere, and watch them grow stronger, and more independent, the longer you explore together.

Whether it's the wolf that keeps falling off cliffs or the cat you spent an hour taming, this mod means you never have to lose them for good!

---

Development Status

Unfortunately, development of Bell of Companions is currently paused.

During the development of version 1.5.0, I lost the project files due to a Windows issue. The 1.5.0 update was planned to be a much larger update than what is currently available, and this description includes some of the features that were already in progress. Recovering or rebuilding the project would require starting again from version 1.4.0, which would mean losing a significant amount of development work.

Thank you to everyone who has supported this mod. I genuinely enjoyed working on it, and I hope I can continue it someday.

---

TL;DR

• Instant Recall - handheld Pet Bell or placeable block (redstone-compatible)
• Smart Tagging - register any tamed pet with the Pet Tagger; instant naming if you're holding a Name Tag
• Deep Bonding - 5 bond levels, archetype-based XP, real stat growth
• Role-Based Growth - Fighter, Guardian, Scout, Support, Forager - each grows differently
• Petting - shift + right-click any tagged pet for bonus XP and love
• Soulbound Perks - passive regen, low-health alert, one-time death save
• Totem of Revitalization - bank revive charges on a living pet, or revive a dead one from the registry
• Co-Ownership - share pets with friends, safely
• Pet List - full searchable registry with death history, batch recall, and revival

Use the Pet Tagger on any tamed animal to register it. It works with or without a Name Tag in your inventory. If you are holding one, tagging opens a naming prompt and registers the pet in a single step (Creative mode skips the requirement entirely). By default, hostile and boss mobs are excluded, but server owners can enable tagging on non-tameable mobs in the config if they want to register absolutely anything.

Your ultimate "come here" tool. Use it as a handheld item, or place it as a block on a floor, wall, or ceiling. Fully redstone-compatible for automated recall setups.

Living Bonds

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

The longer you adventure together, the stronger your pet becomes. Every pet has one or more Archetypes that determine how it earns bond XP and what it gains from leveling up:

Archetype	Earns XP by	Bonus per level
Fighter	Killing hostile mobs	+Attack Damage, +HP
Guardian	Taking damage	+Armor, +HP
Scout	Exploring & moving	+Speed, +Follow Range
Support	Staying close to you	+HP, +Armor
Forager	Just existing	+Luck, +Follow Range

Every vanilla mob has an archetype assigned by default, including hostile mobs, if non-tameable tagging is enabled.

Full archetype list (every mob)

Tameable & Passive

• Wolf - Fighter
• Cat - Scout
• Horse - Scout
• Parrot - Scout
• Axolotl - Guardian, Support
• Fox - Forager, Scout
• Llama - Guardian
• Donkey - Forager
• Mule - Forager
• Rabbit - Forager
• Bee - Support, Forager
• Panda - Forager
• Goat - Fighter
• Frog - Forager
• Armadillo - Guardian
• Cow - Support
• Mooshroom - Support
• Sheep - Forager
• Pig - Forager
• Chicken - Forager, Scout
• Turtle - Guardian
• Ocelot - Scout
• Bat - Scout
• Polar Bear - Guardian, Fighter
• Dolphin - Scout, Support
• Strider - Scout
• Sniffer - Forager
• Camel - Scout, Support
• Allay - Support, Forager

Neutral & Utility

• Trader Llama - Guardian
• Wandering Trader - Forager
• Iron Golem - Guardian, Fighter
• Snow Golem - Guardian

Aquatic

• Cod - Forager
• Salmon - Forager
• Tropical Fish - Forager
• Pufferfish - Guardian
• Squid - Forager
• Glow Squid - Forager

Hostile

• Zombie - Fighter
• Husk - Fighter
• Drowned - Fighter, Guardian
• Zombie Villager - Fighter
• Skeleton - Scout, Fighter
• Stray - Scout, Fighter
• Wither Skeleton - Fighter, Guardian
• Creeper - Fighter
• Spider - Scout, Fighter
• Cave Spider - Scout, Fighter
• Enderman - Scout
• Endermite - Fighter
• Silverfish - Fighter
• Blaze - Fighter
• Witch - Support
• Slime - Guardian
• Magma Cube - Guardian
• Ghast - Scout
• Phantom - Scout
• Pillager - Scout, Fighter
• Vindicator - Fighter
• Evoker - Support, Fighter
• Vex - Scout, Fighter
• Ravager - Fighter, Guardian
• Piglin - Fighter
• Piglin Brute - Fighter, Guardian
• Hoglin - Fighter, Guardian
• Zoglin - Fighter, Guardian
• Shulker - Guardian
• Guardian - Guardian, Fighter
• Elder Guardian - Guardian, Fighter
• Breeze - Scout
• Bogged - Scout, Fighter
• Creaking - Guardian

Exact XP rates & stat bonuses

Activity is checked roughly every 10 seconds:

• Fighter: +4 XP per kill, +0.5 attack damage, +2 HP per level
• Guardian: +2 XP per check while injured, +0.5 armor, +2 HP per level
• Scout: +2 XP per check after traveling 8+ blocks since the last one, +0.015 speed, +1 follow range per level
• Support: +2 XP per check while within 16 blocks of you, +1 HP, +0.25 armor per level
• Forager: +2 XP per check, passively, +0.05 luck, +1 follow range per level
• Petting: +3 XP, 30-second cooldown

Bond levels cost 150 / 250 / 400 / 600 XP respectively - 1,400 XP total to reach Soulbound.

If a pet goes more than 24 hours without earning any bond XP, its XP gain is halved until it earns XP again, so even slower archetypes like Forager stay on track with regular play.

Leveling up triggers a particle burst and a chat message. Bond level and XP progress are also visible per-pet in the Pet List (e.g. Companion (42%)).

Pets currently gain passive stat bonuses based on archetype and bond level. Active combat abilities and healing auras are planned for a future update.

Soulbound

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

At max bond level, pets gain three permanent passives:

• Passive regen - slowly heals over time
• Low-health alert - when your health drops below 33% (default), your pet plays its ambient sound at a lower pitch as a warning
• Death Save - one time only, your pet survives a fatal hit and revives at 20% HP. Once used, it's gone for good, and triggers the hidden Undying Loyalty advancement.

Petting

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

Shift + right-click any tagged living mob with an empty hand to pet it. A little squish animation plays, your pet makes its ambient sound softly, and you get a small arm swing. It also resets the pet's neglect timer and grants +3 bond XP on a 30-second cooldown. Heart particles are available but off by default - toggle them in the config if you want the extra flair.

Pet List (Press B)

A full, searchable registry of every pet you've ever tagged, including unloaded or dead ones.

• Search by name or type, pin favorites, filter by dimension
• Live health, bond level, XP progress, co-owner status, and distance at a glance
• Batch-recall selected pets, or recall any single pet from any distance
• Full death history with coordinates and time of death. Right-click a dead entry to copy the coordinates, or Ctrl + right-click to teleport there (cross-dimension if enabled)
• Revive a dead pet for the cost of 1 Totem of Revitalization (configurable, free in Creative). They respawn right in front of you with their appearance fully restored

Totem of Revitalization

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

A stackable item that revives your pets from (not so) permanent death.

Use it on a living, tagged pet to charge them. If they die while charged, the death is cancelled, they revive at 20% HP right in front of you with totem particles and sound, and the charge is consumed. You can stack multiple totems on the same pet to bank several saves in a row. The same item is also what the Pet List spends to bring back a pet that has already died.

When a charge is actually spent, the totem's eyes and heat glow light up and pulse for about two seconds before fading. This only happens during a real revival, not when you're charging a pet up.

A Dormant Totem variant can be found in loot chests. Evokers have a 50/50 chance to drop either a Totem of Undying or a Totem of Revitalization, and the Dormant version can also appear in Woodland Mansion, Bastion, Ancient City, and other structure chests (see config loot tables). Upgrade it into a full Totem of Revitalization with 2 diamonds and a poppy, or reverse-craft it back into 6 sticks if you'd rather not bother.

Co-Ownership

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

Want to share a pet with a friend? Use the Pet Tagger on someone else's registered pet to send a co-ownership request. They'll get a chat notification and can accept by right-clicking the pet with their Tagger while the request is pending, or sneak + Tagger to decline.

Accepted co-owners are saved to the world registry and show a Co-owner badge in the Pet List. Co-owners can recall and interact with the pet, but untagging, removing, reviving, and managing ownership stay with the primary owner, who can revoke individual co-owners from the Pet List or revoke everyone at once with sneak + Tagger on the live pet.

⚠️ Co-ownership is new and hasn't been heavily multiplayer-tested yet. If you try it on a server or LAN world, please report anything odd - requests, accepting, declining, revoking, or badges not surviving a reload.

Commands

• /petbell resetconfig / /petbell reloadconfig (op only) - reset or reload the config file
• /petbell exportRegistry / /petbell importRegistry <file> (op only) - backup or restore the pet registry
• /petbell setbond <1-5> (op only) - instantly sets the bond level of the nearest registered pet within 5 blocks

Advancements

A custom advancement tree guides you naturally through the mod:

• Loyalty Bell - Ring the Pet Bell for the first time
• Tag, You're It! - Register your first pet
• Whistle While You Work - Recall a tagged pet
• No More Ravines - Have a pet auto-recalled by low health
• Growing Closer - Reach Companion bond level
• Thicker Than Water - Reach Soulbound
• Undying Loyalty (hidden) - Witness your Soulbound pet's death save
• Second Chances - Revive a dead pet
• Charged Companion (hidden) - Charge a pet with a Totem of Revitalization
• Bound by Totem (hidden) - Have a charged pet revitalized instead of dying

Getting Started

1. Craft a Pet Tagger and Pet Bell.
2. Tame a pet and tag it.
3. Adventure together - pet, fight, explore - and watch them grow.
4. Use the bell whenever they wander off.
5. Open the Pet List (B) anytime to manage your growing family.

All settings live in Mod Menu, split across five tabs: General, Bell, Visuals, Pets, and Tagging & Registry.

For Developers

-- ⚠️ ADDED IN 1.5.0 (not available yet - see Development Status above)

A public BellOfCompanionsApi is available for registering custom taggable entities, attaching per-level bond buffs, and assigning bond archetypes. It exposes bond-level constants and helpers (getBondLevelName(), isBondMaxLevel(), getBondLevelCount(), getBondLevel(), isTagged(), and more), plus an event system (PetTagEvent, PetRecallEvent, PetBondEvent) for hooking into tagging, recall, and bonding. Full docs and usage examples on the GitHub repository.

Dependencies

Mod	Requirement
Fabric API	📦 REQUIRED
Cloth Config API	📦 REQUIRED
Mod Menu	💡 RECOMMENDED
Cardinal Components API	⚠️ Required for ≤ 1.4.0 only

❌ Known Incompatibilities

None at the moment. If you run into a conflict with another mod, please report it so I can mark it as incompatible or make it compatible.

---

MIT License - Free to use in any modpack (please credit and link back). Built with love by gingermat 🐾

Have ideas or found a bug? Open an issue on GitHub!