Minecraft plugin SimplePets

🔌 About SimplePets

SimplePets is a Minecraft plugin that provides companion pets for Java edition servers. It offers a GUI for selecting and customizing pets, supports multiple pets per player, and includes cosmetic-focused features such as pet riding and pet hats. The project is maintained with a public repository and an official wiki.

🎯 Purpose

SimplePets solves the problem of offering lightweight, customizable cosmetic pets to players. It is primarily used to provide cosmetic rewards, donor perks, or hub/fun features where players can spawn, rename, ride, and customize companion mobs.

⚙️ Features

• GUI-based pet selection and management
• Multiple pets per player and individual pet names
• Pet riding and pet-as-hat functionality
• Pet customization via an in-plugin "Pet Data Changer" GUI
• Addon system for integrations with other plugins
• Persistent storage with MySQL and SQLite support
• Optional integrations detected at runtime (example: CustomEnderchest support)
• API available for other plugins to integrate with SimplePets

🧩 Who It Is For

• Survival/SMP servers that want cosmetic companions
• Public networks offering donor cosmetics or hub features
• Servers that need a maintained EchoPets replacement
• Server owners looking for an extensible pets system with an API for addons

🏗️ Example Use Cases

• Granting pets as rewards or purchaseables for donors
• Letting players customize and ride pets in a lobby or minigame hub
• Using addons to integrate pet behaviour with claim or storage plugins

⌨️ Commands

Note: SimplePets exposes a root /pet command with subcommands; available subcommands and exact syntax may vary by plugin version.

🔐 Permissions

⚙️ Installation

📥 Setup

• Download the official plugin JAR for the server Minecraft version.
• Place the JAR file into the server's plugins/ folder.
• Restart the server.
• Edit available config files as needed and restart to apply changes.

📦 Dependencies

• Optional integration: CustomEnderchest (integration is detected and used if present).

🧾 Configuration

• The plugin supports persistent storage via MySQL or SQLite (configurable).
• The plugin creates configuration and data files in its plugin folder; exact file names depend on the version.

🧠 Technical Notes

• Official sources indicate support for Bukkit/Spigot forks including Spigot, Paper and Purpur.
• The plugin provides a published API for other plugin authors to integrate with SimplePets.
• License: GPL-3.0 (as published in the repository).

🤝 When This Plugin Is Useful

If you want a maintained, GUI-driven pets system for player cosmetics, SimplePets is useful because it bundles selection, customization, persistence, and an addon API while supporting common server forks and database backends.