CompanionPets

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

Command · Description
/pet · Open the pet menu
/pet info · Show pet information
/pet call / /pet store · Summon / recall the pet
/pet list · List your pets
/pet switch [number] · Switch to another pet
/pet name · Rename the pet
/pet inventory · Open the pet backpack
/pet behavior [friendly\ · normal\ · aggressive] · Change behavior
/pet release · Release the pet (asks for confirmation)
/pet reload · Reload config.yml and messages.yml (admin)
/pet admin setlevel · Set the pet's level (admin)
/pet admin addexp · Give exp to the pet (admin)
/pet admin give · Give a pet to a player (admin)
/pet admin revive · Revive a dead pet (admin)

Aliases: /pets, /mypet.

Permissions

Permission · Default · Description
companionpets.use · everyone · Use pets and commands
companionpets.tame.* · everyone · Tame any configured mob
companionpets.tame. · - · Tame a specific mob (needed if require-type-permission: true)
companionpets.storage. · - · Pet limit, e.g. companionpets.storage.8 (highest wins; default from default-max-pets)
companionpets.cooldown. · - · Delay before summoning/switching after a recall or death (lowest wins, 0 = none; default from summon-cooldown-seconds)
companionpets.respawn. · - · Respawn time of a dead pet (lowest wins; default from respawn-seconds)
companionpets.update · op · Get notified about new versions
companionpets.admin · op · Reload and admin commands

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