🎒 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

Drop BackpackPlugin.jar into your server's plugins/ folder
Ensure Vault + an economy plugin are installed
Restart the server — config.yml and backpacks.yml are generated automatically
Optionally install FancyNPCs for the merchant NPC and ItemsAdder for custom visuals
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

Backpackplugin

📖About Backpackplugin