Docs / ProAuction / FAQ

FAQ & Troubleshooting

Common setup issues, currency problems, and operational questions for ProAuction.

The plugin disables on startup. Why?

  • ProAuction enforces a strict license gate.
  • Check settings.yml → license.key.
  • Confirm server-id.txt and license-cache.yml are being created under plugins/ProAuction/.

Players can’t buy/sell using a currency key.

  • Confirm the currency key exists in currencies.yml.
  • If the currency type is VAULT: ensure Vault + an economy plugin are installed.
  • If the currency type is AUCTION: ensure PlaceholderAPI + the placeholder provider plugin are installed.

AUCTION currency balances don’t update.

  • Verify the configured placeholder is correct and returns a numeric balance (via PlaceholderAPI).
  • Verify the set-command format is correct and works when executed as console.
  • If PlaceholderAPI or the provider plugin is missing, that currency becomes unusable and transactions are blocked.

Players can’t find listings / search behaves weird.

  • Search is a best-match filter by material name.
  • Use /ah search clear (or /ah search with no args) to clear filtering.

Listings disappear / expire too quickly.

  • Listings expire based on settings.listing.duration-seconds.
  • Expired/cancelled items move into Expired Items, where players can claim them back.

Black Market or Shop editor chat prompt is not showing.

  • Ensure you are not in a mode that blocks chat (mute, chat control plugins, etc.).
  • Confirm blackmarket.enabled: true for /ah bmeditor.
  • Make sure you have proauction.admin permission.

A shop opens the Auction House GUI instead of the shop.

  • Shop NPC interaction should cancel default interaction and open the shop GUI.
  • Review settings.yml → shops.entity.* flags (cancel default interaction).
  • Use /ah shop editor <key> to confirm the shop exists and is correctly configured.

Support Checklist

  • Confirm ProAuction version and server version (api-version: 1.21 target).
  • Confirm settings.yml license.key is set correctly.
  • Confirm the currency key exists and its provider is available (Vault / PlaceholderAPI).
  • Run /ah reload after any config change.
  • Check console for missing dependency warnings (Vault/PlaceholderAPI hooks).
Back to ProAuctionDocs