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.

✨ 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

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

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

🛒 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)

⚙️ Lore Placeholders

🔑 Permissions

🔧 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