BetterPets-Paper

# 🐾 Better Pets Paper <!-- ai-disclaimer --> > ⚠️ **Disclaimer:** This project — its code and its project artwork — was created with the help of AI. The plugin itself is tested by real people, and bugs and issues are actively fixed. > A full **Paper plugin rewrite** of the original Better Pets datapack. !(https://img.shields.io/badge/Minecraft%20%2F%20Paper-26.2-brightgreen) !(https://img.shields.io/badge/Java-21-orange) !(https://img.shields.io/badge/Platform-Paper-blue) !(https://img.shields.io/badge/Version-1.9.3-blueviolet) !(https://img.shields.io/badge/Type-Plugin%20Rewrite-purple) !(https://img.shields.io/badge/License-MIT-green) !(https://img.shields.io/badge/Languages-EN%20%2F%20DE%20%2F%20PL-yellow) --- ## ✨ About **Better Pets Paper** is a complete **Paper plugin rewrite** of the Better Pets datapack. It does **not** require datapacks, command functions, minecart menus, or a manual resource pack. Everything is handled directly through the plugin. Optional animated 3D models are handled through **BetterModel** when that plugin is installed and the (experimental) module is enabled. --- ## 🆕 What's New in v1.9.3 * 🐉 **Flying is less fiddly.** Right-clicking your pet **while flying no longer dismounts you** — hop off by **sneaking** instead. And 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 from chat, without opening the menu. --- ## 🆕 What's New in v1.9.2 * 🕊️ **No more flight height cap.** Pet mounts could only reach 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). --- ## 🆕 What's New in v1.9.1 * 🐉 **Fix: flying pets no longer clip you into blocks.** The mount's collision now samples your whole body (not just the centre), and while flying you can never take **suffocation** damage from briefly touching a block. * 🚫 **Pets no longer get in your way.** Pet hitboxes are now non-attackable and, for pets without a right-click action, tiny — so they never block your mining, attacking, or building. Pets that *do* use right-click (the **Alpaca** and the flyable dragons/Phoenix) keep a clickable hitbox; hide any pet with the visibility toggle in `/pets` if it's ever in the way. --- ## 🆕 What's New in v1.9.0 ### ⬆️ Minecraft / Paper 26.2 * The plugin now targets **Paper 26.2** (`api-version: '26.2'`), built against `paper-api 26.2.build.62-beta` and **Adventure 5.2.0**. * No gameplay changes — the entire codebase compiled against 26.2 **without a single source change**; only the build and API target moved. * `build.ps1` now downloads the Paper API and the matching Adventure 5.x jars itself, and orders the classpath so newer Adventure wins over older server libraries. > ⚠️ **Note:** Paper 26.2 is currently an **experimental/beta** branch (26.1.2 is the stable one). Because `api-version` is now `26.2`, this build requires a 26.2 server — if you are still on 26.1.2, stay on **v1.8.1**. --- ## 🆕 What's New in v1.8.1 * 🎰 **Fix:** the slot machine's **featured pet no longer re-rolls every time you open** `/pets slots`. It now stays the same until you actually spin, and is remembered per player. --- ## 🆕 What's New in v1.8.0 ### 🎰 Slot machine, expanded * **Way more loot** in the reels: gold nuggets, coal, iron, copper, redstone, lapis, gold ingots, XP bottles, emeralds, diamonds, netherite scrap & ingots — each with its own chance (netherite stays rare). * **Real slot feel:** the three reels now settle **left → middle → right**. * **A featured pet every spin** is shown above the reels — land on the pet symbol to win *that* pet, with a chat message and an optional server-wide jackpot broadcast. The pet chance was bumped up a little (still rare). * **Spinning now costs just 1 token.** * **Admin loot editor:** a **Configure Loot** button inside `/pets slots` opens a GUI to adjust every reward's chance live (left/right-click ±1, shift ±10, shows the %). Everything is also under `tokens:` in `config.yml`. ### 🎟️ Token commands * `/pets tokens pass <player> <amount>` — send some of **your** tokens to another player (anyone can use it). * `/pets tokens give|remove <player|all> <amount>` — admins hand out or take back tokens (works from console too). --- ## 🆕 What's New in v1.7.0 ### 🎟️ Pet tokens & 🎰 the slot machine * **Duplicate pets are no longer dead weight.** Turn any pet item into **pet tokens** with **`/pets scrap`** (the item in your hand) or **`/pets scrap all`** (every pet item in your inventory). Check your balance with **`/pets tokens`**. * Tokens by rarity: **Common 1 · Rare 2 · Epic 3 · Legendary 4 · Mythical 5** (all configurable). * **`/pets slots`** opens an animated **slot machine**: spend tokens per spi