Loyal Companion

🎉 Loyal Companions 2.0.0 – The biggest update so far

Loyal Companions 2.0.0 brings a team with an archive, completely new menus, a customizable HUD, a command wheel, species abilities, new gear tiers and visible armor. 🐺🐱🐴

🌍 For the first time, every feature is available on Fabric, Forge and NeoForge for all supported Minecraft versions.

📖 Full documentation: Loyal Companions Wiki

🏠 Team and Archive

• Up to six team slots (3 by default) and a new archive with 12 places for companions you do not need right now.
• 📡 Store, Recall and Archive work from any distance and dimension, even when the companion waits in an unloaded chunk. You no longer have to let a companion die to free a slot.
• 👥 Several companions can be out at once (max_active_companions, 1 by default).
• New companions go to a free slot or into the archive automatically.
• Release companions from the archive with a Release Token.

🖥️ New Menus

• New overview with team cards and the archive. It opens with J and needs no whistle. It also works without any companion, so you can change the HUD and the theme at any time.
• The companion menu has tabs: Overview, Inventory, Ability, Statistics, Settings.
• 🎒 The inventory is a real inventory now: drag and drop, shift-click, number keys.
• ✨ Reworked look in a silver and obsidian style, with six themes. It fits every window size and GUI scale.
• 💬 The mod's messages are shown inside the menus, where the chat is hidden.

🎨 New: Customizable HUD

• Its own HUD editor, where you can drag the HUD anywhere with your mouse. Eight screen anchors.
• 3 styles: Full, Compact and Icons. Ornate, simple or no frame.
• 📏 Size 50–200 %, background opacity, vertical or side by side.
• ✅ Each part of the HUD can be turned on or off.
• 🌈 Its own theme and custom colors for the accent, health, XP and names.
• 💾 Everything is also in config/loyalcompanions-client.json. It is a personal client setting that works on every server.

✨ New Features

• 🎯 Command wheel (hold G): orders for all companions, attack the mob you look at, come here, store all.
• 🐾 Species abilities from level 10, e.g. night vision from cats, slow falling from chickens, water breathing from turtles.
• 🧲 Item collecting into the companion inventory.
• 🍖 Companions eat from their food slot on their own when they are hurt.
• ✏️ Rename companions in the menu and reset their skill points.
• 📊 Statistics for each companion.
• Each companion has its own follow distance, teleport distance and teleport rules. Companions only teleport to safe spots.
• 🏆 16 advancements in their own tab.
• 📦 Pack a companion into a Companion Totem at the shrine to keep it in a chest or give it away.
• Recipes for the Companion Amulet and the Companion Gem.
• Own creative tab with every item.
• Every config setting is explained in the config files.
• New commands: points, bind, list, recall, showcase.

🛡️ New Gear Tiers and Visible Armor

• Three new gear tiers with special effects: Shulker Plating, Echo Plating and Dragon Scale Plating. The Ender Dragon drops Dragon Scales. 🐉
• 👀 Visible armor on 30 vanilla animals, with its own pieces for every tier and many animals.

⛩️ New Companion Shrine

• Two blocks tall, with a new model in the style of the menus.
• The totem and the heart float above it, and revived companions appear in front of it.

🐛 Fixes

• Items in the companion inventory kept only their type and count. Now every enchantment, name, durability value and content is kept.
• Items placed in a Companion Shrine were lost on a restart or when the shrine was broken. The shrine now saves and drops its contents.
• A broken Companion Shrine dropped nothing. Now it drops itself.
• Stored companions now keep their exact appearance, saddle and armor, and data from other mods.
• Companions could be duplicated when an old copy of a chunk loaded again. Stale copies are removed now.
• Released companions dropped nothing. Now they drop everything they carried.
• Follow and Protect behaved the same. Protect now also attacks monsters hunting near you, and waiting companions only defend themselves.
• Companions could be teleported into walls, lava or the air.
• Admin commands could be used by every player in single player without cheats.

⚡ Performance

• Companions are found through their team slot instead of a search of the whole world every second.
• Path finding and target searches run a few times per second instead of every tick.
• Injury timers no longer send an update to every player every tick.

♻️ Upgrading from 1.x

• ✅ Worlds from 1.x are converted automatically the first time a companion or a player is loaded. This includes worlds from the 1.x Forge version.
• Companions in the world keep their level, skills, rarity, behavior, injuries and items.
• Stored companions move into your team slots, or into the archive when the team is full.
• Old Companion Totems are converted when you use them at the shrine.
• 🎨 The HUD position and theme are now personal client settings, so set them once again under HUD & Theme.
• 📖 Details: Updating from 1.x in the Wiki

📦 Supported Versions

Fabric, Forge and NeoForge for Minecraft 1.20.1, 1.21.1, 1.21.11, 26.1.2, 26.2 and 26.3.

⚠️ Loyal Companions must be installed on the server and on every client. On Fabric, Fabric API is needed as well. Pick the file that matches your loader and Minecraft version, e.g. loyal-companions-neoforge-26.3-2.0.0.jar.