Welcome to MC Pets!

Navigate through the wiki pages to find whatever information you need about the plugin. Looking for help ? Join the Discord !

✨ Check the requirements on the Wiki.

⭕ 3D modeled pets with ANY behavior, skills, effects and more based on MythicMobs and either ModelEngine or BetterModel

⭕ Create mounts using ModelEngine or BetterModel and implement them easily with MCPets

⭕ Unique inventory per pet

⭕ Pet statistics with MCPets 3.0.0 : experience, health, damage modifiers for skills and more

⭕ Taming, evolutions and pet food system with MCPets 3.0.0

⭕ Customizable in-game GUI interface : summon pets, show their stats, custom names, mount, skins, inventory... Organizable in categories

⭕ Custom item icons from ItemsAdder, Nexo, or CraftEngine

⭕ Give orders to your pets using the Signal Stick

⭕ Permission-based system and customizable permission for each pet, showing the pet or not in the GUI depending on the player having the permission for it

⭕ Flags to manage pet interactions with WorldGuard

⭕ MySQL support

⭕ Velocity cross-server pet sync — active pets follow players seamlessly between servers on a Velocity network (see mcpets-velocity/README.md)

✨ Need a demo pet to start with ? Check out Sleepy the Otter !

For CraftEngine-backed pet icons, signal sticks, or skin icons, set the item section's CraftEngineId to a namespaced item id, for example my_pack:pet_icon.

Compatibility

• Minecraft/Paper 1.21 through 26.2 (Java 25 is required by Paper 26.1 and newer)
• ModelEngine R4 or BetterModel 2.2.0 through 3.3.0
• The release JAR keeps Java 21 bytecode so existing 1.21 servers remain supported
• Maintainers can verify the 26.2 API combination with mvn -P minecraft-26.2 clean verify on JDK 25

---

Velocity Cross-Server Sync

This fork adds a companion Velocity proxy plugin (mcpets-velocity/) that keeps a player's active pet consistent across all synced servers in your network.

How it works:

• When a player switches to a synced server, their active pet is saved to the shared MySQL database and automatically spawned on the destination server
• Revoking a pet on any server clears the record network-wide — no ghost spawns
• Only servers listed under synced-servers in the Velocity config participate; all other servers are unaffected

Quick setup:

1. Enable MySQL in MCPets and point all synced servers at the same database
2. Set Velocity.Enabled: true in MCPets config.yml on each synced server
3. Drop MCPets-Velocity-<version>.jar into your Velocity proxy's plugins/ folder
4. Configure which servers to sync in plugins/mcpets-velocity/config.yml on the proxy

See mcpets-velocity/README.md for full setup instructions and configuration options.

---

⭕ Download some exclusive content and monthly releases on the Patreon

⭕ Get involved in the creation progress by picking your favorite model in a monthly selection

⭕ Access a patron-only channel on my Discord's workshop

✨ Partner ✨

Download more pets on MCModels.net