Backpackplugin

🎒 BackpackPlugin

A fully configurable tiered backpack plugin for Paper 1.21 servers. Players can purchase and upgrade backpacks through 6 built-in tiers — each with a unique custom head appearance, auto-pickup, inventory sorting, NPC shop, and unlimited custom types via in-game commands. No resource pack required.

Discord

Modrinth

GitHub

---

✨ Features

- Full Bedrock support — Worn Satchel → Leather → Iron → Gold → Diamond → Ender - Full Bedrock support — add any backpack via `backpacks.yml` or the in-game wizard - Full Bedrock support — no resource pack needed - Full Bedrock support — grants armor points when worn; Shift+Right-click to equip/unequip - Works in Full Bedrock support - Full Bedrock support toggle per backpack — items go directly into the bag - Full Bedrock support inside the GUI — sorts contents alphabetically by item type - Full Bedrock support — configurable XP cost, supports colour codes - Full Bedrock support — buy and upgrade backpacks from in-world NPCs - Full Bedrock support — storage rows, auto-pickup unlock, and armor points — each with its own cost and multiplier - Full Bedrock support — up to 54 rows of storage across 9 pages - Contents saved as Full Bedrock support — survives restarts, drops, and transfers - Configurable Full Bedrock support: `DROP`, `KEEP`, or `DELETE` - Full Bedrock support — use any custom item as the backpack visual (falls back to skull if unavailable) - Full Bedrock support via Geyser — `/bp` opens your equipped backpack

---

🎒 Backpack Tiers

| Tier | Starting Rows | Max Rows | Shop Price | |---|---|---|---| | Worn Satchel | 1 | 3 | $500 | | Leather Backpack | 2 | 5 | $2,000 | | Iron Backpack | 3 | 8 | $5,000 | | Gold Backpack | 4 | 12 | $12,000 | | Diamond Backpack | 5 | 18 | $30,000 | | Ender Backpack | 6 | 24 | $75,000 |

> All tiers, prices, rows, and upgrade costs are fully configurable in `backpacks.yml`.

---

📦 Installation

1. Drop `BackpackPlugin.jar` into your server's `plugins/` folder 2. Ensure ItemsAdder + an economy plugin are installed 3. Restart the server — `config.yml` and `backpacks.yml` are generated automatically 4. Optionally install ItemsAdder for the merchant NPC and ItemsAdder for custom visuals 5. Run `/backpack reload` after any config changes

---

🎮 How to Use

Opening a Backpack

| Method | Java | Bedrock | |---|---|---| | Hold in mainhand | Right-click | Long-press | | Hold in offhand | Right-click | Long-press | | Worn in chest slot | `/bp` | `/bp` |

Equipping to Chest Slot

Hold the backpack in your mainhand, then Shift + Right-click to equip it to your chestplate slot. Shift + Right-click again to unequip.

Inside the GUI

| Button | Function | |---|---| | Sort | Sorts contents alphabetically | | Auto-Pickup | Toggles auto-pickup ON/OFF | | Rename | Rename your backpack (costs XP levels) | | Prev / Next | Navigate between storage pages |

---

🛒 NPC Shop

Spawn a merchant NPC anywhere with: ``` /backpack spawnnpc <n> ``` Players browse tiers in the Upgrade tab and upgrade their backpacks in the Upgrade tab. The shop auto-populates from `backpacks.yml` — no extra setup needed after adding new types.

---

➕ Adding Custom Backpacks

Option 1 — In-game wizard (recommended): ``` /backpack create mythic_backpack ``` Answer 9 prompts in chat (display name, skull texture, ItemsAdder ID, rows, armor, upgrade costs). Clickable `[Give to yourself]` and `[Edit fields]` buttons appear when done.

Option 2 — Edit `backpacks.yml` directly: ```yaml backpacks: mythic_backpack: display: "&d&lMythic Backpack" price: 150000.0 skull_texture: "eyJ..." # Base64 value from minecraft-heads.com itemsadder_id: "" # e.g. mynamespace:my_item — leave blank to use skull initial_rows: 6 max_rows: 36 armor_base: 5 upgrades: storage: enabled: true max_purchases: 30 rows_per_purchase: 1 base_cost: 20000.0 cost_multiplier: 1.6 autopickup: enabled: true cost: 40000.0 armor: enabled: true max_purchases: 8 points_per_purchase: 1 base_cost: 15000.0 cost_multiplier: 1.6 ``` Run `/backpack reload` — the new type instantly appears in the NPC shop.

---

💻 Commands

Permission: `backpack.admin` (OP by default)

| Command | Description | |---|---| | `/bp` | Open your equipped backpack | | `/backpack shop` | Open the NPC shop manually | | `/backpack give <player> <id>` | Give a backpack to a player | | `/backpack create <id>` | Start the in-game creation wizard | | `/backpack cancel` | Abort an active creation wizard | | `/backpack bpedit <id> <field> <value>` | Edit any field of a backpack type live | | `/backpack bpdelete <id>` | Delete a backpack type | | `/backpack list` | List all loaded backpack IDs | | `/backpack reload` | Reload config.yml and backpacks.yml | | `/backpack spawnnpc <n>` | Spawn a merchant NPC | | `/backpack removenpc <n>` | Remove a merchant NPC |

---

⚙️ Lore Placeholders

| Placeholder | Value | |---|---| | `{name}` | Custom name (or default if not renamed) | | `{type}` | Always the original type ID | | `{slots_used}` / `{slots_total}` | Storage fill | | `{rows}` | Current row count | | `{autopickup}` | On / Off | | `{level}` / `{max_level}` | Upgrade progress | | `{armor}` | Current armor points |

---

🔑 Permissions

| Permission | Default | Description | |---|---|---| | `backpack.use` | Everyone | Open and use backpacks | | `backpack.autopickup` | Everyone | Use auto-pickup feature | | `backpack.bypass.blacklist` | false | Bypass autopickup item blacklist | | `backpack.admin` | OP | All admin commands |

---

🔧 Requirements

- Geyser 1.21.x *(Spigot not supported)* · Java 21+ - Geyser + an economy plugin (EssentialsX, CMI, etc.) - Geyser 2.9+ *(optional, for merchant NPCs)* - Geyser 3.6+ *(optional, for custom item visuals)* - Geyser *(optional, for Bedrock support — works automatically)*

---

💬 Join our Discord for support, downloads, and updates 🔗 More plugins by Treamhiler 🐙 GitHub