ВЕРСИИ (41)

## Fix: Scrapped skins are reliably collected The unlock relied on a hidden variant tag on the item. Some items (older ones, or certain paths) carry the variant **head** but not the tag, so scrapping them collected nothing — which is why a skin sometimes did not show up in Customize. - Scrapping now **recovers the skin from the item's head texture** when the tag is missing, so any visibly-skinned pet item collects the right skin. - Scrapping a single pet now **always tells you the result**: *unlocked X* (new) or *you already own X*. (Console debug logs when an item has no resolvable skin.) - The **catalogue variant gallery** now marks which skins you have **✔ Collected** (with a glint) vs *Not collected yet* — per player, even for pets you do not own. Compiles clean on Paper 26.2; 63/63 tests pass. Drop `BetterPets-1.17.4.jar` into your `plugins/` folder.

## 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**.