Enes Sell | Modern Sell Plugin v1.0

EnesSell — Advanced Sell GUI & Worth System (Paper / Folia / Purpur)
What is EnesSell?
EnesSell is a Paper-compatible (API 1.21+), Folia-supported, and Purpur-friendly Minecraft plugin that provides a complete item selling and price management system. Players sell items through an interactive GUI with category-based progression, multiplier levels, shulker box support, and a timed Sell Axe tool.
Who should download EnesSell?
• Server owners who want a Donut SMP–style sell GUI with levelling multipliers
• Staff who need per-category price control and sell-history tracking
• Anyone searching for: Minecraft sell plugin, GUI sell system, Paper 1.21 economy, Folia sell plugin, auto-worth lore, sell axe
Complete feature list
Commands
• /sell (/sellgui or up to 5 custom aliases) — Opens the sell GUI with category progress bars and shulker support.
• /sell help — Shows command usage (customisable in lang.yml via messages.command-usage and messages.command-usage-admin).
• /sell reload — Reloads all configs, prices, and language files.
• /sell reset <player> — Resets a player's sell data (total earned, items sold, category progress).
• /worth — Opens a paginated GUI showing all item prices with sort and filter options. Click any item to see its worth in the action bar (single or stack price depending on how many you carry).
• /sellaxe <player> <duration> — Gives a timed Sell Axe that sells container contents on right-click. Shows shulker-worth, shulker-empty, item-not-sellable, and no-sellable-items action bars during use. The receiver gets a notification.
• /worthtoggle — Toggles per-player worth lore display on inventory items.
• /sellhistory [player] — Shows total earned, items sold, and sell count.
• /setworth <price> [category] — Sets the sell price of the held item, optionally in a specific category. Detects if the material already has a price and shows "created" or "updated" accordingly.
Permissions
• sell.use — Use /sell command (default: all players).
• sell.reload — Reload the plugin (default: op).
• sell.sellaxe — Give Sell Axes to players (default: op).
• sell.setworth — Set item prices via /setworth (default: op).
• sell.history.other — View other players' sell history (default: op).
• sell.reset — Reset player data via /sell reset (default: op).
• sell.admin — All permissions combined.
Sell GUI system (gui/sell.gui.yml)
• 45-slot GUI with 9 category buttons (crops, ores, mobs, natural, tools, fish, books, potions, blocks).
• Each category shows current level, next multiplier, and progress toward next multiplier.
• Fully configurable GUI title, button names, materials, and lore.
• Shulker box support — place full shulkers in the GUI to sell their contents automatically. Shows action bar with shulker worth on close.
• Items without a price are returned to the player on GUI close with an "item-not-sellable" action bar; priced items are sold.
Progress GUI system (gui/progress.gui.yml)
• Opens when clicking a category button in the sell GUI — shows per-level progress for that category.
• Configurable GUI title per category material key (titles-progress-gui.*).
• Category icon (material, display name, lore) configurable via categories.*.icon.
• Pane display (incomplete/working/complete) fully customisable — material, displayname, lore with placeholders (%loading-bar%, %multiplier%, %progress%, %amount-have%, %amount-needed%).
• Back button with configurable material, displayname, lore, and enabled toggle.
• Click the category icon inside the progress GUI to instantly sell all matching items from your inventory.
Multiplier & levelling (level.yml)
• Per-category player levelling: the more you sell in a category, the higher your multiplier (22 levels per category).
• Category-specific progress tracked in SQLite (data.db).
• Configurable level thresholds and multiplier values.
Worth GUI (gui/worth.yml)
• Paginated 54-slot GUI showing all items with prices from prices/*.yml.
• Sort by price (highest/lowest) or name (A-Z/Z-A).
• Filter by category (blocks, ores, crops, fish, mobs, natural, tools, books, potions).
• Click any item to see its worth in the action bar — single item price if you have 1, stack price if you have multiple.
• Configurable navigation button names, materials, and lore.
• Refresh button and page navigation with sound effects.
Auto-Worth Lore
• Optional per-player toggle to display item prices directly in inventory item lore.
• Configurable format via config.yml (worth-lore.lore-format).
• Enabled by default for all players; toggle with /worthtoggle. Shows action bar confirmation.
• Shulker boxes display the total worth of all items inside them, recalculated every second.
Sell Axe system
• Timed tool (/sellaxe <player> <duration>) that sells container contents on right-click.
• Real-time remaining time displayed in item lore, updated every second.
• Auto-removes when expired with break sound and a "sellaxe-broken" message.
• Supports shulker boxes inside containers — sells their contents too.
• Duration format: 1w2d3h4m (weeks, days, hours, minutes).
• Configurable display name, lore, enchantments, glow, material, sound, and particles.
Price management (prices/*.yml)
• Separate YAML files for each category (blocks.yml, crops.yml, ores.yml, etc.).
• Auto-expands dyed variants (all 16 colours of wool, glass, concrete, etc.) from a single entry.
• Set prices in-game with /setworth <price> [category].
• Prices load from disk on every /sell reload.
Player data
• Total earned, items sold, sell count, and per-category items sold tracked in SQLite (data.db).
• Full history viewable via /sellhistory.
• Player data reset via /sell reset <player>.
• Data persists across restarts and reloads.
Economy system
• Configurable provider — built-in Vault support; extendable for custom economy plugins via economy.provider.
• Currency abbreviation system with customisable suffixes (K, M, B, T by default) — enable/disable in config.
• Configurable decimal format for currency display.
Action bar notifications (all customisable in lang.yml)
• Plugin reload confirmation.
• Sellable items missing warning.
• Item worth display when clicking items in the Worth GUI or scrolling items on your hotbar.
• Stack worth display (shows total for items you carry).
• Shulker box worth on sale (works both in the sell GUI and with Sell Axe).
• Shulker box empty notification.
• Item-not-sellable warning for unpriced items.
• No-item-in-hand warning for /setworth.
• Invalid price warning.
• Worth toggle on/off confirmation.
Messages & sounds (config.yml, lang.yml, sellaxe.yml)
• Fully customisable prefix system (enable/disable, custom text) for all plugin messages.
• Sell success notifications support chat messages, action bar, titles, and subtitles independently.
• Every action has configurable sounds (sell success, no items, reload, click, setworth).
• All messages customisable in lang.yml with & colour codes and hex (&#RRGGBB).
• Sell Axe display name, lore, enchantments, glow, material, sound, and particles all configurable.
Compatibility
• Declared api-version: '1.21' and folia-supported: true in plugin.yml.
• Uses Vault for economy integration (with extensible provider system).
• Fully functional on Paper, Folia, and Purpur servers.
Typical staff journey (in-game)
1. Staff runs /setworth 50 while holding a Diamond — diamond price is set to $50.
2. Staff runs /sellaxe Notch 7d — gives Notch a 7-day Sell Axe; both players receive confirmation messages.
3. A player runs /sell — the sell GUI opens, they drag items into the GUI and close it to sell. Action bars show shulker worth and non-sellable items.
4. The player runs /worth — a paginated GUI shows all item prices; clicking any item shows its worth in the action bar.
5. The player runs /worthtoggle — diamond prices now appear directly in their inventory item lore, with action bar confirmation.
6. After editing prices/ores.yml and the level thresholds in level.yml, staff runs /sell reload — everything reloads with action bar confirmation.
7. Staff runs /sell reset Notch — resets Notch's sell data and category progress.
Installation
1. Download the EnesSell jar and place it in the plugins folder.
2. Ensure Vault and an economy plugin (e.g. EssentialsX, CMI) are installed.
3. Start the server once to generate default configs under plugins/EnesSell/.
4. Edit prices/*.yml to set your item prices, and level.yml to configure multiplier thresholds.
5. (Optional) Customise gui/sell.gui.yml, gui/progress.gui.yml, and gui/worth.yml for your GUI layout.
6. Run /sell reload to apply changes without a full restart.
Configuration files
config.yml — Main plugin settings:
lang.yml — All messages, prefix, sell-success modules (chat/actionbar/title/subtitle), and action bar notifications.
sellaxe.yml — Sell Axe appearance: displayname, lore, enchantments, glow, material, sound, particles.
level.yml — Per-category multiplier thresholds: 22 levels per category (crops, ores, mobs, natural, tools, fish, books, potions, blocks).
gui/sell.gui.yml — Sell GUI title and 9 category button configuration (name, material, lore with placeholders).
gui/progress.gui.yml — Progress GUI: per-category titles, category icons, incomplete/working/complete pane styles, back button.
gui/worth.yml — Worth GUI: title, item display format, navigation buttons (previous/next/sort/refresh/filter).
prices/*.yml — Item prices per category. Format: prices.MATERIAL_NAME: value.