Creating Listings

Creating a listing

With the GUI

1. Run /auction and click List Item
2. Click the item in your own inventory that you want to sell. It appears in the preview slot at the top; right-click the preview to take it back
3. Set the price with the -100 / -10 / -1 and +1 / +10 / +100 buttons (the step sizes are set in gui/auction-create.yml), or click the price display and type an exact amount in chat
4. If several currencies are enabled, click the currency button to cycle through them
5. Click Confirm

With a command

/auction sell <price>

Lists the item in your main hand. The price accepts k, m and b shorthand: 1500, 1.5k, 2m.

What you can list

• Any item, including custom items and items with special data. The whole item is saved, so the buyer receives it exactly as you listed it. If an item carries data that cannot be saved, the listing is refused before anything is charged, rather than listing a stripped copy
• Shulker boxes, when shulker-listing is on (the default). Buyers can right-click a shulker listing to preview its contents when shulker-preview is on
• Bundles are never listable

Items that are blocked

Rule	What it blocks	Configure in
Item blacklist	The materials and items you list	blacklist.items
Renamed items	Items with a custom display name, unless they match an exception	block-renamed-items, renamed-item-exceptions

Both rules use the same kind of entry:

Entry	Matches
DIAMOND_SWORD	That material
*_SPAWN_EGG, *_BANNER	Any material matching the pattern (* stands for any run of characters; case does not matter)
itemsadder:mypack:my_sword, mmoitems:SWORD:*, smartspawner:*	A custom item from a supported plugin, by its ID
nbt-key:smartspawner:entity_type	Any item that carries that persistent-data key

By default the blacklist covers command blocks, structure blocks, barriers, spawn eggs and similar unobtainable or admin-only items.

Renamed items. Most custom items carry a display name, so with block-renamed-items: true (the default) they are refused. Allow specific ones without turning the rule off by adding exceptions:

block-renamed-items: true
renamed-item-exceptions:
  - "*_BANNER"                              # players rename banners for designs
  - "nbt-key:smartspawner:entity_type"      # allow SmartSpawner items
  - "itemsadder:mypack:*"                   # allow a whole ItemsAdder pack

Set block-renamed-items: false to allow every renamed item.

Rules that can stop a listing

Check	Details
Permission	sigmaorders.auction.sell (default: everyone)
Blacklisted player	Players in blacklist.players (by UUID or name) cannot create listings
Game mode	Players in a mode listed in auction-restrictions.disabled-gamemodes cannot create listings
World	auction-restrictions.disabled-worlds stops the auction from opening there. Players with sigmaorders.auction.bypass-world skip it
Item rules	The blacklist and renamed-item rules above
Price	Between min-price and max-price (per-rank overrides)
Listing limit	max-listings-per-player (details below)
Cooldown	creation-cooldown seconds between listings
Tax	You must be able to pay the listing fee

Duration

A listing lasts listing-duration minutes (default 10080, which is 7 days). Give ranks a longer time with listing-duration-overrides; the longest time a player qualifies for wins.

The end time is fixed when the listing is created, so changing the setting later does not affect listings that already exist.

Listing limit

max-listings-per-player (default 10) is how many listings a player can have at once. Use -1 for unlimited, or give a player the sigmaorders.auction.unlimited permission.

• max-listings-overrides: per-permission limits; the highest matching one wins
• min-listings-per-player and min-listings-overrides: a guaranteed minimum for a rank. If it is higher than the resolved maximum, the minimum wins

Expired listings count until they are collected

A listing counts toward the limit until its item has been collected. With automatic return on, an online owner gets it back within about a minute, and an offline owner when they join.

Cooldown

creation-cooldown (default 5 seconds) is the wait between two listings. cooldown-overrides sets it per permission, and the lowest matching value wins. sigmaorders.auction.bypass-cooldown removes it entirely.

Tax

Tax is charged once, as a fee when you create the listing. Nothing is deducted when the item sells, so the seller receives the full price.

• The fee is tax-percentage of the price, taken from your balance the moment the listing is created, and rounded up to a whole unit of the currency
• If you cannot pay it, the listing is not created
• The fee is not refunded if the listing is removed, expires, or never sells

For example, at the default 5% a listing priced at 1000 costs 50 to create. If it sells, the seller receives the full 1000.

• tax-percentage sets the default (5.0). Set 0 for no tax
• tax-overrides gives ranks their own rate; the lowest matching rate wins
• sigmaorders.auction.bypass-tax removes the tax entirely

Admin listings created with /auction admin sell are never taxed.

Announcements

When announcements-enabled is on, a new listing is announced in chat to players who have sigmaorders.auction.announce (default: everyone). Each player can mute them with /auction toggleannouncement.