SupperBackpack

[2.1.0] - 2026-02-05

🛒 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
• 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

---

💰 Compatible Economy Plugins

SupperBackpack works with any Vault-compatible economy plugin. Here are the tested and supported options:

Plugin	Type	Notes
EssentialsX	Free	Most popular, highly recommended
CMI	Premium	Feature-rich server management suite
TheNewEconomy	Free	Lightweight, multi-currency support
XConomy	Free	Multi-currency, MySQL support
iConomy	Free	Classic economy plugin
Reserve	Free	Lightweight alternative

⚠️ Important: Vault alone does NOT provide economy! You must install one of the above plugins alongside Vault.

---

📜 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!"

# 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

---

� 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

---

📋 Requirements

Requirement	Status	Description
Vault	Required	API bridge for economy integration
Economy Plugin	Required	EssentialsX, CMI, or any Vault-compatible plugin
Java 21	Required	Minimum Java version
Paper/Spigot 1.21+	Required	Server software

---

📋 Startup Messages

Success:

[SupperBackpack] Successfully hooked into Vault economy: Essentials Economy

Vault installed but no economy plugin:

[SupperBackpack] Vault found but no economy plugin is installed. Sell feature will be disabled.

Vault not installed:

[SupperBackpack] Vault not found. Sell feature will be disabled.

---

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

---

🔄 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