Skip to main content

SellGui Addon - Overview

The SellGui Addon is a bulk-sell companion for Sigma Orders & Auctions. Players open a chest GUI, drag in everything they want to sell, and press one button: the addon matches every deposited item against the active orders on the server and delivers to the best ones automatically — no opening orders one by one.

What It Does​

/sell opens a 54-slot GUI with a 45-slot deposit area. When the player presses SELL, the addon takes the deposited items out of the GUI, fetches the active orders, matches each stack against them, and delivers through the core plugin's own delivery path — the same one a manual delivery uses, with the same validation, escrow payout, and notifications. Whatever could not be sold is handed back, and the player gets a summary of what was sold, how many orders were filled, what was returned, and how much they earned.

Key Features​

Bulk Deposit GUI​

  • 45 free deposit slots (rows 1-5) — drag stacks in, or shift-click them from your inventory
  • RETURN ALL button takes everything back, unsold
  • SELL button delivers everything at once
  • Control row buttons cannot be moved or dragged into

Smart Order Matching​

  • Every deposited stack is matched against all active orders that accept that item
  • One stack can be split across several orders until it is used up
  • Choose how orders are picked with match-strategy: BEST_PRICE (default), FIFO, or ANY
  • A player's own orders are never auto-filled

Sale Summary With Earnings​

  • After every sale: items sold, orders filled, items returned, and the amount earned per currency
  • Amount earned is the sum of delivered items x order price per item, which is exactly what the core pays out

Nothing Is Lost​

  • Unsold items are returned to the player's inventory; overflow is dropped at their feet
  • Closing the GUI, disconnecting, or the plugin being disabled or reloaded hands back any items still in the deposit area
  • A per-player lock prevents a second click, or a close, from touching the deposit area while a sale is being processed

Same Rules As Manual Delivery​

  • Requires the core sigmaorders.fulfill permission in addition to sellgui.use
  • Alt-account protection, the delivery blacklist, and cancelled/completed/expired order checks all still apply, because every delivery goes through the core

Configurable​

  • Every GUI title, button name and lore line, and chat message lives in config.yml — fully translatable
  • Extra command aliases can be added in config without a rebuild
  • One config switch turns the feature on or off

Folia-Safe​

  • Uses the region scheduler and the player's entity scheduler for world and inventory work; database work runs through the core plugin's async pipeline

How It Works​

  1. The player runs /sell (or /sellgui)
  2. They drag or shift-click items into the top five rows
  3. They click the emerald SELL button (bottom-right)
  4. The addon removes the items from the GUI immediately, then matches and delivers them stack by stack
  5. Unsold items come back, and a summary is sent in chat
Selling is immediate

There is no confirmation step. Once SELL is pressed, matching orders are filled and paid right away — it cannot be undone. Use RETURN ALL to take items back before selling.

Requirements​

RequirementDetails
Sigma Orders & AuctionsRequired — the addon will not enable without SigmaOrders-Auction, and its Orders module must be enabled
Java21+
Paper / Folia1.21+

Next Steps​