FAQ and Troubleshooting

FAQ & Troubleshooting

Setup

RoyalAuctions says it's waiting for an economy provider / buying does nothing. Vault is only a bridge — you also need a real economy plugin (EssentialsX, CMI, etc.) registered through Vault. RoyalAuctions deliberately waits for that provider instead of disabling, so load order can't kill it; but if no economy ever registers, transactions fail. Confirm your economy plugin is installed and loading without errors.

Do I need the eco suite? No. Without it you lose custom-item categorisation and the tier filter, and the plugin never touches an eco class. Everything else works on any Vault economy.

A menu / config change isn't taking effect. Run /ah reload. If it still doesn't apply, the file probably failed to parse — check the console for a YAML error naming the line.

Menus

A whole menu file fails to load. The most common cause is an inline item spec with a colon followed by a space that isn't quoted — SnakeYAML reads it as a mapping. Quote it: item: 'hopper name:"&eSort: &f%sort%"'. See Menus & GUI.

A button does nothing. Check its effect id: against the list in Menus & GUI — a typo or missing id makes it decorative. Watch the console for warnings when the menu loads.

The tier / type filter only shows one line instead of the whole list. The lore line must be exactly %tier_list% (or %type_list%) on its own — any extra text on the same line stops it expanding.

Categories

An item shows in "All" but lands in the wrong category (or Misc). Category is inferred from the item's base material, which is a guess for custom items. Hold the item and run /ah category to see which rule decided it, then pin it with match.items in the right category file — pins beat every other rule. See Categories.

How do I know which items need pinning? Read the startup category audit in the console — it lists exactly which eco items only hit the catch-all. Don't guess; the audit tells you.

I renamed a category and worried about old listings. They're fine — RoyalAuctions re-derives and persists the category of any listing whose id no longer exists, on load. You'll see a Re-categorised N listing(s) line.

Tiers

The tier filter says 0 tiers / is empty. Tiers are read from plugins/EcoItems/rarities/. No EcoItems means no rarities, so the filter is inert. With EcoItems present, confirm your rarity files load and that the tier isn't in the tiers.hide list.

Old listings don't appear under any tier. Tier is stamped at creation, so listings made before the tier feature have none and show only under No Filter. New listings get a tier automatically.

Bidding & selling

A player can't cancel their auction. An auction that already has bids can't be cancelled — that money is committed to the top bidder. It must run to the end. Buy-It-Now listings and bid-free auctions can be cancelled (the item returns to the Collection).

A player says a purchase/win "disappeared." It's in their Collection — /ah collect. Items go there when the inventory was full, when instant-deliver-purchases is off, or when a listing expires/returns. Nothing is ever destroyed by a full inventory.

Why was a fee charged when the item didn't sell? The listing fee (listings.fee) is taken when the item is posted, not when it sells, and is non-refundable — that's what stops listing spam. An unsold item still comes back via the Collection; the fee does not.

Data

Where is the data / can I share it across servers? plugins/RoyalAuctions/auctions.db (SQLite), or a shared MySQL database if you set storage.type: MYSQL. See Storage & Data.

View Bids is empty for bids I know I placed. Only bids placed from the version that added per-bid tracking appear — older bids aren't backfillable. See Storage & Data.

Still stuck?

Open an issue on the GitHub repository with your server version, the RoyalAuctions version, the relevant config/menu section, and any console errors.