Bell of Companions

!LOGO

Because your dog deserves better than dying in a ravine! 🐾

Bell of Companions lets you register your pets and call them back instantly, then build a real bond with them over time. The closer you are, the stronger they become.

Why this mod exists

This mod started as a solution to a very real problem in my own world: lost pets.

Suggestions / Contact

Have an idea or found a bug? Open an issue on GitHub or reach out on Discord.

!FEATURES

!PET TAGGER

Use the Pet Tagger to register any tamed pet. If the pet has no name, hold a Name Tag while tagging to open the naming prompt and register it in one step. Tagging still works without a Name Tag.

!PET BELL

Use the Pet Bell to call them all back instantly - as a handheld item or a placeable block (wall, floor, or ceiling, redstone-compatible).

!BONDING

Pets grow stronger the more you adventure together. Each pet has a role that determines how they earn experience and what they gain from it.

Role	Earns XP by	Bonus per level
Fighter	Killing hostile mobs	+attack damage, +HP
Guardian	Taking damage	+armor, +HP
Scout	Exploring and moving	+speed, +follow range
Support	Staying close to you	+HP, +armor
Forager	Just existing	+luck, +follow range

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

Every vanilla mob has a role assigned by default, even hostile mobs if you enable non-tameable tagging in config.

Pets progress through five bond levels: Stray → Companion → Trusted → Bonded → Soulbound

When a pet levels up, particles burst from them and you get a chat message.

!SOULBOUND

At max bond, your pet gains three permanent passives:

• Passive HP regen - slowly heals over time
• Low-health alert - plays their ambient sound when your HP drops critically low
• Death save - one time only: your pet survives a fatal hit and revives at low HP. Once used, it is gone forever.

!PETTING

Shift + right-click any tagged pet with an empty hand to pet them. The squish animation, sound, and arm swing play on any mob. Tagged pets also earn bonus bond XP and have their neglect timer reset (30s cooldown). Optional heart particles in config.

!petting a cat

Pet List (B)

A full registry of every pet you have registered, including unloaded and dead ones.

• Search by name or type, pin favourites, filter by dimension
• See health, bond level, XP progress, co-owner status, and distance at a glance
• Batch-recall selected pets or recall any individual pet from any distance
• Full death history with coordinates and time of death
• Right-click a dead entry to copy death coordinates
• Ctrl + right-click to teleport there (cross-dimension if enabled in config)
• Revive a dead pet at their death location with appearance fully restored

Reviving costs either 1 Diamond + 2 Emeralds + 8 Gold Ingots + 8 Amethyst Shards or 1 Totem of Undying — choose which is checked first in Mod Menu (default: item bundle). Missing your preferred option? The other is accepted. Disable costs entirely or bypass in Creative. Can be disabled in config.

Co-ownership

NEW IN 1.5.0

• A non-owner can use the Pet Tagger on someone else's registered pet to send a co-ownership request.
• The primary owner receives a chat notification and can accept by right-clicking the pet with the Pet Tagger while a request is pending (sneak + tagger to decline).
• Accepted co-owners are saved in the world registry and see a Co-owner label in the Pet List.
• The primary owner sees how many co-owners a pet has and can Revoke them from the Pet List, or sneak + tagger on the live pet to revoke all at once.
• Co-owners can recall and untag the pet; revive, remove, pin, and revoke remain primary-owner only.

Advancements

Name	How to unlock
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 or beyond
Thicker Than Water	Reach Soulbound
Undying Loyalty (hidden)	Watch your Soulbound pet use their death save
Second Chances	Revive a dead pet

For Developers

A public API is available via BellOfCompanionsApi for registering custom taggable entities, providing ownership checks, assigning bond archetypes, querying co-ownership (isPrimaryOwner, isCoOwner, canManagePet), and attaching per-level bond buff callbacks. Full documentation and usage examples on the GitHub repository.

Supported Versions

Minecraft	Loader	Mod versions	Status
26.1.2	Fabric	1.5.0	✅ Active
26.1.1	Fabric	1.5.0	✅ Active
26.1	Fabric	1.4.0 – 1.5.0	✅ Active
1.21.11	Fabric	1.2.0 – 1.5.0	✅ Active
1.21.1	Fabric	1.0.0 – 1.5.0	✅ Active
1.21	Fabric	1.5.0	✅ Active

Requires Fabric Loader >= 0.18.4.

Dependencies

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

⚠️ Co-ownership (please playtest)

Co-ownership is new in 1.5.0 and was not multiplayer-tested before release. If you use it on a server or LAN world, please report any issues — request, accept, decline, revoke, Pet List badges, or persistence after reload.

❌ 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 include in any modpack. Please credit and link back to this page.

Built with love by gingermat