# \ud83c\udf92 BackpackPlugin
\nA fully configurable tiered backpack plugin for Paper 1.21 servers. Players can purchase and upgrade backpacks through **6 built-in tiers** \u2014 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.<\/p>\n
\n
\n<\/p>\n
—<\/p>\n
## \u2728 Features
\n– **6 built-in backpack tiers** \u2014 Worn Satchel \u2192 Leather \u2192 Iron \u2192 Gold \u2192 Diamond \u2192 Ender
\n– **Unlimited custom backpack types** \u2014 add any backpack via `backpacks.yml` or the in-game wizard
\n– **Custom player head appearance per tier** \u2014 no resource pack needed
\n– **Equippable in the chestplate slot** \u2014 grants armor points when worn; Shift+Right-click to equip\/unequip
\n– Works in **mainhand, offhand, and chestplate slot**
\n– **Auto-pickup** toggle per backpack \u2014 items go directly into the bag
\n– **Sort button** inside the GUI \u2014 sorts contents alphabetically by item type
\n– **Rename system** \u2014 configurable XP cost, supports colour codes
\n– **FancyNPCs merchant** \u2014 buy and upgrade backpacks from in-world NPCs
\n– **Per-backpack upgrade system** \u2014 storage rows, auto-pickup unlock, and armor points \u2014 each with its own cost and multiplier
\n– **Paginated GUI** \u2014 up to 54 rows of storage across 9 pages
\n– Contents saved as **NBT on the item itself** \u2014 survives restarts, drops, and transfers
\n– Configurable **death behavior**: `DROP`, `KEEP`, or `DELETE`
\n– **ItemsAdder support** \u2014 use any custom item as the backpack visual (falls back to skull if unavailable)
\n– **Full Bedrock support** via Geyser \u2014 `\/bp` opens your equipped backpack<\/p>\n
—<\/p>\n
## \ud83c\udf92 Backpack Tiers<\/p>\n
| Tier | Starting Rows | Max Rows | Shop Price |
\n|—|—|—|—|
\n| Worn Satchel | 1 | 3 | $500 |
\n| Leather Backpack | 2 | 5 | $2,000 |
\n| Iron Backpack | 3 | 8 | $5,000 |
\n| Gold Backpack | 4 | 12 | $12,000 |
\n| Diamond Backpack | 5 | 18 | $30,000 |
\n| Ender Backpack | 6 | 24 | $75,000 |<\/p>\n
> All tiers, prices, rows, and upgrade costs are fully configurable in `backpacks.yml`.<\/p>\n
—<\/p>\n
## \ud83d\udce6 Installation
\n1. Drop `BackpackPlugin.jar` into your server’s `plugins\/` folder
\n2. Ensure **Vault** + an economy plugin are installed
\n3. Restart the server \u2014 `config.yml` and `backpacks.yml` are generated automatically
\n4. Optionally install **FancyNPCs** for the merchant NPC and **ItemsAdder** for custom visuals
\n5. Run `\/backpack reload` after any config changes<\/p>\n
—<\/p>\n
## \ud83c\udfae How to Use<\/p>\n
### Opening a Backpack<\/p>\n
| Method | Java | Bedrock |
\n|—|—|—|
\n| Hold in mainhand | Right-click | Long-press |
\n| Hold in offhand | Right-click | Long-press |
\n| Worn in chest slot | `\/bp` | `\/bp` |<\/p>\n
### Equipping to Chest Slot
\nHold the backpack in your mainhand, then **Shift + Right-click** to equip it to your chestplate slot. **Shift + Right-click** again to unequip.<\/p>\n
### Inside the GUI<\/p>\n
| Button | Function |
\n|—|—|
\n| Sort | Sorts contents alphabetically |
\n| Auto-Pickup | Toggles auto-pickup ON\/OFF |
\n| Rename | Rename your backpack (costs XP levels) |
\n| Prev \/ Next | Navigate between storage pages |<\/p>\n
—<\/p>\n
## \ud83d\uded2 NPC Shop —<\/p>\n ## \u2795 Adding Custom Backpacks<\/p>\n **Option 1 \u2014 In-game wizard (recommended):** **Option 2 \u2014 Edit `backpacks.yml` directly:** —<\/p>\n ## \ud83d\udcbb Commands<\/p>\n Permission: `backpack.admin` (OP by default)<\/p>\n | Command | Description | —<\/p>\n ## \u2699\ufe0f Lore Placeholders<\/p>\n | Placeholder | Value | —<\/p>\n ## \ud83d\udd11 Permissions<\/p>\n | Permission | Default | Description | —<\/p>\n ## \ud83d\udd27 Requirements —<\/p>\n \ud83d\udcac **Join our Discord** for support, downloads, and updates A plugin that adds backpack using vanilla mechanics for bedrock support<\/p>\n","protected":false},"featured_media":0,"template":"","meta":{"_minecraft_slug":"backpackplugin","_minecraft_project_id":"o9M8SeTM","_minecraft_author":"Treamhiler","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":105,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"backpackplugin.zip","_minecraft_size_bytes":249596,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:36:01.425740Z","_minecraft_date_created":"2026-03-09T23:48:03.308483Z","_minecraft_date_modified":"2026-03-13T13:59:58.958300Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/backpackplugin","_minecraft_icon_attachment_id":0,"_minecraft_imported_at":"2026-06-01T08:43:38+00:00","_minecraft_import_hash":"6950a3ecbeca79052d310f4a2cfccd0b","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[127,129],"mod_loader":[132,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-24824","mod","type-mod","status-publish","hentry","mod_category-paper","mod_category-spigot","mod_loader-paper","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nSpawn a merchant NPC anywhere with:
\n“`
\n\/backpack spawnnpc
\n“`
\nPlayers browse tiers in the **Buy** tab and upgrade their backpacks in the **Upgrade** tab. The shop auto-populates from `backpacks.yml` \u2014 no extra setup needed after adding new types.<\/p>\n
\n“`
\n\/backpack create mythic_backpack
\n“`
\nAnswer 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.<\/p>\n
\n“`yaml
\nbackpacks:
\n mythic_backpack:
\n display: “&d&lMythic Backpack”
\n price: 150000.0
\n skull_texture: “eyJ…” # Base64 value from minecraft-heads.com
\n itemsadder_id: “” # e.g. mynamespace:my_item \u2014 leave blank to use skull
\n initial_rows: 6
\n max_rows: 36
\n armor_base: 5
\n upgrades:
\n storage:
\n enabled: true
\n max_purchases: 30
\n rows_per_purchase: 1
\n base_cost: 20000.0
\n cost_multiplier: 1.6
\n autopickup:
\n enabled: true
\n cost: 40000.0
\n armor:
\n enabled: true
\n max_purchases: 8
\n points_per_purchase: 1
\n base_cost: 15000.0
\n cost_multiplier: 1.6
\n“`
\nRun `\/backpack reload` \u2014 the new type instantly appears in the NPC shop.<\/p>\n
\n|—|—|
\n| `\/bp` | Open your equipped backpack |
\n| `\/backpack shop` | Open the NPC shop manually |
\n| `\/backpack give
\n| `\/backpack create
\n| `\/backpack cancel` | Abort an active creation wizard |
\n| `\/backpack bpedit
\n| `\/backpack bpdelete
\n| `\/backpack list` | List all loaded backpack IDs |
\n| `\/backpack reload` | Reload config.yml and backpacks.yml |
\n| `\/backpack spawnnpc
\n| `\/backpack removenpc
\n|—|—|
\n| `{name}` | Custom name (or default if not renamed) |
\n| `{type}` | Always the original type ID |
\n| `{slots_used}` \/ `{slots_total}` | Storage fill |
\n| `{rows}` | Current row count |
\n| `{autopickup}` | On \/ Off |
\n| `{level}` \/ `{max_level}` | Upgrade progress |
\n| `{armor}` | Current armor points |<\/p>\n
\n|—|—|—|
\n| `backpack.use` | Everyone | Open and use backpacks |
\n| `backpack.autopickup` | Everyone | Use auto-pickup feature |
\n| `backpack.bypass.blacklist` | false | Bypass autopickup item blacklist |
\n| `backpack.admin` | OP | All admin commands |<\/p>\n
\n– **Paper** 1.21.x *(Spigot not supported)* \u00b7 Java 21+
\n– **Vault** + an economy plugin (EssentialsX, CMI, etc.)
\n– **FancyNPCs** 2.9+ *(optional, for merchant NPCs)*
\n– **ItemsAdder** 3.6+ *(optional, for custom item visuals)*
\n– **Geyser** *(optional, for Bedrock support \u2014 works automatically)*<\/p>\n
\n\ud83d\udd17 **More plugins by Treamhiler**
\n\ud83d\udc19 **GitHub**<\/p>\n","protected":false},"excerpt":{"rendered":"