EssentialsC / Sell Commands

Sell Commands

Sell items from your inventory for money using the sell GUI, quicksell, or check item worth.

Overview

EssentialsC provides three ways to sell items for economy balance: a drag-and-drop sell GUI (/sell), an instant sell command (/quicksell), and a worth calculator (/worth). All three use the sell prices defined in your shop category files under the sell-price field.

Selling is controlled by the sell.enabled toggle in config.yml. When disabled, all three sell commands are blocked.

Sell GUI

Command Description
/sell Opens the sell GUI where you can drag items to sell them.

The sell GUI is a 54-slot inventory with dedicated input slots, border decoration, and confirm/cancel buttons.

How It Works

1

Open the GUI

Run /sell to open the sell inventory.

2

Place items

Drag or click items into the input slots (the inner 21 slots of the GUI). Items in border slots are not accepted.

3

Confirm the sale

Click the confirm button (Lime Dye) to sell all items at once. The total worth is displayed on the button's lore. Your balance is updated immediately.

4

Cancel (optional)

Click the cancel button (Red Dye) or close the inventory to return all items to your inventory.

If no sellable items are placed in the GUI, clicking confirm returns the items and plays an error sound. Only items with a sell-price greater than 0 in the shop configuration can be sold.

Quick Sell

Command Description
/quicksell Instantly sell the item in your main hand.
/quicksell inventory Instantly sell all sellable items in your inventory.

Quick sell bypasses the GUI entirely and sells items immediately. The item in your hand is removed and you receive the sell value directly. Using inventory scans all 36 main inventory slots and clears every sellable item.

Quick sell is useful for fast farming workflows where opening a GUI would slow you down. Pair it with /worth to check values before selling.

Worth

Command Description
/worth Show the shop sell value of the item in your hand.
/worth inventory Show the total sell value of all items in your inventory.

/worth calculates the total value without actually selling anything. It uses the same sell-price values from your shop category files. This is useful for checking how much you'd get before committing to a sale.

Configuration

Sell settings live under the sell section in config.yml.

Key Type Default Description
sell.enabled Boolean true Master toggle for /sell, /quicksell, and /worth.
sell.gui.title String "<#27C8F5>Sell Items<#27C8F5>" GUI title. Supports MiniMessage formatting.
sell.gui.size Integer 54 Inventory size. Must be a multiple of 9.
sell.gui.border-material String GRAY_STAINED_GLASS_PANE Material used for the GUI border slots.
sell.gui.sounds Boolean true Play sounds when opening, selling, and cancelling.
config.yml 
sell:
  enabled: true
  gui:
    title: "<#27C8F5>Sell Items<#27C8F5>"
    size: 54
    border-material: "GRAY_STAINED_GLASS_PANE"
    sounds: true

Sell prices are defined per-item in your shop category files using the sell-price field. Items with sellable: false or a sell-price of 0 cannot be sold.

shop/farming.yml 
items:
  wheat:
    material: WHEAT
    name: "<#F5C842>Wheat"
    buy-price: 2.5
    sell-price: 1.0       # Players earn $1 per wheat sold
    sellable: true

Permissions

Permission Description Default
essentialsc.sell Open the sell GUI with /sell. Everyone
essentialsc.quicksell.hand Quick-sell the item in hand with /quicksell. Everyone
essentialsc.quicksell.inventory Quick-sell entire inventory with /quicksell inventory. Operators
essentialsc.worth.hand Check worth of held item with /worth. Everyone
essentialsc.worth.inventory Check worth of entire inventory with /worth inventory. Operators