SimplePets

---

Overview

SimplePets started out as an Easy-To-Use replacement for EchoPets (Which at the time of its first development was still supported)

Now 10+ years later it is called one of the best EchoPets replacements by quite a few users that have used EchoPets in the past.

These days SimplePets is mostly used as a cosmetic plugin, Most servers hand the pets out as a reward for their players to either flex with or to mess around with in their hubs.

---

Supported Versions

As of Aug. 24th, 2026 (R5-B311)

Minecraft	Java Version	Notes
26.2	Java 25	Latest
26.1	Java 25
1.21.11	Java 21
1.21.10	Java 21
1.21.8	Java 21	Minimum supported version

Spigot or any of its forks will work.

How patch versions are supported (26.1.1, 26.1.2, 26.2.1, etc.)

Minecraft patch releases (Eg: 26.1.1, 26.1.2, 26.2.1) usually do not change anything the plugin needs, so they do NOT require their own build of SimplePets.

When the plugin starts up it will:

1. Look for support that matches your exact server version
2. If there is none, it will link to the newest support that shares the same major/minor version and is not newer than your server
   • 26.1, 26.1.1, and 26.1.2 will all use the 26.1 support
   • 26.2 and 26.2.1 will both use the 26.2 support
3. You will see a message in the console letting you know your version was linked

If a patch release DOES break something, dedicated support for that exact patch version is added and the plugin will automatically pick it over the linked one.

* Version linking only applies to MC 26 and newer, 1.21.x versions require exact support *

Older Minecraft versions (Legacy Jars)

Support for older versions has been dropped over time, if you are on one of these versions you will need to grab the last build that supported it:

• MC 1.21.6 - Last supported build was R5-B295
• MC 1.21.7 - Last supported build was R5-B303

---

Features

The Pets

• 90 pet types and growing
  • (Majority of the mobs in the game can be a pet)
• Pet Riding
• Pet Hats
• Multiple Pets out at once
• Pet Saves
  • (Players can save their pets and their data to re-summon them later)
• Individual Pet names
  • (Different types of pets can have their own individual name)
• Multiple ways to rename a pet
  • (Anvil GUI, Dialog, Sign, Chat, or the '/pet rename' command)

Server Control

• Per-Pet configuration files
  • (Every pet has its own JSON file to control its permissions, speeds, and options)
• 95% customizable
  • (Majority of the messages are customizable excluding a few messages)
• Pet summon cooldowns
• World restrictions and per-world pet limits
• MySQL and SQLite support
• PlaceholderAPI support

The Plugin Itself

• Always updated to the latest MC version
• Always upgrading and improving the code
• Super easy to setup and use off the bat
• Plugin Addons

---

How to Install

1. Download the Plugin
2. Open your servers plugins folder
3. Drop the plugin jar into the folder
4. RESTART your server
5. Modify the config files
6. RESTART your server to finalize the values

* As of R5-B292 there is only ONE jar file, it supports every listed Minecraft version *

---

Pet Selection

A nice clean GUI that can be used to spawn the pets you would like.

The GUI also has items that allow you to Ride your pet, Manage Pet Saves, Rename Pets, And finally put your pet on your head.

---

Pet Customization

All pets have data that can be customized, The 'Pet Data Changer' GUI allows the players to easily modify their pets looks/data to what they want.

---

Plugin Addons

Thanks to the v5 code base the plugin can easily link into other plugins via Addons.

These Addons can be installed manually via FTP, Or they can be installed IN-GAME via '/pet addon'

* New Addons are always being added *

A few of the Addons

Let players buy their pets

• Vault - Pets can be purchased via in-game currency
• PlayerPoints - Pets can be purchased with PlayerPoints
• TokenManager - Pets can be purchased with tokens
• GemsEconomy - Pets can be purchased with gems
• Treasury - Pets can be purchased via in-game currency
• ItemEconomy - Pets can be purchased with in-game items

Keep the pets where they belong

• WorldGuard - Stop specific pet events inside regions
• GriefPrevention - Stop specific pet events on or off of claimed land
• PlotSquared - Allow/deny pet events on parts of a plot world (road/unclaimed/denied)
• Residence - Stop specific pet events in selected areas
• RedProtect - Adds pet flags (pet-spawning, pet-moving, pet-riding, & pet-mounting)
• WorldBorder - Stop specific pet events from happening outside of borders
• WorldRestriction - Restricts certain tasks from happening in certain worlds

Extras

• PetWeight - Pets have actual weight and slow the player down while on their head (It stacks with more pets)
• PvP - Removes the players pets when they are in combat
• Vanish - Pets vanish when the player is vanished with Super/Premium Vanish
• PermissionLore - Adds a lore to the pet items if they do/don't have permission for the pet

The full and always up-to-date list lives on the addon page: bsdevelopment.org/addons/SimplePets

* The plugin pulls this same list in-game from https://bsdevelopment.org/api/addons/list/SimplePets *

---

Outdated Youtube Videos

Disclaimer

This version of SimplePets is a complete recode of the old version {v4}

This resource has a much cleaner code base then v4.4 And will allow us to make updates easier

v5 has code that supports addons for other plugins as well as future smaller features we see as "Not for the plugin"