Running the Auction House

Admin setup and moderation - currencies, limits, fees, tax, blacklists, expiry, removing listings and the sale history.

This page covers the owner and staff side. Settings live in config.yml; the moderation commands need optimalauctions.admin. After editing any file, run /ahadmin reload.

1. Pick your currencies

Each file in currencies/ is one currency that sellers can list in. Three ship by default:

File	Type	Needs
`gems.yml`	`OPTIMALGENS_GEMS`	OptimalGens
`money.yml`	`VAULT`	Vault and an economy plugin
`tokens.yml`	`OPTIMALGENS_TOKENS`	OptimalGens

Disable the ones you can’t support with Enabled: false. The first enabled file by name is the default currency for /ah hand and /ah all without a currency argument, so if you only want money, disable or delete gems.yml and tokens.yml. Full reference: currencies.

2. Set the market rules

All under Settings in config.yml:

Goal	Key	Shipped
How long a listing stays up	`Listing-Duration` (seconds)	`86400` (24 hours)
Lowest allowed price per item	`Min-Price`	`1.0`
Highest allowed price per item	`Max-Price` (`-1` = none)	`-1`
Fee to list, as a % of the listing’s total value	`Listing-Fee-Percent`	`0.0`
Active listings per player	`Default-Listing-Limit`	`5`
Announce every new listing	`Broadcast-New-Listings`	`false`
Time between bumps of one listing	`Bump-Cooldown` (seconds)	`300`
Cost of a bump, in the listing’s currency	`Bump-Cost`	`0.0`

The sales tax is per currency: Tax in each currency file is the percentage taken from the seller’s payout on every purchase.

Listing limits per rank

Give ranks a higher cap with permissions. The highest one a player has wins:

optimalauctions.limit.10
optimalauctions.limit.25
optimalauctions.limit.unlimited

A player without any of these uses Default-Listing-Limit.

Blacklist items

Settings:
  Blacklisted-Materials:
    - "BEDROCK"
    - "COMMAND_BLOCK"
    - "*SPAWN_EGG"
  Blacklisted-Names:
    - "*Admin*"

Materials match the material name, names match the item’s display name without colors. Both are case insensitive and support * at the start, the end, or both (*SPAWN_EGG, DIAMOND_*, *Admin*).

3. Tune expiry

Expiry-Check-Interval (default 30 seconds) is how often listings are checked. A listing can stay up to that long past its expiry time before it moves to the expired menu.
Expired-Deletion-Time (default -1, never) deletes expired listings that were not collected, that many seconds after they expired. The items are gone for good, so leave it at -1 unless you want unclaimed items to disappear.
Menu-Refresh-Ticks (default 20) redraws open auction menus so the {expires} timers tick. Set 0 to turn live refresh off.

4. Moderate listings

/ahadmin remove Notch
/ahadmin open Notch

Both open the removal menu with every active listing of that (online) player. Clicking a listing takes it off the market: it moves to the seller’s expired menu, so they get their items back when they collect. You get ADMIN-REMOVED, and the seller gets ADMIN-REMOVED-NOTICE if online.

To pull everything a player has listed at once:

/ahadmin expire Notch

This expires all of their active listings immediately (it also works from console). Their items wait in their expired menu like any other expired listing.

5. Check the sale history

/ahadmin history          # every sale on the server
/ahadmin history Notch    # sales where Notch was the buyer or the seller

The history menu shows the newest sales first, one entry per purchase (a listing bought in three chunks shows three entries), with the buyer, seller, amount, price and date. It is read-only.

History-Limit (default 90) is how many sales the menu loads.
History-Keep-Days (default -1, forever) deletes sales older than that many days. It runs once at server start.

6. Customize the look

Lore added to listing icons, the “All Items” label and the anvil prompt texts are in config.yml.
Menu layouts are in guis/: menus and purchase-menu.yml.
Categories are in categories.yml.
Every message is in messages.yml.