Commands & Permissions

This page lists all commands and permissions available in zAuctionHouse V4.

Main CommandCopy Anchor Link

The main command is /zauctionhouse with the following default aliases:

• /ah - Short and common
• /hdv - French abbreviation (Hotel des Ventes)
• /auction - Full English name
• /zauction - Plugin-prefixed version

Player CommandsCopy Anchor Link

Sell Command DetailsCopy Anchor Link

/ah sell <price> [amount] [economy]

Arguments:

• <price> - The price per item (required). Supports multipliers: 1K, 2.5M, 1B, etc.
• [amount] - Number of items to sell from your stack (optional, defaults to full stack). With the sell inventory enabled, the amount is applied to the item held when the sale is confirmed, capped at the stack size
• [economy] - Which economy to use (optional, defaults to configured default)

Examples:

# Sell item in hand for 1000
/ah sell 1000

# Sell 32 items for 5000 each
/ah sell 5000 32

# Sell using specific economy
/ah sell 10000 64 vault

Search Command DetailsCopy Anchor Link

/ah search <query>

Search for items in the auction house. Without operators, the query performs a case-insensitive substring match on item name, material, lore, and seller.

Advanced Filters:

Use the format field operator value for targeted searches. Spaces around the operator are supported.

Examples:

# Simple search (matches name, material, lore, seller)
/ah search diamond

# Find items sold by a specific player
/ah search seller = Notch

# Find items containing "Diamond" in their name
/ah search name ~ Diamond

# Find swords (case-insensitive)
/ah search material ~= sword

Sell Inventory ModeCopy Anchor Link

If enable-sell-inventory is set to true in config, running /ah sell without arguments opens a GUI where players can:

• Select items from their inventory
• Set the price
• Choose the economy

Admin CommandsCopy Anchor Link

Admin Open TypesCopy Anchor Link

The <type> parameter for /ah admin open accepts:

• listed - View player's active listings (default when the type is not recognized)
• expired - View player's expired items
• purchased - View player's purchased items

Example:

/ah admin open Steve listed

To view a player's history, use /ah admin history <player> (see below).

Admin Player Directory & HistoryCopy Anchor Link

/ah admin
/ah admin history [player]

• /ah admin (no argument) and /ah admin history (no player) open the admin player directory (admin-main): one head per player with auction activity, showing their current listings, sales and purchases. Click a head to open that player's admin history. The data is reloaded every time the inventory is opened.
• /ah admin history <player> opens the admin history menu (admin-history-main) of that player directly. If the player has never been seen by the plugin, an error message is sent.

Both require the zauctionhouse.admin.items permission. Without it, /ah admin only shows the command syntax.

Examples:

# Browse every player with auction activity
/ah admin

# Open Steve's admin history
/ah admin history Steve

Admin Force Open CommandCopy Anchor Link

/ah admin forceopen <player> <inventory> [page]

Opens any inventory for a player at a specific page. Useful for debugging or navigating directly to a specific inventory and page.

Arguments:

• <player> - Target player name (required)
• <inventory> - Inventory to open (required). Accepts any inventory file name
• [page] - Page number to open at (optional, defaults to 1)

Available inventories:

Examples:

# Open admin view of Steve's active listings
/ah admin forceopen Steve admin-selling-items

# Open auction house at page 3
/ah admin forceopen Steve auction 3

# Open admin logs at page 2
/ah admin forceopen Steve admin-logs 2

MigrationCopy Anchor Link

Migrate data from other auction plugins:

/ah admin migrate zauctionhousev3 confirm

Supported sources:

• zauctionhousev3 (aliases: zah, zahv3, v3)

PermissionsCopy Anchor Link

Basic PermissionsCopy Anchor Link

Item Limit PermissionsCopy Anchor Link

Control how many items a player can list simultaneously. Configure in config.yml:

permissions:
  auction:
    - permission: zauctionhouse.max.5
      limit: 5
    - permission: zauctionhouse.max.10
      limit: 10
    - permission: zauctionhouse.max.15
      limit: 15

The plugin uses the highest limit permission the player has.

Expiration Time PermissionsCopy Anchor Link

Control custom expiration times for listed items. Configure in config.yml:

expiration:
  auction:
    default-expiration: 172800  # 2 days in seconds
    permission:
      enable: true
      permissions:
        - permission: zauctionhouse.expiration.vip
          expiration: 3600      # 1 hour
        - permission: zauctionhouse.expiration.elite
          expiration: 7200      # 2 hours
        - permission: zauctionhouse.expiration.legend
          expiration: 259200    # 3 days

Tax PermissionsCopy Anchor Link

Control tax rates for players. Configure in economies.yml:

Economy PermissionsCopy Anchor Link

If using multiple economies, control access per economy:

Replace <name> with your economy name (e.g., vault, playerpoints).

Command Aliases ConfigurationCopy Anchor Link

Configure command aliases in config.yml:

commands:
  main-command:
    aliases:
      - ah
      - hdv
      - auction
      - zauction

  sell:
    aliases:
      - sell
      - s
      - vendre

  claim:
    aliases:
      - claim
      - c
      - recuperer

  page:
    aliases:
      - page
      - p

  search:
    aliases:
      - search
      - s

Price MultipliersCopy Anchor Link

Players can use shorthand notation for large prices:

Examples:

/ah sell 1K      # = 1,000
/ah sell 2.5M    # = 2,500,000
/ah sell 1.5B    # = 1,500,000,000

Permission ExamplesCopy Anchor Link

LuckPermsCopy Anchor Link

Give a VIP group 15 item slots and legend expiration:

/lp group vip permission set zauctionhouse.max.15 true
/lp group vip permission set zauctionhouse.expiration.legend true
/lp group vip permission set zauctionhouse.tax.vip true

Example Group SetupCopy Anchor Link

# VIP Group
permissions:
  - zauctionhouse.max.15
  - zauctionhouse.expiration.legend
  - zauctionhouse.tax.vip

# Staff Group
permissions:
  - zauctionhouse.admin
  - zauctionhouse.reload
  - zauctionhouse.admin.items