Sell GUI

The Sell GUI is the primary way players sell items in EasySell. This page explains how it works and how to customize it.

Overview

The Sell GUI is a chest-style inventory where players place items to sell them. When the inventory is closed, all items are automatically sold and money is deposited.

How to Use

Opening the GUI

Type /sell to open the sell interface.

Selling Items

1. Open - Type /sell

2. Add Items - Drag items from your inventory into the sell GUI

3. Close - Press ESC or click outside the GUI

4. Receive Money - Items are sold and payment is deposited

GUI Layout

+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |  Row 1
+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |  Row 2
+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |  Row 3
+---+---+---+---+---+---+---+---+---+
|   |   |   |   |   |   |   |   |   |  Row 4
+---+---+---+---+---+---+---+---+---+

• Size: 36 slots (4 rows of 9)

• All slots are available for selling items

• No decorative or locked slots

Customization

GUI Title

Configure the title in config.yml:

sell-gui:
  title: "Put items in here to sell them!"

Examples with colors:

sell-gui:
  title: "&6&lSell Shop"

sell-gui:
  title: "#7dfb03&lSELL &fYour Items"

Supported formats:

• Legacy colors: &c, &a, &6, etc.

• Formatting: &l (bold), &o (italic), &n (underline)

• Hex colors: #RRGGBB (e.g., #7dfb03)

Features

Automatic Price Calculation

• Each item's price is looked up in prices.yml

• Stack size is multiplied by per-item price

• Total of all items is calculated on close

Shulker Box Support

Shulker boxes receive special handling:

1. The shulker box itself has a base price

2. All items inside are calculated

3. Total worth = box price + contents worth

Example:

• Shulker Box: $75.00

• 64 Diamonds inside: $7,680.00

• Total: $7,755.00

Sound Effect

When items are sold, a sound plays:

# sounds.yml
successfully-sold: ENTITY_PLAYER_LEVELUP

Sold Message

After closing, players see:

• Title: The total amount earned (e.g., +$7,755)

• Subtitle: Optional item count and total (if enabled)

• Action Bar: Additional information

What Happens When You Close

1. Price Calculation - Each item's worth is calculated

2. Total Sum - All item values are added together

3. Money Deposit - Total is deposited via Vault

4. Messages - Configured messages are sent to player

5. Sound - Success sound plays

6. Items Removed - All items in the GUI are deleted

Items That Cannot Be Sold

• Items with a price of 0 in prices.yml

• Items not in prices.yml (if default-price is 0)

When unsellable items are detected, the configured "item-not-sellable" message is shown (if enabled).

Tips

Efficient Selling

1. Shift-Click - Quickly move stacks from inventory

2. Double-Click - Collect all matching items

3. Drag - Place items across multiple slots

Bulk Selling

• Fill shulker boxes with items before selling

• The entire contents will be valued automatically

Check Before Selling

• Use /worth while holding an item to verify its price

• Enable item-worth display to see prices in item lore

---