CompanionPets

CompanionPets lets you tame mobs, level them up, unlock powerful skills, equip backpacks, and take your companions on adventures.

Create your own team of pets with configurable taming, skill trees, hunger, behavior modes, and permission-based limits.

Features

Vanilla-Style Taming
Shift + Right-click mobs with matching items to tame them. Examples include bones for wolves, fish for cats and ocelots, seeds for parrots, berries for foxes, and special items for more powerful mobs.

Taming chances, required items, item consumption, and health requirements can be configured for each mob.

Multiple Pets
Keep multiple pets and switch between them using the pet menu or /pet switch. The default limit is 5 pets and can be customized through configuration and permissions.

Levels and Skill Trees
Pets gain experience from kills and can level up to level 50. Choose between four skill trees:
- Universal
- Warrior
- Tank
- Porter

Improve health, damage, speed, regeneration, and backpack capacity.

Pet Backpacks
Give your pets extra storage with backpacks of up to 6 rows. Backpack contents can drop when a pet is recalled, switched, released, or dies. This behavior can be configured.

Hunger System
Pets get hungry over time. A starving pet loses damage and movement speed. Feed your companions by right-clicking them with food.

Behavior Modes
Choose how your pets behave:
- Friendly — never attacks.
- Normal — defends itself and helps you fight.
- Aggressive — attacks nearby monsters.

Peaceful mobs such as pigs, cows, sheep, chickens, rabbits, parrots, allays, bees, and horses cannot attack and do not have behavior settings.

Horses
Ride your pet horse. Its saddle, armor, and coat are saved between summons.

Owner-Safe Pets
Pet Wardens never apply Darkness to their owner. Pet Withers do not break blocks or hurt players.

Summon Cooldown
Recalling or losing a pet starts a configurable cooldown before another pet can be summoned or switched. The default is 60 seconds.

Custom Names
Rename pets using /pet name. Names support colors and gradients.

Pet Menu
Shift + right-click your pet to open its menu.

Fully Translatable
All messages, menus, and help texts are stored in messages.yml and support MiniMessage formatting.

Update Checker
Notifies the console and administrators when a new version is available on Modrinth.

Commands

• /pet — Open the pet menu.
• /pet info — Show pet information.
• /pet call — Summon a pet.
• /pet store — Recall a pet.
• /pet list — List your pets.
• /pet switch [number] — Switch to another pet.
• /pet name <name> — Rename a pet.
• /pet inventory — Open the pet backpack.
• /pet behavior [friendly|normal|aggressive] — Change pet behavior.
• /pet release — Release a pet (confirmation required).
• /pet reload — Reload config.yml and messages.yml (admin).
• /pet setlevel <player> <level> — Set a pet's level.
• /pet addexp <player> <amount> — Give experience to a pet.
• /pet give <player> <mob> — Give a pet to a player.
• /pet revive <player> — Revive a dead pet.

Permissions

• companionpets.use — Use pets and pet commands (default: everyone).
• companionpets.tame.* — Tame any configured mob (default: everyone).
• companionpets.tame.<mob> — Tame a specific mob when require-type-permission is enabled.
• companionpets.storage.<N> — Set the pet limit. The highest matching limit wins.
• companionpets.cooldown.<seconds> — Set the summon/switch cooldown. The lowest matching value wins; 0 disables it.
• companionpets.respawn.<seconds> — Set the respawn time of a dead pet. The lowest matching value wins.
• companionpets.update — Receive update notifications (default: OP).
• companionpets.admin — Access reload and admin commands (default: OP).

Configuration

config.yml controls the plugin's mechanics, including:

• Default pet limit, summon cooldown, and respawn delay.
• Pet spawning on join, name formatting, and maximum name length.
• Follow distance and teleport distance.
• Taming requirements, success chances, item consumption, and health limits for each mob.
• Required permissions for taming specific mob types.
• Pet attacks against players and player protection.
• Peaceful mob behavior.
• Backpack item drops on recall and death.
• Hunger settings, food lists, and stat penalties.
• Experience progression, maximum level, and experience rewards.
• Custom skill trees and skill tree assignments by mob type.
• Update checker settings and Modrinth project slug.

messages.yml contains all messages, menus, and help text. Text uses MiniMessage formatting.

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

Requirements

• Server software: Paper 26.3
• Java: Java 25
• Dependencies: None
• Folia: Not supported

Installation

1. Download CompanionPets.jar.
2. Place the JAR file in your server's plugins folder.
3. Restart your Paper server.
4. Configure config.yml and messages.yml to your liking.
5. Use /pet to open the pet menu.

License

All Rights Reserved.

You may run the unmodified plugin on your own servers, including monetized servers. Modifying, reselling, and redistributing the plugin are not allowed. See the included LICENSE file for the full terms.

Author

Made by WhyRosy