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)