Configuration

Every option below is in plugins/SigmaOrders/config-auction.yml unless noted. Player-visible text is in lang/auction/messages.yml, and the screens' slot positions and icons are in gui/auction.yml and gui/auction-create.yml.

Reloading

/auction reload (permission sigmaorders.admin) reloads the configuration and adds any settings that are new in your version. Command aliases are re-applied too, but a restart is the reliable way to fully drop an alias you removed.

Module and aliases

Setting	Default	Meaning
modules.auction in config.yml	true	Turns the whole Auction House on or off
command-aliases	auc, auctions, market	Extra aliases for /auction. /ah is built in. Removing an alias is only fully reliable after a restart

Listing slots, price and time

Where a setting has -overrides, each entry is a permission and a value. When a player matches several entries, the rule below decides which applies.

Setting	Default	Override key	Override rule
max-listings-per-player	10 (-1 = unlimited)	max-listings-overrides (limit)	Highest wins
min-listings-per-player	0	min-listings-overrides (limit)	Highest wins. A minimum above the maximum wins
listing-duration (minutes)	10080 (7 days)	listing-duration-overrides (minutes)	Longest wins
creation-cooldown (seconds)	5	cooldown-overrides (seconds)	Lowest wins
min-price	0.01	min-price-overrides (price)	Lowest wins
max-price	1000000.0	max-price-overrides (price)	Highest wins

auction:
  max-listings-per-player: 10
  max-listings-overrides:
    - permission: "sigmaorders.rank.vip"
      limit: 20
  listing-duration: 10080
  listing-duration-overrides:
    - permission: "sigmaorders.rank.vip"
      minutes: 20160        # 14 days

Permissions that skip a rule entirely: sigmaorders.auction.unlimited (listing limit), sigmaorders.auction.bypass-cooldown (cooldown), sigmaorders.auction.bypass-tax (tax).

Tax

Setting	Default	Meaning
tax-percentage	5.0	The tax rate. It is charged once, as a fee when a listing is created; nothing is deducted when it sells (how)
tax-overrides (percentage)	none	Per-permission rate. The lowest matching rate wins

Expiry, collecting and earnings

Setting	Default	Meaning
auto-return-expired	true	Return expired items to their owner automatically (details)
purge-after-days	0	Days to keep uncollected expired items and unclaimed earnings. 0 = forever
auto-claim-earnings	false	Pay sale earnings automatically instead of waiting for the seller to claim (details)
allow-buy-own	false	Let players buy their own listings
expire-duration (minutes)	1440	A fallback lifetime used only when a listing is created with no duration at all, which does not happen with the default listing-duration
announcements-enabled	true	Announce new listings in chat to players with sigmaorders.auction.announce
notify-on-join	true	Include sold items in the "while you were away" join message
notify-expired-on-join	true	Include expired listings in that message

Buying

quick-buy:
  enabled: true
  permission: "sigmaorders.quickbuy"

Players with the permission can Shift + left-click a listing to buy it without a confirmation screen. Nobody except operators has sigmaorders.quickbuy until you grant it.

World and game-mode restrictions

auction-restrictions:
  disabled-worlds: []
  disabled-gamemodes: []

Setting	Effect
disabled-worlds	The auction cannot be opened in these worlds. Players with sigmaorders.auction.bypass-world skip it
disabled-gamemodes	Players in these game modes cannot create listings (for example CREATIVE). They can still browse and buy

Blacklist

blacklist:
  enabled: true
  players: []          # UUIDs or names
  items:
    - COMMAND_BLOCK
    - "*_SPAWN_EGG"

Key	Meaning
enabled	Master switch for both lists
players	Players (UUID or name) who cannot create listings or buy. They can still collect, claim and remove what they already have
items	Items that cannot be listed. Entries can be materials, wildcards, custom item IDs, or nbt-key: entries (syntax)

Renamed items and shulker boxes

Setting	Default	Meaning
block-renamed-items	true	Refuse items with a custom display name
renamed-item-exceptions	*_BANNER	Items allowed even though renamed. Same entry syntax as the blacklist
shulker-listing	true	Allow shulker boxes to be listed
shulker-preview	true	Let buyers right-click a shulker listing to preview its contents

Sounds

gui:
  open-sound:
    enabled: false
    sound: BLOCK_CHEST_OPEN
    volume: 0.5
    pitch: 1.2
  click-sound:
    enabled: false
    sound: UI_BUTTON_CLICK
    volume: 0.3
    pitch: 1.0

The open sound plays when the main auction opens; the click sound plays on button clicks. Use sound names such as BLOCK_CHEST_OPEN.

Notifications

notifications:
  enabled: true
  methods: [CHAT, ACTION_BAR]
  sound-on-buy: true
  sound-on-sell: true
  sound-name: ENTITY_EXPERIENCE_ORB_PICKUP
  sound-volume: 0.5
  sound-pitch: 1.0

Controls how buyers and sellers are told about purchases and sales.

Logging and Discord

Setting	Default	Meaning
transaction-logging.enabled	false	Write a log of listings, sales and removals
transaction-logging.file	transactions-auction.log	The log file
transaction-logging.format	DETAILED	SIMPLE, DETAILED or JSON
transaction-logging.log-listing, log-sales, log-removals	true	Which events are logged
discord-webhook.enabled	false	Post events to a Discord webhook
discord-webhook.url	placeholder	The webhook URL
discord-webhook.min-delay	1	Seconds between webhook calls
discord-webhook.events.*	created, sold, expired on; removed off	Which events are posted

Embed layout is configured in webhook-auction.yml.

Currency

Currency settings are shared with the Orders module. economy.currency-symbol overrides the symbol shown in prices, and a currencies: block enables several currencies. If both config-orders.yml and config-auction.yml define them, config-orders.yml wins. See Economy.

Options that currently have no effect

The auction-gui section (update-interval, listings-per-page, container-preview, show-item-lore) is present in the file but is not read by the plugin. The screens always show 36 listings per page, and the shulker preview is controlled by shulker-preview above.