📋 Changelog

All notable changes to SupperBackpack will be documented in this file.

---

[2.0.0] - 2026-02-02

🛒 NEW: Vault Shop System

A complete item selling system integrated with Vault economy! Players can now sell items directly from their backpack.

Features Overview

• Sell GUI - Beautiful 54-slot inventory GUI to sell backpack items
• Vault Integration - Works with any Vault-compatible economy plugin (EssentialsX, CMI, etc.)
• Configurable Prices - Set prices for every item in a dedicated config file
• Enable/Disable Toggle - Server admins can completely disable the shop feature
• Safe Fallback - If Vault is not installed, the feature gracefully disables without crashes

---

📜 New Commands

Command	Aliases	Permission	Description
/backpacksell	/bpsell, /bagsell	supperbackpack.sell	Opens the sell GUI

---

🔐 New Permissions

Permission	Default	Description
supperbackpack.sell	true	Allows selling items from the backpack

---

📁 New Configuration Files

shop.yml - Dedicated Shop Configuration

A brand new configuration file specifically for the shop system:

# Enable or disable the shop feature entirely
enabled: true

# Multiplier for "Sell All" button (1.0 = normal, 0.9 = 10% less, 1.1 = 10% bonus)
sell-all-multiplier: 1.0

# Custom messages
messages:
  shop-disabled: "&cThe shop feature is disabled on this server!"
  vault-not-available: "&cEconomy is not available!"
  sold-item: "&a✓ Sold &e{amount}x {item} &afor &6{price}&a!"
  sold-all: "&a✓ Sold &e{amount} items &afor &6{price}&a!"
  # ... and more

# Item prices (per single item)
sell-prices:
  DIAMOND: 100
  EMERALD: 75
  GOLD_INGOT: 15
  IRON_INGOT: 10
  # ... 100+ items pre-configured

---

🖥️ Sell GUI Features

The sell GUI provides a user-friendly interface:

• Size: 54 slots (6 rows)
• Display: Shows only sellable items from your backpack
• Price Info: Each item shows per-item price and stack value in lore
• Controls:
  • Left-click item: Sell that stack
  • Shift-click item: Sell ALL of that item type in backpack
  • Sell All button (Emerald Block): Sells all sellable items at once
  • Close button (Barrier): Closes the GUI
  • Info button (Book): Shows how to use the GUI

---

🔧 Technical Changes

New Files Created

• shop.yml - Dedicated shop configuration file
• ShopManager.java - Manages shop.yml loading and access
• VaultManager.java - Handles Vault economy integration
• SellGUI.java - Sell GUI creation and display
• BackpackSellCommand.java - /bpsell command handler
• SellGUIListener.java - Handles all click events in sell GUI

Modified Files

• SupperBackpack.java - Added ShopManager and VaultManager initialization
• config.yml - Removed shop settings (moved to shop.yml)
• plugin.yml - Added new command, permission, and Vault softdepend
• build.gradle - Added VaultAPI dependency from JitPack

Dependencies Added

• VaultAPI 1.7.1 (compileOnly - from JitPack)

---

💰 Pre-Configured Sell Prices

The plugin comes with 100+ items pre-configured with balanced sell prices:

Category	Examples
Ores & Minerals	Diamond (100), Emerald (75), Gold Ingot (15), Iron Ingot (10)
Raw Ores	Raw Gold (12), Raw Iron (8), Raw Copper (3)
Ore Blocks	Diamond Block (900), Emerald Block (675), Gold Block (135)
Building Materials	Oak Log (1), Stone (0.2), Cobblestone (0.1)
Food	Cooked Beef (3), Bread (2), Golden Apple (50)
Mob Drops	Ender Pearl (15), Blaze Rod (20), Ghast Tear (50)
Nether Items	Netherite Ingot (500), Ancient Debris (150)
Rare Items	Nether Star (1000), Dragon Egg (5000), Elytra (2000)
Dyes	All 16 dye colors (1-3 each)

---

🛡️ Security Features

• Exploit Prevention: All clicks in sell GUI are cancelled
• Drag Prevention: Item dragging is completely disabled in sell GUI
• Backpack-Only: Items are read/modified ONLY via BackpackManager
• No External Access: Other plugins cannot access backpack items
• Transaction Validation: Each sale is validated before money is deposited

---

📋 Startup Messages

The plugin now logs shop status on startup:

[SupperBackpack] Shop feature enabled with Vault economy.

Or if Vault is not found:

[SupperBackpack] Shop feature enabled but Vault not found. Shop commands will show error.

Or if disabled in config:

[SupperBackpack] Shop feature is disabled in shop.yml.

---

🔄 Upgrade Notes

• No migration needed - This is a feature addition, not a data change
• Vault optional - The plugin works fine without Vault; only the sell feature is disabled
• Config preserved - Your existing config.yml settings are not affected
• New config - shop.yml will be created automatically on first startup