Auction House
The Auction House is the second marketplace in Sigma Orders & Auctions. A player lists an item at a fixed price for a limited time, and other players buy it instantly. It is separate from the Orders board, where players request items and others deliver them.
Turn it on or off with modules.auction in config.yml. Everything specific to it lives in config-auction.yml.
How a listing lives
list an item ──► live in the auction ──► sold ──► the seller claims the earnings
│
├──► expires ──► the item goes back to its owner
│
└──► the owner removes it ──► the item goes back to its owner
- A listing has one item stack, one price, one currency and an end time.
- While it is live it appears in the main auction for everyone. The moment it ends it disappears from the main auction and can no longer be bought.
- Items are never destroyed: an item that is not sold comes back to its owner, and money from a sale waits for the seller until it is claimed.
Key concepts
| Term | Meaning |
|---|---|
| Listing | An item for sale. Live until it is sold, removed, or its time runs out |
| Expired listing | A listing whose time ran out. Hidden from the main auction, shown only to its owner, and returned to them (details) |
| Unclaimed earnings | The money from a sale, waiting for the seller (details) |
| Tax | A fee, as a percentage of the price, charged once when a listing is created (details) |
| Currency | Vault money by default; other currencies when multi-currency is configured |
The screens
| Screen | How to open it | What it is for |
|---|---|---|
| Main auction | /auction | Browse, search and sort every live listing; click one to buy it |
| Create listing | The green List Item button, or /auction sell <price> | Choose an item, set a price, confirm |
| My Listings | The book button, or /auction listings | Your live listings, expired listings and sold items, in one place (details) |
| Purchase confirmation | Click a listing | Confirm or cancel a purchase |
| Remove confirmation | Click one of your own live listings | Confirm or keep |
Works on every client
Everything essential in the Auction House works with plain clicks, so Bedrock (touch and controller) players can list, buy, remove and collect. A few extras use right-click or shift-click on Java: the shulker contents preview, reversing the sort order, quick buy, and the instant-remove shortcut.
Files
| File | Contents |
|---|---|
config-auction.yml | All auction settings (reference) |
lang/auction/messages.yml | Every message and button text |
gui/auction.yml, gui/auction-create.yml | Slot positions and icons for the screens |
webhook-auction.yml | Discord embed templates |
Next steps
- Creating listings - rules, limits, duration and tax
- Buying - confirmation, quick buy and what can go wrong
- Selling and earnings - claiming money
- Expiry and collecting items - what happens when a listing ends
- My Listings - managing what you have
- Configuration - every option
- Commands and permissions