# ✦ Probably Backpacks ✦ ### Tiered Backpack System with Upgrades for Spigot & Paper [![Version](https://img.shields.io/badge/version-2.4-blueviolet?style=for-the-badge)](https://modrinth.com/plugin/probablybackpacks) [![Minecraft](https://img.shields.io/badge/minecraft-1.14%20—%201.21+-green?style=for-the-badge&logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHZpZXdCb3g9IjAgMCAyNCAyNCI+PHBhdGggZmlsbD0id2hpdGUiIGQ9Ik0xMiAyQzYuNSAyIDIgNi41IDIgMTJzNC41IDEwIDEwIDEwIDEwLTQuNSAxMC0xMFMxNy41IDIgMTIgMnoiLz48L3N2Zz4=)](https://www.spigotmc.org/) [![Discord](https://img.shields.io/discord/1456137607569346739?label=Discord&style=for-the-badge&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/r5YXqgrGya) [![bStats](https://img.shields.io/badge/bStats-live-blue?style=for-the-badge)](https://bstats.org/plugin/bukkit/Probably%20Backpacks/29881) [![Ko-fi](https://img.shields.io/badge/Ko--fi-Support%20Me-FF5E5B?style=for-the-badge&logo=ko-fi&logoColor=white)](https://ko-fi.com/brothergaming52) **Leather · Copper · Iron · Gold · Diamond · Netherite**
Custom Textures · Upgradeable · 3D Models · CuriosPaper Addon Probably Backpacks Banner

--- *Think of it as **Sophisticated Backpacks** — but for Paper & Spigot, with 3D models, rich upgrades, and a seamless accessory integration.*

--- > # CAUTION > ### ⚠️ NO NEW CONTENT UPDATES FOR THIS VERSION > This standard version of **Probably Backpacks** is feature-locked and will **NOT receive any new content updates or features**. It will only receive maintenance updates to maintain compatibility with newer Minecraft/Paper releases. > > ⚜️ **Want new features, security, party storage, and advanced upgrades?** > Upgrade to **[Probably Backpacks Premium on BuiltByBit](https://builtbybit.com/resources/probablybackpacks.109745/)** to get access to: > - 🔑 **PIN-Pad Security Locks** — Prevent pickpocketing with a 4-digit code GUI > - 👥 **Synchronized Party Storage** — Link backpacks across teammates in real-time > - 🍳 **Smart Auto Smelter** — Intelligently route items to furnace/smoker/blast modules > - 🧪 **XP Sponge & Auto Repair** — Absorb XP orbs and auto-repair durability > - 🛢️ **Fluid Tank Upgrade** — Store up to 10 buckets of fluid > - ⚡ **Auto Sort Upgrade** & 🛡️ **Whitelist Filters** > - 🕵️ **Stealth Pickpocketing** & 🎨 **Custom 3D Cosmetic Skins** > > 👉 **[Click here to get Probably Backpacks Premium on BuiltByBit!](https://builtbybit.com/resources/probablybackpacks.109745/)** --- ## ✦ What is Probably Backpacks? ✦ Probably Backpacks adds a complete **tiered backpack system** to your Minecraft server. Players craft backpacks from Leather all the way up to Netherite — each tier offering **more storage** and **more upgrade slots**. Backpacks are equipped in the CuriosPaper **Back slot** and are visible on the player's back as a 3D model! This plugin is a **CuriosPaper addon**, hooking into the accessory system to provide a seamless experience with custom textures, real-time dyeing, and a powerful upgrade system. > This plugin requires **[CuriosPaper](https://modrinth.com/plugin/curiospaper)** to function! --- ## 🚀 What's New in v2.4 - 📥 **Autonomous Pickup Task (`PickupTask`):** Dedicated background task for the Pickup Upgrade that checks a 1.5-block radius around players to collect nearby item drops directly into active backpack storage (smartly skips duplicate work if MagnetTask is active). - 🛠️ **Modern Paper & 1.21.4+ Version Parsing:** Overhauled `VersionUtil` with regex matching to support Paper build version strings (e.g., `26.2.build.48-alpha`) with automatic fallback to `Bukkit.getVersion()`. - 🔒 **Robust Item & Component Sanitization:** Added multi-layered fallback deserialization in `BackpackData` to strip unregistered/legacy enchantments and invalid item components cleanly. - ⚙️ **GUI Slot Bounds Protection:** Added slot boundary safety checks during inventory click processing. --- ## ✦ Features ✦ ### 🎒 Core Backpack System | | Feature | Description | |:---:|---|---| | 🎒 | **6 Backpack Tiers** | Leather → Copper → Iron → Gold → Diamond → Netherite | | 📦 | **27 to 120 Slots** | Scale from a small pouch to a massive storage vault | | ⬆️ | **19+ Upgrades** | Crafting, Magnet, Cooking, Anvil, Jukebox, Tool Swapper & more | | 🎨 | **Real-time Dyeing** | Over 16 colors with live 3D model updates | | 🧟 | **Mob Drops** | Mobs can spawn wearing backpacks — loot them for extra storage | | 👀 | **3D Models** | Visible on the player's back with auto-hide when looking down | | 🔑 | **Hotkey Support** | Open your backpack with a double-sneak combo — no commands needed | | 🗄️ | **Massive Stacks** | Stack items up to 1024 with Netherite Stack Upgrades | --- ## ✦ Backpack Tiers ✦ | Tier | Slots | Upgrade Slots | Key Material | |:---|:---:|:---:|:---| | 🟤 **Leather Backpack** | 27 | 1 | Leather + String + Chest | | 🟠 **Copper Backpack** | 45 | 2 | Copper Ingots + Leather Backpack | | ⚪ **Iron Backpack** | 54 | 3 | Iron Ingots + Copper Backpack | | 🟡 **Gold Backpack** | 81 | 4 | Gold Ingots + Iron Backpack | | 🔵 **Diamond Backpack** | 108 | 5 | Diamonds + Gold Backpack | | 🟣 **Netherite Backpack** | 120 | 6 | Smithing Table + Netherite Ingot | *Each tier requires the **previous backpack** as an ingredient — creating a natural progression chain!* --- ## ✦ Upgrades ✦ Upgrades are placed into the backpack's **upgrade slots** to grant powerful abilities: ### 🛠️ Utility Upgrades | Upgrade | Effect | |:---|:---| | 🔧 **Crafting Station** | Open a portable crafting table from within your backpack | | 🔨 **Anvil Upgrade** | Portable anvil for repairing items on the go | | 🎵 **Jukebox Upgrade** | Play music discs directly from your backpack | | 🛠️ **Smithing Upgrade** | Portable smithing table for gear progression | | ⚔️ **Tool Swapper** | Automatically swaps to the best tool for the block you're mining | ### 🧺 Automation Upgrades | Upgrade | Effect | |:---|:---| | 📥 **Pickup Upgrade** | Dedicated background task (`PickupTask`) that collects dropped items within a 1.5-block radius into your backpack | | 🧲 **Magnet Upgrade** | Pull nearby items directly into your backpack | | 🍖 **Feeding Upgrade** | Auto-feed the player using food stored in the backpack | | 🔄 **Refill Upgrade** | Auto-refill hotbar items from the backpack as they are used | | 📦 **Compacting Upgrade** | Automatically compress items into blocks (e.g. Iron Ingots → Iron Block) | ### 🍳 Cooking Upgrades | Upgrade | Effect | |:---|:---| | 🔥 **Smelting Upgrade** | Portable furnace that smelts items while you walk | | 💨 **Blasting Upgrade** | High-speed smelting for ores | | 🍖 **Smoker Upgrade** | Rapid cooking for food items | ### 🗄️ Storage Upgrades | Upgrade | Effect | |:---|:---| | 🛠️ **Upgrade Base** | The fundamental component used to craft all other upgrades | | 🟠 **Copper Stack** | Increases max stack size of items in the backpack to 96 | | ⚪ **Iron Stack** | Increases max stack size of items in the backpack to 128 | | 🟡 **Gold Stack** | Increases max stack size of items in the backpack to 256 | | 🔵 **Diamond Stack** | Increases max stack size of items in the backpack to 512 | | 🟣 **Netherite Stack** | Increases max stack size of items in the backpack to 1024 | Backpack Storage Upgrades

--- ## ✦ Dyeing & Mobs ✦ ### 🎨 Dyeing System Express yourself with over **16 unique colors**! Leather backpacks can be dyed directly within the backpack inventory. - **Simple Dyeing**: No complex GUIs! Simply **drop any Minecraft dye** onto the dye button in the backpack interface. - **Remove Color**: Use a **Water Bucket** on the dye button to clear the color. - **Live Updates**: The 3D model on your back updates instantly when you change the color. Backpack Dyeing System

### 🧟 Mob Drops Backpacks aren't just for players anymore! Zombies and Skeletons have a small chance to spawn wearing a backpack. - **Visual Models**: You can see exactly which tier of backpack a mob is wearing. - **Lootable**: Defeat the mob for a chance to collect their backpack! - **Configurable**: Adjust spawn rates and which tiers mobs can carry in the `config.yml`. --- ## ✦ Recipes ✦

🎒 Backpack Recipes (click to expand)

### 🟣 Netherite Backpack **Slots:** 120 · **Upgrade Slots:** 6 The ultimate backpack. Features fire and lava immunity (won't burn when dropped). Crafted at a **Smithing Table** using the Netherite Upgrade template. | Component | Item | |:---|:---| | **Template** | Netherite Upgrade Smithing Template | | **Base** | 🔵 Diamond Backpack | | **Addition** | Netherite Ingot |

---

⬆️ Upgrade Recipes (click to expand)

--- ## ✦ Stats & Support ✦

### Join the Discord! [![Discord](https://img.shields.io/discord/1456137607569346739?label=Discord&style=for-the-badge&logo=discord&logoColor=white&color=5865F2)](https://discord.gg/r5YXqgrGya) **[discord.gg/r5YXqgrGya](https://discord.gg/r5YXqgrGya)** Get help · Report bugs · Suggest features · Stay updated

--- ## ✦ Geyser & Bedrock Edition Support ✦ Probably Backpacks provides full GUI slot icon and backpack 3D model support for Bedrock Edition players joining via GeyserMC. - **Automatic Setup:** If Geyser is running on the same server, Probably Backpacks will automatically detect Geyser's folder on startup, extract the mappings and resource pack, and copy them directly to Geyser's `packs/` and `custom_mappings/` folders. - **Manual Setup (Proxy/Separate Server):** If Geyser is hosted on a separate proxy (e.g. Velocity/BungeeCord) or automatic setup is skipped: 1. Retrieve the files from your server's `plugins/ProbablyBackpacks/geyser/` directory (extracted on startup). 2. Copy `ProbablyBackpack_Geyser.zip` into your Geyser `packs/` folder. 3. Copy `ProbablyBackpacks_mappings.json` into your Geyser `custom_mappings/` folder. 4. Ensure `enable-custom-content` is set to `true` in Geyser's `config.yml` and restart Geyser. --- ## ✦ Quick Start ✦ 1. Download **CuriosPaper.jar** and **ProbablyBackpacks.jar** 2. Drop both into your server's `plugins/` folder 3. Restart the server 4. Craft a **Leather Backpack** and equip it in the CuriosPaper **Back slot** 5. Use the **Double-Sneak hotkey** — you're all set! ---

**Made with ❤️ by Brothergaming52** [Discord](https://discord.gg/r5YXqgrGya) · [Ko-fi](https://ko-fi.com/brothergaming52) · [bStats](https://bstats.org/plugin/bukkit/ProbablyBackpacks/29881) · [CuriosPaper](https://modrinth.com/plugin/curiospaper)