Commands & Permissions
Commands
| Command | Description | Permission |
|---|---|---|
/ah | Open the auction house GUI | None |
/ah sell <price> [quantity] [currency] | List the held item at a fixed price | None |
/ah auction <bid> [duration] [currency] | List the held item as an auction | None |
/ah cancel | Open your My Items screen (manage/reclaim listings) | None |
/ah my | Open your My Items screen (same as /ah cancel) | None |
/ah search <query> [min] [max] [material] | Search listings by name, price range, and material | None |
/ah favorite <item_uuid> | Toggle an item as a favorite | None |
/ah favorites | View your favorited items | None |
/ah help | Show the help message | None |
/ah reload | Reload configuration and language files | ah.admin |
/ah purge-expired | Purge all expired listings from the database | ah.admin |
/ah purge-bought | Purge all sold listings from the database | ah.admin |
/pah <player> | View a specific player's listings (admin view) | ah.admin |
Command Aliases
You can define your own command names so players can type, for example, /hdv instead of /ah. Aliases are configured in config.yml:
# Aliases for /ah and /pah
command-aliases:
ah:
- hdv
- auctionhouse
pah: []
With the example above, every command and tab-completion that works under /ah also works under /hdv and /auctionhouse (so /hdv sell 500, /hdv search diamond, etc. are all valid).
- The main command name (
ah,pah) is always registered, even if the alias list is empty. - Aliases are case-insensitive and trimmed.
- Duplicates and entries equal to the main command name are silently ignored.
- A server restart is required to apply alias changes (Brigadier registers commands once at startup).
Common French alias for /ah: hdv (hôtel de vente). German servers often use auktionshaus; Spanish servers subastas.
Permissions
| Permission | Description | Default |
|---|---|---|
ah.admin | Access to reload, purge, force-remove, /pah, and unlimited sell limit | OP |
ah.limit.<amount> | Maximum number of simultaneous active listings (highest value wins) | 1 if none set |
ah.update | Receive update notifications on join | OP |
All player commands (/ah, /ah sell, /ah search, etc.) require no permission by default. To restrict access, use a permissions plugin to deny the base Bukkit command permission.