Skip to main content

Buying

How to buy​

ActionWhat it does
Click a listingOpens the purchase screen. Click Confirm to buy, or Cancel to go back
Shift + left-click a listingQuick buy: buys immediately with no confirmation. Needs quick-buy.enabled and the sigmaorders.quickbuy permission, which only operators have until you grant it
Right-click a shulker listingShows a read-only preview of its contents (when shulker-preview is on)

Clicking one of your own listings opens the remove screen instead (details). Buying your own listing is only possible with allow-buy-own: true.

The QuickBuy add-on adds a personal shop where each slot always buys the cheapest matching listing.

What is checked​

A purchase goes through these checks, in order. The first one that fails stops it and nothing is charged:

  1. The buyer is not in blacklist.players
  2. The listing is still there. If someone else bought it a moment earlier, the buyer is told it is gone
  3. The listing has not expired
  4. It is not the buyer's own listing (unless allow-buy-own is on)
  5. The buyer has enough money in the listing's currency
  6. The money is actually taken. If the economy refuses the payment, the purchase is cancelled and the listing goes back on sale

Only then does the buyer receive the item and the seller's earnings get recorded.

Two buyers, one listing​

Buying is atomic. If two players click Confirm at the same moment, exactly one of them gets the item; the other is told the listing is gone and is not charged.

Inventory space​

  • Quick buy checks for room first and refuses with "free up space" if the item will not fit
  • The normal purchase screen does not check first: whatever fits goes into the inventory and any extra is dropped at the buyer's feet

Currencies​

The buyer always pays in the currency the listing was created in. With multi-currency enabled, listings can be in different currencies, and a buyer needs enough of that particular one.

Listings from the server​

Listings created by the server (through the Random Auction add-on, or /auction admin sell) have no player seller. The money is removed from the economy, and no earnings are created.