✨ About Loyal Companions

Loyal Companions adds a full companion progression system to Minecraft. Friendly mobs can become personal pets with their own levels, XP, skill points, inventory, gear, rarity, accessories, behavior modes, HUD, and revival mechanics.

Your companions can follow you, fight beside you, carry items, wear special gear, equip magical gems and amulets, be stored as transferable totems, and return through a magical shrine if they fall in battle.

⭐ Main Features

• 🐾 Capture friendly mobs and turn them into loyal companions
• 📈 Custom leveling system with XP, levels, and skill points
• 💪 Upgrade companion stats:
  • Strength — increases damage
  • Defense — improves protection
  • Attack Speed — reduces attack cooldown
  • Vitality — increases maximum health
• 🌟 Rarity system with stat bonuses and colored visual effects
• ✨ Enhanced companions with smaller size and bonus inventory potential
• 🖥️ Custom companion menu with calculated values and 3D preview
• 📊 Moveable companion HUD with health, XP, level, name, and model preview
• 🎒 Pet inventory with normal slots, food slot, gear slot, gem slot, amulet slot, and bonus slots
• 🛡️ Companion gear with harnesses and armor plating
• 💎 Companion gems and amulets with unique stat bonuses and loot sources
• 🩹 Pet healing items with small, medium, and large bandages
• ⚔️ Behavior modes including safe monster targeting and full mob targeting
• 🍖 Feeding system based on each companion’s mob type
• 📣 Companion Whistle with pet selection menu
• 🧿 Companion Totems for storing, transferring, and reviving pets
• 🛕 Companion Shrine with revival animation and pet storage
• 💔 Companion Hearts dropped by Iron Golems for revival
• 👥 Optional PartyLink compatibility
• ⚙️ Server and singleplayer configs for important gameplay settings

🐕 Capture & Train Companions

Use a Capture Charm on a friendly mob to bind it as your companion. Your pet will follow you, gain XP, level up, and become stronger over time.

Each level grants 1 skill point, which can be spent in the companion menu. Build your pet as a stronger fighter, tougher guardian, faster attacker, or more durable travel partner.

🌟 Rarity & Enhanced Companions

Companions can now have a rarity, giving them additional base stat bonuses and colored visual effects. Enhanced status is separate from rarity, so a companion can be both Enhanced and Legendary.

• Normal — no bonus stat points
• Rare — +1 to every attribute
• Epic — +3 to every attribute
• Legendary — +5 to every attribute

Enhanced companions are smaller, visually special, and can unlock additional inventory space at higher levels.

🎒 Pet Inventory

Companions have their own inventory screen with custom slots and tooltips.

• 9 normal inventory slots
• 1 food slot
• 1 gear slot
• 1 gem slot
• 1 amulet slot
• 9 bonus slots for Enhanced companions at level 20

The inventory includes the player inventory and hotbar for easy item movement. Item names and descriptions are shown directly in custom screens.

🛡️ Companion Gear

Equip your companion with special gear to improve its power and survivability.

• Companion Leather Harness
• Companion Iron Plating
• Companion Gold Plating
• Companion Diamond Plating
• Companion Netherite Plating

Gear can provide bonuses such as armor, health, and attack speed. Equipped gear also adds a small visual effect to your companion.

💎 Gems & Amulets

Loyal Companions adds magical gems and amulets for your pet. These accessories provide additional stat bonuses and can be found through crafting, village loot, dungeon loot, Nether enemies, bosses, and the Ender Dragon.

💠 Gems

• Frostbound Gem — craftable starter gem
• Verdant Gem — found in village loot
• Crimson Labyrinth Gem — found in dungeon loot
• Soulflame Gem — rare Wither Skeleton drop
• Dragon Prism Gem — powerful Ender Dragon drop

🧿 Amulets

• Guardian Heart Amulet — craftable starter amulet
• Villagekeeper Amulet — found in village loot
• Wayfinder Amulet — found in dungeon loot
• Wraithbone Amulet — Wither drop
• Dragon Eye Amulet — powerful Ender Dragon drop

The strongest accessories are designed as rare boss rewards, giving the Ender Dragon a valuable companion-focused loot progression.

🩹 Pet Healing Items

Companions can now be healed with dedicated bandages.

• Small Companion Bandage — restores a small amount of health
• Medium Companion Bandage — restores a moderate amount of health
• Large Companion Bandage — restores a large amount of health

These items make long adventures, dungeon runs, and boss fights much safer for your companion.

⚔️ Behavior Modes

• Follow — follows the player normally
• Wait — stays in place
• Passive — does not attack
• Protect — protects the player from nearby threats
• Bad Monsters — attacks only clearly hostile monster enemies
• All Mobs — attacks most mobs, while still protecting players, villagers, traders, and companions

This allows you to choose between a safe monster-only mode and a stronger aggressive mode for hunting.

📣 Companion Whistle & Pet Slots

The Companion Whistle opens a pet selection menu. Depending on the config, players can manage multiple companion slots.

For stability and balance, only one companion can be active at a time. Despawn your current pet before summoning another stored companion.

🛕 Companion Shrine & Revival

When a companion falls, it can be stored inside a Companion Totem. The totem contains important pet data such as name, mob type, level, stats, inventory, rarity, and Enhanced status.

To revive a fallen companion, place a Companion Totem and a Companion Heart into the Companion Shrine. The shrine plays a short revival animation and restores the pet afterward.

You can also use the shrine to store your active companion as a totem without killing it. This makes it possible to trade or transfer pets between players.

👥 Optional PartyLink Support

Loyal Companions includes optional compatibility with PartyLink. If PartyLinkis installed, party companions are protected from friendly fire.

• Party members’ pets will not attack each other
• Party PvP settings are respected
• The mod still works normally without PartyLink

⚙️ Configuration

Loyal Companions supports separate configuration handling for dedicated servers and local singleplayer worlds.

• Enable or disable companion revival
• Companion Heart drop chance
• Enhanced companion chance
• Rarity chances
• Maximum companion level
• Maximum managed companion slots per player
• Protect mode radius
• Aggressive mode radius
• Maximum bonus skill points from companion candy
• Companion candy and loot behavior

🧭 Perfect For

• Survival worlds
• Adventure modpacks
• RPG-style progression
• Multiplayer servers
• Players who want pets with real gameplay value