CompanionPets

Tame mobs, level them up, give them backpacks and take them along on your adventures. Vanilla-style taming, skill trees, hunger, a pet menu and flexible permission-based limits. No dependencies.

Requires: Paper 26.3 · Java 25 (Folia is not supported)

Features

• Vanilla-style taming - right-click a mob with the matching item: wolf (bone), cat/ocelot (fish), parrot (seeds), fox (berries), horse (apple, sugar, golden carrot), Warden (echo shard), Wither (nether star) and many more. Success chance, items and the required mob health are configurable per mob.
• Multiple pets - 5 by default, change it with a config option or permissions. Switch pets through the menu or /pet switch.
• Levels and skill trees - pets gain exp from kills and level up to 50. Four trees (Universal, Warrior, Tank, Porter) give extra health, damage, speed, regeneration and backpack rows.
• Pet backpack - up to 6 rows. The contents drop on the ground when the pet is recalled, switched, released or dies (can be turned off).
• Hunger - pets get hungry over time; a starving pet loses damage and speed. Feed them by right-clicking with food.
• Behavior modes - Friendly (never attacks), Normal (defends itself and helps you), Aggressive (attacks nearby monsters). Peaceful mobs like pigs, cows, sheep, chickens, rabbits, parrots, allays, bees and horses cannot attack and have no behavior setting.
• Horses - ride your pet horse; its saddle, armor and coat are saved between summons.
• Owner-safe pets - a pet Warden never applies Darkness to its owner, and a pet Wither never breaks blocks or hurts players.
• Summon cooldown - recalling or losing a pet starts a delay (60 s by default) before any pet can be summoned or switched.
• Custom names - /pet name supports colors and gradients.
• Pet menu - Shift + right-click your pet.
• Fully translatable - every message lives in messages.yml (MiniMessage).
• Update checker - tells the console and admins when a new version is released on Modrinth.

Commands

Aliases: /pets, /mypet.

Permissions

Configuration

config.yml

• default-max-pets (5), summon-cooldown-seconds (60), respawn-seconds (60) - defaults used when a player has no matching permission
• spawn-on-join, name-format, max-name-length, follow-distance, teleport-distance
• require-type-permission, pets-attack-players, protect-from-players
• taming.mobs - items, chance, consume, max-health-percent for every tameable mob
• peaceful-mobs - mobs that cannot attack
• backpack - drop contents on recall / death
• hunger - enabled, interval, loss, max and the list of foods
• exp - base, exponent, max level, exp per health, owner share
• skilltrees and skilltree-by-type - fully customizable skill trees
• update-checker - enable it and set your Modrinth project slug

messages.yml - all messages, menus and help texts (MiniMessage format).

Pet data is stored per player in plugins/CompanionPets/data/.

Bugs and feedback

This plugin may contain bugs and unfinished features. If you find one, please report it on the developer's official Discord server: Join the Discord

When reporting, include your server version (Paper build), the plugin version and the console error, if there is one.

License

All Rights Reserved. You may run the unmodified plugin on your own servers (including monetized ones). Modifying, reselling and redistributing it is not allowed. See the LICENSE file.

Made by WhyRosy