Commands
Every command, its arguments, permission and an example.
The root command is /ah. It also answers to /auction, /auctions and /zyauctions.
All of it is real Brigadier, so the client suggests subcommands and validates numbers before the command is even sent.
/ah
Opens the auction house browser.
| Permission | zyauctions.use |
| Who | Players only |
/ah/ah sell
Puts the item in your main hand up for a fixed price. The whole stack is listed.
| Syntax | /ah sell <price> [duration] |
| Permission | zyauctions.sell |
| Who | Players only |
| Argument | Type | Required | Notes |
|---|---|---|---|
price | number ≥ 0.01 | yes | Must be within listings.min-price and listings.max-price. |
duration | duration | no | Defaults to listings.default-duration. Cannot exceed listings.max-duration. |
/ah sell 1200
/ah sell 1200 12hThe listing fee is taken immediately and is not refunded if the item does not sell. The item leaves your hand only once the listing has been created successfully.
/ah auction
Starts an auction on the item in your main hand.
| Syntax | /ah auction <starting-bid> [increment] [duration] |
| Permission | zyauctions.sell |
| Who | Players only |
| Argument | Type | Required | Notes |
|---|---|---|---|
starting-bid | number ≥ 0.01 | yes | The opening bid. The first bidder pays exactly this. |
increment | number ≥ 0.01 | no | The minimum step for every bid after the first. Defaults to auctions.min-increment, and cannot be below it. |
duration | duration | no | Defaults to listings.default-duration. |
/ah auction 500
/ah auction 500 50
/ah auction 500 50 2dRefused with a message if auctions.enabled is false.
/ah search
Opens the browser filtered to a search term. The same thing the magnifying glass button does, for players who prefer typing.
| Syntax | /ah search <query> |
| Permission | zyauctions.use |
| Who | Players only |
The query matches against the item's material name and its display name, case-insensitively.
/ah search diamond
/ah search sharpness v/ah listings
Opens your own listings, where you can withdraw them.
| Permission | zyauctions.use |
| Who | Players only |
An auction that already has bids cannot be withdrawn — somebody's money is committed to it. The icon says so rather than doing nothing when clicked.
/ah collect
Opens your collection bin.
| Permission | zyauctions.collect |
| Who | Players only |
Click an item to claim it, or use Claim everything to take as much as fits. Anything that does not fit stays where it is.
/ah info
Shows the plugin version, how many listings are live, which economy is hooked and which languages loaded.
| Permission | zyauctions.use |
| Who | Players and console |
ZyAuctions v1.0.0
Active listings: 214
Economy: EssentialsX Economy
Languages: de_DE, en_US/ah reload
Re-reads config.yml and every language file.
| Permission | zyauctions.admin.reload |
| Who | Players and console |
Listings, bids and collection bins are untouched — this only swaps settings and text.
Changing the storage section does not take effect on reload. You will see a console
warning and the plugin will carry on using the backend it started with. Restart the
server to change storage.
If a language file has become invalid, the reload fails, the previous text stays loaded, and the error goes to the console. Nothing breaks while you fix the file.
What players can do without any command
Everything except selling. The browser has buttons for search, categories, sorting, your
listings and your collection bin, so a player who only ever types /ah never needs to
learn the rest.