BetterPets-Paper

Fix: Skins are now yours, not the pet's

Unlocked cosmetic variants are now collected per player (per pet type) instead of being stored on the individual owned pet. - Scrapping a pet's skin unlocks it for you regardless of whether you own that pet, and it stays in your collection even if you later scrap all your copies. - The Customize menu and skin-swapping read from your personal collection. - Existing data migrates automatically — your pets' current skins and previously unlocked variants are moved into your per-player collection on first load. Compiles clean on Paper 26.2; 63/63 tests pass. Drop BetterPets-1.17.3.jar into your plugins/ folder.

Fixes

- Salamander now respects Fortune (and Silk Touch) on your pickaxe. It smelts the block's real drops for the held tool instead of always dropping a single ingot — so a Fortune pickaxe gives you the extra ingots you'd expect. - Golem Mason reach now works for building. It was extending entity reach (attack range) instead of block reach, so you couldn't place/break blocks farther. Fixed to extend BLOCK_INTERACTION_RANGE. - Woodpecker only fells natural trees now — verified via non-persistent leaves, so your player-placed logs (houses, builds) are left alone. At level 100 it fells the whole tree, no matter how big. Compiles clean on Paper 26.2; 66/66 tests pass. Drop BetterPets-1.17.2.jar into your plugins/ folder.

Goblin Rebalance

The Goblin refunded the full base emerald price on every steal — and since it also discounts prices, that let you profit from trades. Reworked: - The stolen amount is now random and scales with level. Only a level-100 Goblin can grab the full price back; lower levels get a fraction, so a trade is never profitable below max level. - It can now also pickpocket the exact item the villager sold (the enchanted book, tool, etc.) in a small random amount — not just emeralds. Compiles clean on Paper 26.2; 66/66 tests pass. Drop BetterPets-1.17.1.jar into your plugins/ folder.

7 New Build & Collect Pets (now 79 total)

The rest of the backlog is in: - Golem Mason (Epic) — longer reach, and your held block stack auto-refills from your inventory. - Silk Moth (Legendary) — a chance to mine glass, ice, ore and glowstone as if with Silk Touch. - Woodpecker (Legendary) — chopping one log fells the whole tree at once (uses axe durability). - Badger (Mythical) — breaking one ore chases the whole vein (uses pickaxe durability). - Salamander (Epic) — a chance for mined ores to drop already smelted into ingots. - Magpie (Rare) — draws in nearby XP orbs and grants a small luck bonus. - Scarecrow (Epic) — harvested crops auto-replant, nearby crops grow faster, with bonus yield.

Cave Spider Fixes

- Climbing and clinging now run every tick (they were on the slower 3-tick loop) — hold sneak now holds you perfectly still so you can turn around. - Reaching the top of a wall now hops you onto the ledge instead of dropping you back down. Compiles clean on Paper 26.2; 66/66 tests pass. Drop BetterPets-1.17.0.jar into your plugins/ folder.

Important Fix

- Mechanist no longer freezes the server. Its structure compass located every registered structure on the main thread each tick (synchronous disk I/O) — that caused the 25-second server hang. The compass is removed; the Mechanist now just reveals nearby spawners through walls, and a spawner you mine stops glowing immediately.

New & Improved

- Lion is now a rideable ground mount — right-click to ride (no level requirement, land only, no flight). Forward to run, jump to hop over 1-block steps, sneak to dismount. No horse inventory. Sneak + right-click still opens Customize. - Cave Spider climbing reworked — face a wall to climb it (look down to descend), and hold sneak to cling in place so you can turn around without falling off. - Snow Golem now visibly throws snowballs from the pet, with a throw sound. - Mimic now shows a visible shield (particle ring + shield sound) when it wards a hit. Compiles clean on Paper 26.2; 66/66 tests pass. Drop BetterPets-1.16.0.jar into your plugins/ folder.

Fixes

- /pets give now tab-completes variant skins — after the pet (and level/player), the command suggests that pet's variants, so you can see and pick a specific skin to give. - Pet name aliases — pets can now be given by alternate names. Added German aliases for the new pets, e.g. schutzengel → Guardian Angel, greif → Griffin, plus skorpion, gottesanbeterin, loewe, hoehlenspinne, schneegolem, arkanerfuchs, mechaniker, krake, waschbaer. (The English id/name still works too — e.g. /pets give guardian_angel.) Compiles clean on Paper 26.2; 66/66 tests pass.

Collect and Wear Skins

Pets now collect the variants you find. - Unlock by scrapping — when you scrap a pet whose skin your matching pet hasn't seen yet, that skin is unlocked for your pet (you still get the tokens too). Works with /pets scrap and /pets scrap all. - Customize menu — sneak + right-click your pet (or just right-click pets that have no other right-click action) to open it: - Particles ON/OFF per pet. - Pick your skin from everything you've unlocked; the active one is marked. - Locked skins are shown as gray panels ("Locked: X — find and scrap this skin to unlock it"), so you can see what's still out there. - Swapping a skin updates your summoned pet live. Compiles clean on Paper 26.2; 66/66 tests pass. Drop BetterPets-1.15.0.jar into your plugins/ folder.

15 New Pets (now 72 total)

Combat — Scorpion (poison + slow on hit), Mantis (longer reach + bonus strike), Panther (sneak backstab), Lion (attack damage + weakening roar), Raccoon (pickpocket bonus drops). Defense — Mimic (chance to ward a hit), Guardian Angel (Absorption/Regen + a shield when death is near), Yeti (freezes attackers). Movement — Sugar Glider (glide, steer forward while sneaking), Cave Spider (hold sneak against a wall to climb + no fall damage), Griffin (rideable flyer from level 50). Utility — Snow Golem (snowball barrage + no freezing), Arcane Fox (bonus XP from mobs & ores), Mechanist (reveals spawners through walls + an action-bar compass to the nearest structure, including datapack structures), Kraken (drags nearby foes to you and crushes them in water). New mechanist: config block. Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.14.0.jar into your plugins/ folder.

261 New Skin Variants

38 more pets now have cosmetic variants (like the Axolotl) — bat, cat (18!), dog, tiger, spinosaurus (21!), allay, crab, worm, duck, penguin, rabbit, snail, and many more — 261 new head skins in total. - Every pet with variants rolls a random skin; pets you already own are assigned one automatically. - Loot & discovery items now show the exact variant and grant that same skin when claimed. - /pets give <pet> [level] [player] [variant] hands out a specific skin. - Catalogue gallery: open a pet's details → View Variants to browse all its skins page by page. - Panda: the level-100 Enchanted skin is now a normal enchanted variant. Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.13.0.jar into your plugins/ folder.

Fix

While riding a flying pet, looking down to break or place a block below you no longer fails. The pet's clickable hitbox used to sit on top of the rider and intercept those clicks; it is now shrunk to a point while flying and restored the moment you dismount (sneak). Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.12.2.jar into your plugins/ folder.

Ferret Rebalance

The Ferret's ore sense was too strong, so it has been reined in: - Pickaxe required — the reveal only works while you hold a pickaxe, making it a mining aid rather than passive x-ray. - Smaller radius — cut from ~10 blocks to 4–7 (still scales with level). - Caps at diamond — gold, iron, redstone, lapis, diamond and emerald reveal; netherite is never shown. - Fewer at once — max glowing ores lowered from 80 to 24. Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.12.1.jar into your plugins/ folder.

Polish

Rarity auras — every Epic-and-above pet now trails an ambient particle aura. Pets with their own signature effect keep it; the rest get a rarity-based aura (Epic = witch sparkles, Legendary = end-rod, Mythical = enchant + end-rod). Common and Rare pets stay clean. Water Serpent and Ferret pick this up automatically. Kangaroo — the mid-air double-jump now pops a bigger cloud + crit burst with an added sweep sound. Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.12.0.jar into your plugins/ folder.

Five New Pets

Firefly (Common) — Night Vision, and hostile mobs stop spawning within a radius around you that grows with level. Ferret (Mythical) — Reveals nearby ore through walls, unlocking richer veins as it levels: coal → copper → iron/redstone → gold/quartz → diamond/emerald → netherite. Kangaroo (Rare) — Sneak in mid-air for a double-jump that launches you forward and up. Squirrel (Common) — Breaking leaves and logs sometimes drops bonus saplings, apples and sticks. Water Serpent (Epic) — Faster fishing bites, a chance at double catches, and sea luck while holding a rod. New config under firefly: and ferret:. Compiles clean on Paper 26.2; 52/52 tests pass. Drop BetterPets-1.11.0.jar into your plugins/ folder.

Head Overhaul

Axolotl variants — every Axolotl now rolls one of 5 styles (Lucy, Wild, Gold, Cyan, Blue), stored per pet and shown in its lore. Existing Axolotls get a random style automatically. Panda Enchanted skin — Pandas gain the Enchanted Panda skin at level 100, updating live the moment they hit 100. Refreshed heads — new textures for Bee, Chicken and Capybara. All existing pets update automatically; the texture is folded into the head's profile UUID so the client no longer caches the old skin. Compiles clean on Paper 26.2; 42/42 tests pass. Drop BetterPets-1.10.0.jar into your plugins/ folder.

Better Pets v1.9.3 — flight polish + visibility commands. Download `BetterPets-1.9.3.jar` below into your server's plugins/ folder. Requires Paper 26.2, Java 21.

Flight

- Right-clicking your pet while flying no longer dismounts you — sneak to hop off. - Starting flight now needs a confirming second right-click, so you never take off by accident.

New commands

- /pets visible and /pets invisible (aliases show / hide) — show or hide your active pet without opening the menu. Localized in English / Deutsch / Polski.

Better Pets v1.9.2 — fly higher. Download `BetterPets-1.9.2.jar` below into your server's plugins/ folder. Requires Paper 26.2, Java 21.

Change

- Removed the pet flight height cap. Mounts were limited to the world's build height (~Y 319); you can now fly well above it into open sky, capped only by a generous configurable safety ceiling (flight-max-height, default 1024).

Better Pets v1.9.1 — bugfixes for Minecraft / Paper 26.2. Download `BetterPets-1.9.1.jar` below into your server's plugins/ folder. Requires Paper 26.2, Java 21.

Fixes

- Flying pets no longer clip you into blocks. The mount collision now samples your whole body, and you can never take suffocation damage while flying on a pet. - Pets no longer get in your way. Pet hitboxes are non-attackable, and pets without a right-click action get a tiny hitbox so they never block your mining, attacking or building. The Alpaca and flyable dragons/Phoenix keep a clickable hitbox (hide any pet with the visibility toggle in /pets if needed).

Better Pets v1.9.0 — now targets Minecraft / Paper 26.2. Download `BetterPets-1.9.0-mc26.2.jar` below into your server's plugins/ folder. Requires Paper 26.2, Java 21.

Paper 26.2

- api-version → 26.2, built against paper-api 26.2.build.62-beta (Build #62). - Paper 26.2 ships Adventure 5.2.0; the build now pulls the matching Adventure 5.x jars and orders the classpath so they take precedence over older server libraries. - build.ps1 downloads the Paper API and Adventure itself when missing; output jar renamed to better-pets-26.2-plugin.jar. - No gameplay changes — the entire codebase compiled against 26.2 without a single source change.

Which version do I need?

| Your server | Use | |---|---| | Paper 26.2 (experimental/beta) | v1.9.0 (this release) | | Paper 26.1.2 (stable) | v1.8.1 | Because api-version is now 26.2, this build will not load on a 26.1.2 server. Verified: compiles against Paper 26.2 + Adventure 5.2.0; 42/42 logic tests pass.

Better Pets v1.8.1 — bugfix. Download `BetterPets-1.8.1.jar` below into your server's plugins/ folder. Requires Paper 26.1.2, Java 21.

Fix

- The slot machine's featured pet no longer changes every time you open /pets slots. It now stays the same until you actually spin, and is remembered per player.

Better Pets v1.8.0 — the pet slot machine grows up. Download `BetterPets-1.8.0.jar` below into your server's plugins/ folder. Requires Paper 26.1.2, Java 21.

Slot machine

- 12 material loot types (gold nugget, coal, iron, copper, redstone, lapis, gold ingot, XP bottle, emerald, diamond, netherite scrap & ingot), each with its own chance — netherite kept rare. - Reels now settle left → middle → right. - A featured pet is shown every spin; land on the pet symbol to win that pet (chat message + optional server jackpot broadcast). Pet chance bumped up a little. - Spinning costs just 1 token. - Admin "Configure Loot" GUI inside /pets slots to tune every reward's chance live (±1, shift ±10, shows %). Also under tokens.slots.weights in config.yml.

Token commands

- /pets tokens pass <player> <amount> — send your tokens to another player (anyone). - /pets tokens give|remove <player|all> <amount> — admins manage tokens (works from console). Localized in English / Deutsch / Polski. --- Release prepared with [Claude Code](https://claude.com/claude-code)

Better Pets v1.7.0 — turn duplicate pets into tokens and gamble them in a slot machine. Download `BetterPets-1.7.0.jar` below into your server's plugins/ folder. Requires Paper 26.1.2, Java 21.

Pet tokens

- /pets scrap (held pet item) or /pets scrap all (whole inventory) → tokens. - Rarity values: Common 1 · Rare 2 · Epic 3 · Legendary 4 · Mythical 5 (configurable). - /pets tokens shows your balance (saved per player).

Slot machine — /pets slots

- Animated reels; each spin costs tokens (default 3). - Weighted rewards: gold nuggets → iron → gold → diamonds → netherite, and very, very rarely (~0.5 %) another pet (chosen by spawn weight). - Tuned as a fun sink for duplicates, not a farm. Configure everything under tokens: in config.yml; tokens.enabled: false disables the feature. Localized in English / Deutsch / Polski. --- Release prepared with [Claude Code](https://claude.com/claude-code)

Better Pets v1.6.0 — localization, a nicer look, quality-of-life and fixes. Download `BetterPets-1.6.0.jar` below and drop it into your server's plugins/ folder. Requires Paper 26.1.2, Java 21. Optional: LuckPerms, BetterModel.

Localization — English / Deutsch / Polski

- Text lives in plugins/BetterPets/lang/<code>.yml. Choose one with language: in config.yml, or switch live with /pets language <en|de|pl>. - Upgrade-safe: new keys are merged into your language files on start, so custom text survives updates. A legacy messages: block is migrated automatically. - Messages use MiniMessage (<gradient:#a:#b>, <bold>, colours); placeholder values are escaped (injection-safe).

Nicer look

- Gradient GUI titles and [BetterPets] broadcast prefix. - Prettier level-up, Phoenix, booster, convert and mute messages. - config.yml reorganized into numbered, documented sections.

Quality of life

- Convert To Item now confirms and preserves the pet's level and in-level XP. - /pets mute — hide discovery/booster broadcasts (text + sound) for yourself; persists across relogs. - Middle-click a pet in Spawn Chances (or the XP Multiplier) to type an exact value in chat.

Fixes & performance

- Phoenix revive no longer fires on a hit fully soaked by absorption hearts. - Experience-orb XP is no longer double-counted toward pets. - Auto-updater is config-driven and opt-in (update.repo / update.enabled). - Coalesced saves, cached XP multiplier, configurable Penguin scan interval, debug-logging off by default.

Permissions

- The XP Multiplier control and `/pets drop` menu now require betterpets.admin (was betterpets.chances).

Under the hood

- Per-pet data/behaviour moved into a PetAbilities registry; menu holders and the updater split out of the main class. Added a dependency-free test suite. --- Release prepared with [Claude Code](https://claude.com/claude-code)

Better Pets v1.5.3

Fix: Shadow Dragon no longer crashes the server

The Shadow Dragon's on-hit AoE burst damaged nearby mobs as the player. That damage re-fired the damage event (and the pet's on-hit ability), which triggered the burst again — an infinite loop that spammed the console with StackOverflowError and could crash the server. The burst now stores its cooldown before firing and uses a re-entrancy guard, so it fires exactly once per hit. No behaviour change otherwise. --- Requires: Paper 26.1.2, Java 21+ (Java 25 recommended with BetterModel 3.x). Drop better-pets-26.1.2-plugin.jar into your server's plugins folder.

Better Pets v1.5.2

Fix: Penguin container glow no longer blocks chests

The Penguin's container glow (added in v1.5.1) used an invisible glowing Shulker. A Shulker is a real mob, so its hitbox intercepted your clicks — you couldn't open the glowing container — and it could even be attacked. It now uses a BlockDisplay, which has no hitbox: clicks pass straight through to the container, and it cannot be attacked or killed. Same owner-only, through-wall glow for nearby unopened chests, trapped chests, barrels and chest minecarts — now rendered in cyan at full brightness. --- Requires: Paper 26.1.2, Java 21+ (Java 25 recommended with BetterModel 3.x). Drop better-pets-26.1.2-plugin.jar into your server's plugins folder.

Better Pets v1.5.1

Shadow Dragon AoE is now on-hit

The burst only fires when you attack and the cooldown is ready; after firing, the boss bar counts down and the next hit triggers it again. The bar reads "Shadow Dragon AOE ready — attack!" when charged.

Goblin steal notification

When your Goblin snatches the emeralds back from a villager, you now get a clear player-only chat message (plus the action-bar flash).

Penguin Treasure Sense is now a glow

Instead of particle markers, nearby containers a player has never opened now glow through walls, for you only: - Works for chests, trapped chests, barrels and chest minecarts. - Block containers glow via an invisible glowing Shulker shown only to the owner; chest minecarts glow via the per-viewer glow used for revealed mobs. - Handles worlds that pre-generate loot (where a container looks "opened" even though nobody touched it): a container carries a "player opened" marker, so a never-opened pre-generated container still glows and only stops once a player actually opens it. - Reach grows with level (up to 24 blocks). Glows are owner-only and cleaned up on despawn, quit, reload and server start. --- Requires: Paper 26.1.2, Java 21+ (Java 25 recommended with BetterModel 3.x). Drop better-pets-26.1.2-plugin.jar into your server's plugins folder.

Better Pets Paper v1.5.0

A big content update: a rarity overhaul, ambient particle auras for every high-rarity pet, and a batch of ability reworks.

Rarity overhaul

- Epic is now pink, and the old Extraordinary tier is renamed to Mythical (dark purple). - Goblin promoted to Mythical. All six former Extraordinary pets (Herobrine, Phoenix, Reaper, Ender Dragon, Shadow Dragon, Ancient Elf) plus the Goblin are now Mythical. - Every pet you already own updates automatically — rarity is read live, nothing is stored per pet. extraordinary still works as a config/legacy alias.

Particle effects

- Every Epic-and-above pet now has a fitting ambient particle aura while visible — Pixie fae sparkles, Lich souls, Goblin emerald glints, Phoenix embers, Warden sculk, and more. Dragons and the Unicorn keep their existing trail/glitter.

Ability reworks

- Shadow Dragon — the aura became a cooldown AoE burst: a ring of shadow particles briefly appears, nearby hostiles take damage, and a boss bar shows "Cooldown to AOE Damage". The cooldown shrinks as it levels (~12s → 4s). - Ender Dragon — now deals bonus damage in every dimension, not just The End. - Mole — saves durability on any block broken with an axe, pickaxe or shovel (was dirt/sand/gravel only). - Goblin — dropped the coin-on-kill perk; instead a small level-scaled chance that a villager purchase refunds its emerald cost (a free buy). Cheaper trades stay. - Penguin — new Treasure Sense: client-side markers only you can see on nearby unlooted structure chests/barrels, radius growing with level. - Chicken — keeps Slow Falling and now lays eggs over time, more often and more at once as it levels. - Pixie — grants more simultaneous random buffs at higher amplifiers as it levels. - Pufferfish — same undead wither aura, now wider and stronger with level. - Koala — same tree-rest heal, Regeneration I → III with level. - Bee — fixed: standing next to plain flowers (poppy, dandelion, …) now correctly grants Regeneration.

Performance

- Penguin's chest scan only checks loaded chunks via a cheap container filter; ambient particles and scans are throttled; the Shadow Dragon boss bar reuses the existing tick loop. --- Requires: Paper 26.1.2 · Java 21 · (optional) BetterModel for 3D models.

Better Pets Paper v1.4.1

A bug-fix patch for the flight and pet-item issues introduced in v1.4.0.

Fix: flying pets now actually move

In v1.4.0 you could mount your pet, but it stayed put — armor-stand mounts ignore velocity. The mount is now moved every tick with block-collision checks, so flight works, stays smooth, and slides along walls instead of clipping into blocks. Controls are unchanged: look to steer, forward to fly, jump to climb, sneak to dismount.

Fix: pet items no longer vanish when put on your head

Player-head items auto-equip to the helmet slot on right-click (a 1.21.2+ behavior), which raced the "claim pet" logic and could eat the item. Pet items are now non-equippable, so right-clicking cleanly adds the pet to your list — no helmet flicker, no item loss. --- Requires: Paper 26.1.2, Java 21+ (Java 25 recommended with BetterModel 3.x). Drop better-pets-26.1.2-plugin.jar into your server's plugins folder.

Better Pets Paper v1.4.0

Flying pets are now real, steerable mounts

You sit on your pet and steer it like a proper flying mount. The mount is moved by velocity every tick instead of being teleported, so flight is smooth, has no input lag, and collides with blocks — no more clipping inside walls. - Look to steer, hold forward to fly, jump to climb, look down to dive, sneak to dismount. - Tunable via flight-speed, flight-lift, and flight-pet-offset in config.yml.

Phoenix flight from level 50

Ride your Phoenix (with a flame trail) just like the dragons — this also works for existing Phoenix pets, and the catalogue now shows the level-50 flight unlock.

10 new pets — each with a real custom head

- Goblin (Epic) — cheaper villager trades (Hero of the Village) and bonus emeralds from kills. - Bee (Rare) — Regeneration near flowers or crops (Regen II at level 80). - Crab (Rare) — more damage and armor near water. - Otter (Epic, rare) — water breathing and faster swimming. - Crystal Golem (Epic) — chance for extra ores and crystals when mining. - Pixie (Epic) — grants random small buffs over time. - Moon Fox (Epic) — Speed and Strength at night. - Lich (Legendary) — steals life when you kill mobs. - Shadow Dragon (Extraordinary) — dark AoE damage aura with shadow particles; rideable from level 50. - Ancient Elf (Extraordinary) — shortens debuffs, caps them to 2s from level 50, and nullifies all debuffs at level 100.

Paginated menus

With 52 pets total, the catalogue and spawn-chances menus now have Previous/Next page buttons so every pet stays reachable. --- Requires: Paper 26.1.2, Java 21+ (Java 25 recommended with BetterModel 3.x). Drop better-pets-26.1.2-plugin.jar into your server's plugins folder.

Better Pets Paper v1.3.2

Built for Minecraft / Paper 26.1.2, Java 21.

Fix

- Pre-generated chest broadcasts: when a chest's loot was rolled before it was opened (e.g. at world/chunk generation), the pet was placed but no discovery broadcast fired. The pet is now marked at loot time when there is no opener, and the broadcast fires when a player opens the container (or picks the item up), crediting that player. It announces exactly once.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder (or run /pets update from an older build and restart).

Better Pets 1.3.1

- Added /pets xpboost give <x2-x5> <time> [player]. - Preserves custom pet names when converting pets back into items. - Blocks Better Pets items and boosters from anvil renaming. - Improves booster/pet lore and /pets help. - Adds booster drop/activation broadcasts and sound feedback. Validation: Maven package with JDK 25.

Better Pets Paper v1.3.0

Built for Minecraft / Paper 26.1.2, Java 21. A large feature release.

New

- Pet XP Boosters: hostile mobs can rarely drop a booster (x2-x5) lasting 15/30/45/60 minutes. Right-click to activate; it speeds up pet leveling only (never your own XP), does not stack, and the timer only counts down while you are online. Stackable as an item. Drop chance is configurable in /pets drop and config.yml, and your booster status shows in the pet menu. - Rename pets: /pets set name <name> and /pets restore name (keeps all level/XP/abilities). The custom name shows on the hologram for head and BetterModel pets. - Catalogue now shows each pet's rarity and default drop weight, with clearer level milestones.

Safety & config

- Corrupted pets.yml is quarantined instead of being silently wiped; one broken pet no longer drops a whole player's data. - Daily backups under plugins/BetterPets/backups (storage.backup.*). - New storage config (storage.type yaml default; sqlite is a documented opt-in seam and safely stays on YAML for now). - Fully commented config.yml + automatic missing-option repair on start.

BetterModel

- Model validation warnings (flags synced .bbmodel files BetterModel did not load, or models without animations) and clearer head-fallback reasons.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder (or run /pets update from an older build and restart).

Better Pets Paper v1.2.7

Built for Minecraft / Paper 26.1.2, Java 21.

Fix

- Reliable chest discovery broadcasts everywhere: find notifications now fire for all containers, including chests in custom / data-pack structures (e.g. strongholds) where the previous opener lookup could miss. The opener is resolved via the loot event entity, then the recorded interaction, and finally the nearest player to the container.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder (or run /pets update from an older build and restart).

?? Better Pets Paper v1.2.5

Built for Minecraft / Paper 26.1.2, Java 21.

New pet sources

Pets can now be obtained from more than just chests. Toggle each source and tune its chance in the new `/pets drop` GUI (or config.yml under pet-sources). - ?? Fishing: small chance (lower than chests) to fish out a pet - Player fished out a . Pet! - ?? Wandering Trader: a spawned trader can carry a one-time deal to buy a pet; the price scales with rarity and costs emeralds plus other valuables (gold/diamonds/netherite) - Player bought a . Pet from a Wandering Trader! - ?? Brushing: small chance to brush a pet out of suspicious sand/gravel - Player brushed out a . Pet! - ?? Chests: unchanged, still using chest-pet-chance-percent. Every source has its own enable toggle and configurable chance, just like chests, and uses the same per-rarity broadcast toggles as /pets notify.

Notes

- A branch 1.2.5 was created alongside main.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder (or run /pets update and restart).

Patch (added to v1.2.5)

- ?? Fixed a double chest being able to hand out two pets: both halves now share a single roll.

?? Better Pets Paper v1.2.4

Built for Minecraft / Paper 26.1.2, Java 21.

Fixes & features

- ?? Pets look at you again: fixed the recurring bug where pets faced the player's gaze direction instead of looking at the player (a regression from 1.2.2). It is now documented in code so it cannot be flipped again. - ?? `/pets update`: admin command that downloads the latest release jar straight from GitHub into the server's update folder; it is applied automatically on the next server restart. Only a GitHub-hosted jar asset is accepted.

Notes

- A branch 1.2.4 was created alongside main.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder (or just run /pets update from an older build and restart).

Patch (added to v1.2.4)

- ?? Fixed missing discovery broadcasts when opening double chests (and other containers): the opener is now matched against both halves of a double chest, so find notifications are no longer lost.

?? Better Pets Paper v1.2.3

Built for Minecraft / Paper 26.1.2, Java 21.

Improvements & fixes

- ?? Mending-proof XP: pet XP now counts the full value of every experience orb (mining, mobs, furnaces, fishing, trading.) before Mending diverts any of it to tool repair - ore XP always counts. - ? Lighter saving: the storage file is no longer written on every XP gain; XP is persisted by the periodic autosave and on quit/disable. - ?? `/pets version`: shows the plugin version, which modules are active, and checks GitHub Releases for a newer version (async). - ??? Animation-driven movement: a model is grounded or flying based on its own animations (walking vs flying), or forced by a model-name suffix (ant_grounded / ant_flying). The model-movement-mode config option was removed. - ?? Performance: grounded models cache their ground height per block column instead of ray-casting every follow tick.

Notes

- External modules (BetterModel) remain experimental and disabled by default (experimental-modules: false). - A branch 1.2.3 was created alongside main.

Install

Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder.

?? Better Pets Paper v1.2.2

Built for Minecraft / Paper 26.1.2, Java 21.

New: optional module system (experimental)

- ?? A generic Module system (modules.yml) plus an optional BetterModel module that renders pets as animated 3D .bbmodel models, with a clean fallback to pet heads. All BetterModel API stays inside one hook class, so the plugin still loads without BetterModel. - ?? Experimental and locked by default: while experimental-modules: false in config.yml, /pets modules is blocked and no external module activates. Set it to true to opt in. - ??? BetterModel animations are driven by player movement: idle when standing, walking (grounded) or flying when moving - chosen from the model's own animations - plus random idle2-9 variants. - ?? Disabling a model module now fully respawns pets, so models are removed and heads return with no leftovers.

Fixes

- ? Pet particle effects (dragon trail, unicorn glitter) now stop when the pet is hidden via the visibility toggle. - ??? /pets reload and /pets modules with tab-complete and help entries.

Note

- A backup branch 1.2.2 was created alongside main.

Install

1. Download better-pets-26.1.2-plugin.jar below into your Paper plugins folder. 2. (Optional) Install BetterModel 3.x and set experimental-modules: true for 3D models.

?? Better Pets Paper v1.2.1

Built for Minecraft / Paper 26.1.2, Java 21. Small follow-up fix.

Change

- ??? Owner-only glow reveal: Bat, Red Parrot, and Warden now show a real glow outline that is visible through walls, sent to the pet owner only (via a per-viewer entity-metadata packet). If the server internals are unavailable, it safely falls back to a normal shared glow, so the through-walls reveal always works.

Install

1. Download better-pets-26.1.2-plugin.jar below. 2. Drop it into your Paper server's plugins folder. 3. Start the server once to generate config and storage files.

?? Better Pets Paper v1.2.0

Built for Minecraft / Paper 26.1.2, Java 21. Multiplayer-focused fixes and polish.

Fixes & Improvements

- ??? Owner-only mob reveal: Bat, Red Parrot, and Warden now mark mobs with player-specific particles only the owner sees, instead of a glow visible to everyone. The reveal scan also runs less often for better performance. - ??? Herobrine personal weather: the eerie thunderstorm is now client-side for the owner only and no longer forces world-wide weather on other players. - ?? Allay no longer takes other players' items: it only collects natural drops and items you dropped yourself. - ?? Crash-safe join cleanup: leftover pet stat modifiers are stripped on join, so a player never keeps a pet stat without an active pet after an unclean shutdown. - ??? Wider loot support: pets can now roll in double chests and barrels too, in addition to single chests and other containers.

Install

1. Download better-pets-26.1.2-plugin.jar below. 2. Drop it into your Paper server's plugins folder. 3. Start the server once to generate config and storage files.

?? Better Pets Paper v1.1.0

Built for Minecraft / Paper 26.1.2, Java 21.

Highlights

- ?? Three new pets: Mole (mine dirt/sand/gravel without spending tool durability), Allay (vacuums nearby dropped items into your inventory), Cursed Plushie (distraction dummy that makes hostile mobs lose interest in you). - ?? Reworked Phoenix: revives you on a lethal hit like a Totem of Undying - works even if the server was idle/asleep - with a live cooldown shown in the pet menu. - ?? Continuous mob reveal: Bat, Red Parrot, and Warden keep every matching mob in range highlighted; Red Parrot now works on the surface only (not in caves). - ??? Custom structure loot: pets can roll in any generated container, including data-pack structures. - ?? Rarity broadcast sounds on discovery, up to a mighty sound for Extraordinary. - ?? Platypus fix: poisons melee and ranged attackers while wet, and withers poison-immune undead. - ? Particle trails while walking for dragons, faster dragon flight, higher mount seat. - ?? Pets can no longer be worn as a helmet. - ?? Back buttons across menus, English Back/Next pagination, and EXP: MAXED at level 100.

Install

1. Download better-pets-26.1.2-plugin.jar below. 2. Drop it into your Paper server's plugins folder. 3. Start the server once to generate config and storage files.

What's New in v1.2.6

🗝️ Vault & Trial Spawner sources: pets can now also drop from Vaults and Trial Spawners* — both vanilla and data-pack ones — added straight into their dispensed loot. 🌀 Ominous bonus: when the Vault/Trial Spawner is ominous* (any Ominous Bottle / Bad Omen level 1-5), a configurable ominous-bonus-percent is added on top of the base chance, so harder runs reward pets more often. * Broadcasts: Player found a … Pet in a Vault! / … in a Trial Spawner!. * Both new sources are fully configurable in /pets drop and config.yml, like every other source. 🪥 Fix: brushing now replaces the item inside* the suspicious sand/gravel, so the pet is brushed out of the block naturally instead of popping in above it. 📢 Fix: Trial Spawner pets now broadcast — since the dispense has no triggering player, the find message fires when the pet is picked up*.