Commands & Permissions

Commands

CommandDescriptionPermission
/ahOpen the auction house GUINone
/ah sell <price> [quantity] [currency]List the held item at a fixed priceNone
/ah auction <bid> [duration] [currency]List the held item as an auctionNone
/ah cancelOpen your My Items screen (manage/reclaim listings)None
/ah myOpen your My Items screen (same as /ah cancel)None
/ah search <query> [min] [max] [material]Search listings by name, price range, and materialNone
/ah favorite <item_uuid>Toggle an item as a favoriteNone
/ah favoritesView your favorited itemsNone
/ah helpShow the help messageNone
/ah reloadReload configuration and language filesah.admin
/ah purge-expiredPurge all expired listings from the databaseah.admin
/ah purge-boughtPurge all sold listings from the databaseah.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

PermissionDescriptionDefault
ah.adminAccess to reload, purge, force-remove, /pah, and unlimited sell limitOP
ah.limit.<amount>Maximum number of simultaneous active listings (highest value wins)1 if none set
ah.updateReceive update notifications on joinOP

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.