🎒 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.

---

✨ Features

• 6 built-in backpack tiers — Worn Satchel → Leather → Iron → Gold → Diamond → Ender
• Unlimited custom backpack types — add any backpack via backpacks.yml or the in-game wizard
• Custom player head appearance per tier — no resource pack needed
• Equippable in the chestplate slot — grants armor points when worn; Shift+Right-click to equip/unequip
• Works in mainhand, offhand, and chestplate slot
• Auto-pickup toggle per backpack — items go directly into the bag
• Sort button inside the GUI — sorts contents alphabetically by item type
• Rename system — configurable XP cost, supports colour codes
• FancyNPCs merchant — buy and upgrade backpacks from in-world NPCs
• Per-backpack upgrade system — storage rows, auto-pickup unlock, and armor points — each with its own cost and multiplier
• Paginated GUI — up to 54 rows of storage across 9 pages
• Contents saved as NBT on the item itself — survives restarts, drops, and transfers
• Configurable death behavior: DROP, KEEP, or DELETE
• ItemsAdder 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 Vault + an economy plugin are installed
3. Restart the server — config.yml and backpacks.yml are generated automatically
4. Optionally install FancyNPCs 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 Buy 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:

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

• Paper 1.21.x (Spigot not supported) · Java 21+
• Vault + an economy plugin (EssentialsX, CMI, etc.)
• FancyNPCs 2.9+ (optional, for merchant NPCs)
• ItemsAdder 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