DiscoverPets is a lightweight, interactive, and highly customizable pet system designed for modern Minecraft servers. Instead of simply buying or receiving pets, players must earn them through a built-in combat discovery system.

Built entirely on the Spigot API without any NMS (net.minecraft.server) dependencies, it guarantees stability and seamless compatibility across updates.

Core Features

Unlock via Discovery Players must hunt and defeat a configurable number of a specific mob to "discover" and unlock it as a companion. Every kill requirement is strictly tracked and can be fully modified in the configuration file.

Interactive Mounting & Carrying Pets are fully physical entities. Players can mount their pets to ride them or pick them up to carry them on their heads. The plugin features custom movement mechanics: aquatic pets allow for full 3D swimming, while ground pets adapt their speeds based on their environment.

Native Combat AI Certain pets, such as Iron Golems and Withers, retain their native vanilla combat AI. They act as active guardians, aggressively defending the owner against hostile threats without causing server lag or TPS drops.

Strictly Exploit-Proof The plugin is meticulously engineered to prevent all known vanilla edge-case exploits:

• Pets are invincible and cannot take damage from any source.
• Complete immunity to leads (lassos), fishing rods, and splash potions.
• Zero item duping (pets drop nothing upon despawning).
• Wild mobs will ignore pets, preventing players from using them as invincible decoys.
• Strict ownership checks prevent unauthorized players from interacting with, mounting, or opening pet inventories.

Commands & Permissions

Player Commands (discoverpets.use)

• /pets - Opens the main discovery and selection GUI.
• /pets help - Displays the help menu.
• /pets spawn <pet> - Spawns a specific unlocked pet.
• /pets despawn - Despawns the currently active pet.
• /pets mount - Mounts the active pet.
• /pets carry - Carries the active pet.

Administrator Commands (discoverpets.admin)

• /pets discover <pet> - Instantly bypasses the kill requirement and unlocks a pet for the user.
• /pets refresh - Reloads the configuration file without requiring a server restart.