Pets - XPrison Addon v1.1.0

1.1.0 — "Hatch, Fuse, Grind"​

The biggest update since launch: four new ways for your players to chase pets, a much faster addon, and a set of fixes for things that were quietly costing you performance.

Upgrading is safe. Your existing configuration is migrated for you, and every file the addon rewrites is backed up first (config.yml.v1.bak and friends). New settings are added to your files without touching anything you have customised.

Click to expand...

---

New for your players​

Pet Fusion — duplicates finally mean something Combine several duplicate pets of the same type and rarity into a single pet of the next rarity up. Before this, a second copy of a pet a player already owned was worthless. Now it is a chase, and a second place for your economy to drain into.

You control the number required, the success chance, the cost, what the new pet inherits, and what a failed attempt costs. Players never lose their best copy — a fusion always consumes their weakest duplicates first.

Pets that level up while you mine Turn on an XP curve for any pet and it earns levels just by being used, alongside (or instead of) paid upgrades. Pets used to sit still unless a player spent currency on them; now they grow while your players actually play. Still no database — the progress lives in the item.

Egg tiers — sell more than one kind of egg Define as many kinds of Pet Egg as you like, each with its own icon, name, pet pool and drop odds. Ships with three examples: a Basic Egg, a Legendary Egg that cannot roll the low rarities, and a themed Pickaxe Egg. Perfect for crates, ranks and store bundles.

Eggs can also show the real drop chance of every rarity in their tooltip — and rare outcomes stay readable (a 1-in-1000 pet shows as 0.10%, never 0%).

Milestone and prestige rewards Pay out commands, messages and sounds when a pet reaches a level or prestige you choose. Buying thirty levels at once still fires every milestone crossed, exactly once each — and players cannot farm them by prestiging in a loop.

---

Quality of life​

• Menus now have pages. Previously a player who owned more pets than fitted on one screen simply could not see or upgrade the rest. Everything paginates now.
• Toggle a pet from the menu with shift-click, instead of hunting for it in your hotbar.
• Pets work out of the box. Permission nodes now ship with sensible defaults — everyone can use /pets, admins get /petsadmin — so a fresh install no longer looks broken to normal players. Prefer to sell pet access as a rank perk? Flip one setting.
• Protect your economy. New optional caps stop stacked pets running away with your income: a hard ceiling on total boost, and a diminishing-returns curve for each extra active pet.
• You choose what pets boost. Which currency sources and pickaxe-XP sources qualify are now settings, not hard-coded rules.
• Make a pet rare. Pets can be weighted so some come out of eggs far less often than others — or never, if you want them admin-only.
• Renaming a command now works immediately with /petsadmin reload, instead of needing a restart.

---

Performance​

This release includes a full performance pass. If you are running pets at scale, this is the important part.

• Fixed a startup-time stall that could freeze the server for seconds. Pet head textures were being resolved in a way that could make the server call out to Mojang on the main thread — which cannot succeed, and only gives up after a network timeout. It was triggered the first time anyone opened a pets menu. Textures are now resolved entirely offline, and all icons are built during startup so no player ever pays for it.
• Fixed a bug that ran heavy work on every block break. A pet that had reached max level made the addon re-scan the player's inventory, rebuild the item and resend the inventory every single block they mined. Harmless if you never enabled pet XP; brutal if you had.
• Menus are dramatically cheaper to open. Icons are now rendered once and shared between players with identical pets, so the cost goes down per player as your server gets busier. Menu text was also being rendered twice per item — that is gone.
• The mining path does far less work. Currency gains for a currency no pet boosts, and pickaxe XP when you have no pickaxe pets, now cost effectively nothing.
• Smaller download. The jar shed a bundled library it never needed — about 27% lighter.

---

Fixes​

• Pets past the first menu page were invisible and unusable.
• Placeholders could be read from the wrong thread by scoreboard and tab plugins, risking errors on busy servers.
• The active-pet limit contradicted itself: a pet could block you from activating another while granting no boost, and the active-count placeholder reported the wrong number.
• Equipping or dropping a pet took up to a second to affect your boost; it is now immediate.
• Blanking a message to silence it sent an empty [Pets] prefix instead of nothing.
• Holding a pet let you activate it and open eggs even without permission.
• Menus could show stale information after an action in some cases.
• Pets could be worn as a hat. Most pets are player heads, so vanilla let players equip them into the helmet slot — which looked wrong and could confuse armour addons. Every route is now blocked (clicking, dragging, number-key swapping, shift-clicking and even dispensers), with a message explaining that pets are carried, not worn. Shift-clicking a pet still tidies it between your hotbar and inventory as you'd expect.
• Fusion now lists pets already at the highest rarity, marked as such, instead of hiding them and leaving the player with an unexplained empty menu.

---

Notes for upgraders​

• pets.yml is never auto-merged, because it holds your own pet definitions. The new optional blocks (xp:, milestones:, prestige-rewards:, weight must be added by hand — pets without them keep working exactly as before.
• The Pet Egg's name moved from gui.yml into eggs.yml. If you customised it, it is copied across for you automatically.
• Requires X-Prison 2026.3.0.2 or newer.
• Paper and Spigot. (Folia is not supported — X-Prison core and this addon share the same scheduler, so the addon cannot be more Folia-capable than the core it plugs into. The previous "Folia-ready" claim was incorrect and has been withdrawn.)