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

# BackpackPlugin — Changelog ## v4.0.0 ### New Features - **`backpacks.yml`** — all backpack type definitions moved to a dedicated file, separate from `config.yml`. Hot-reloads independently - **In-game creation wizard** — `/backpack create <id>` starts a 9-step chat wizard. Prompts for display name, skull texture, ItemsAdder ID, initial rows, max rows, armor base, storage cost, and autopickup cost. Shows clickable `[Give to yourself]` and `[Edit fields]` buttons on completion - **`/backpack bpedit <id> <field> <value>`** — edit any field of any backpack type live without touching files. Tab-completes all field names including `price` - **`/backpack bpdelete <id>`** — delete a backpack type by ID - **`/backpack cancel`** — abort an active creation wizard - Added `{type}` lore placeholder — always shows the original backpack type name regardless of rename - Added Ender Backpack tier (6 initial rows, 24 max rows, $75,000) ### Changes - `backpacks:` section removed from `config.yml` — must be migrated to `backpacks.yml` on existing installs - `price` field is now stored and editable per backpack in `backpacks.yml` ### Migration from v3 1. Copy the `backpacks:` section from your `config.yml` into a new `backpacks.yml` 2. Delete the `backpacks:` section from `config.yml` 3. Run `/backpack reload` Existing player backpack contents are unaffected. --- ## v3.0.0 - ItemsAdder support — set `itemsadder_id` on any backpack type to use a custom item as the visual - FancyNPCs merchant NPC — `/backpack spawnnpc <name>` and `/backpack removenpc <name>` - NPC shop with Buy and Upgrade tabs — auto-populates from config - Paginated storage GUI — up to 54 rows across 9 pages - Sort button — sorts backpack contents alphabetically by item type - Rename system — configurable XP cost, supports colour codes - Death behavior config — `DROP`, `KEEP`, or `DELETE` - Full Bedrock support via Geyser — `/bp` command --- ## v2.0.0 - Armor upgrade system — earn armor points by upgrading - Auto-pickup upgrade — unlockable per backpack - Storage upgrade system — purchase additional rows up to the tier cap - Equippable in chestplate slot — Shift+Right-click to equip/unequip - Works in mainhand, offhand, and chestplate slot - Contents stored as NBT on the item itself --- ## v1.0.0 - Initial release — tiered backpack system with custom heads, GUI, and Vault economy integration