| Nobody can buy or sell | Install Vault and an economy plugin, then restart. |
| “This item can’t be sold on the auction house.” | The item matches the blacklist, or its data is larger than max-item-data: 40000 under blacklist:. |
| “All your listing slots are in use.” | The player has as many listings as default-slots or their auctionhouse.slots.<amount> allows. Expired listings in Your Items count until they are claimed. |
| /fastbuy or /fastsell does nothing | The player needs auctionhouse.fastbuy or auctionhouse.fastsell. The toggle only works while they have it. |
| /shop opens another plugin | Another plugin already uses /shop. Use /quickbuy. |
| Listings from another server don’t show up | Check that both servers use the same database and table-prefix, and that network is enabled with the same Redis and channel. |
| “Server slot limit reached” after reinstalling | The plugin folder (and .installation-v2.key) was deleted, so the server counts as new. Ask support to free the old slot. |
| License validation failed | Check the key, outbound internet access, and that you run the latest Auction House JAR. The console shows the reason. |
| Libraries fail to download | The first start needs internet to download Kotlin and the database drivers. Allow outbound access and restart. |
| Changes don’t show up | Run /ah reload. Storage and network changes need a full restart. Delete menus.yml or messages.yml to get the newest defaults back. |
| Something went wrong with a sale | Check plugins/AuctionHouse/logs. Every listing, purchase, cancel and expiry is written there with the full item data. |