Backpackplugin

BackpackPlugin — Changelog

---

v1.0.0 — Initial Release

Backpacks

- 20 unique backpack tiers ranging from Tiny Pouch to the Chaos Backpack, each with distinct themes, storage sizes, and upgrade paths - Backpacks function as wearable chestplates — equip to wear, right-click to open - Paginated storage — large backpacks split across multiple pages, up to 5 rows per page - Storage upgrades — expand row count per backpack type, purchasable via the shop - Full PDC-based persistence — all data stored directly on the item, no database required; backpacks work across server restarts and in player inventories

Shop

- In-game shop with 4 tabs: Backpacks, Storage Upgrades, Armor Upgrades, Utilities - Auto-detects your backpack — upgrade tabs automatically detect the backpack in your main hand or chestplate slot; no manual selection needed - Confirmation screen before every purchase to prevent accidental buys - Fully Vault-compatible economy integration - Shop layout and prices fully configurable via shop.yml

Upgrades Screen

- Dedicated upgrades GUI accessible from inside the backpack - Shows Magnet, Filter, and navigation back to the backpack in one screen - All buttons work as separate clickable actions — fully Bedrock/Geyser friendly (no right-click/left-click distinction required)

Magnet

- Magnet upgrade automatically pulls nearby dropped items into your backpack - Configurable pickup radius per upgrade level - Respects the item filter — blocked items go to player inventory instead, no spam messages - Upgrade capped per backpack type; configurable in backpacks.yml

Item Filter

- Whitelist / Blacklist filter per backpack — control exactly what goes in - Browsable item picker GUI with all obtainable materials (~800+ items), paginated - Click to toggle items in/out of the filter list - Mode toggle button (whitelist blacklist) directly in the filter screen - Configurable max filter slots (default: 3) via config.yml - Command-only and unobtainable items (barriers, command blocks, spawners, etc.) are excluded from the picker for security - Filter blocks items from: manual placement, shift-click, and magnet pickup - Blocked items show an action bar notification only — no chat spam

Armor

- Backpacks provide armor points when worn as a chestplate - Armor value upgradeable via the Armor Upgrades shop tab - Applied directly to the player's armor attribute — fully Bedrock/Geyser compatible (no item attribute workarounds needed) - Armor is re-applied automatically on login

Anvil Integration

- Backpacks support renaming via anvil - Configurable use limit per backpack type; tracked via PDC

Crafting & Stonecutter

- Optional portable crafting table unlock per backpack type - Optional portable stonecutter unlock with configurable use limit - Both accessible directly from the backpack nav row

Sort System

- 6 sort modes: Name A→Z, Name Z→A, Quantity (most/least), Category, Rarity - Sort button shows Next: [mode] before sorting and Applied: [mode] after — no ambiguity - Sort state resets cleanly on backpack close and player disconnect

Sound System

- All sounds configurable in config.yml — enable/disable per sound, set volume and pitch - Custom resource pack sounds supported alongside vanilla sounds - Sounds for: open, close, sort, upgrade, purchase, filter blocked, and more

ItemsAdder Integration (Soft Dependency)

- Optional ItemsAdder support for custom item textures on backpack icons - Falls back gracefully to vanilla materials if ItemsAdder is not installed - Each backpack type supports an ia_item: field in backpacks.yml

Admin Commands

| Command | Description | |---------|-------------| | /backpack give <player> <type> | Give a backpack to a player | | /backpack inspect <player> | View a player's equipped backpack info | | /backpack list | List all registered backpack types | | /backpack reload | Reload config, shop, and backpack definitions | | /backpack help | Show all admin commands | | /bp | Open your own backpack | | /bpshop [tab] | Open the backpack shop |

Configuration

- backpacks.yml — define all backpack types, tiers, upgrade paths, armor values, and feature unlocks - config.yml — messages, sounds, magnet settings, filter cap - shop.yml — full shop layout, tab definitions, prices, display overrides - recipes.yml — craft recipes per backpack type

Compatibility

- Paper 1.21.x (tested on 1.21.8) - Bedrock / Geyser + ViaVersion fully supported — all GUIs use separate buttons, no action that requires right-click vs left-click distinction - Soft dependencies: Vault (economy), ItemsAdder (custom textures)