FAQ and Troubleshooting

FAQ & Troubleshooting

/bazaar doesn't open anything

Almost always a missing economy provider. RoyalBazaar needs Vault and a Vault-compatible economy plugin (EssentialsX, an EcoBits currency with vault: true, …). Check the console on startup for a Vault warning, and make sure both are installed. See Installation.

Prices barely move (or move too much)

That's elasticity, set per item/category in Categories.

• Prices too stable? Lower elasticity.
• Prices too swingy? Raise it.

elasticity is how many units it takes to move a price by a factor of e — see the Pricing Model.

Can players make money by buying and instantly selling?

No — that's impossible by design. The buy/sell spread plus the progressive price curve mean a round-trip always comes back at a loss. You can't extract money the market didn't already contain. See Pricing Model.

My custom (eco) items don't appear

Custom ecoitem: items only work when eco / EcoItems is installed. Without it, those entries are skipped and a line is logged. Confirm the id is correct (ecoitem:enchanted_cobblestone, keeping the namespace) and that eco loaded before RoyalBazaar.

Prices went back to default after a restart

Prices do persist. If they reset, you most likely changed storage.type (SQLite ↔ MySQL) — the two backends are separate databases and RoyalBazaar doesn't migrate between them, so the new one starts fresh from each item's base_price. See Storage & Data.

MySQL: "Communications link failure" / "Access denied"

• Confirm the database exists: CREATE DATABASE royalbazaar;
• Check host / port / username / password in config.yml.
• MySQL 8 with caching_sha2_password often needs properties: "useSSL=false&allowPublicKeyRetrieval=true".
• Remember: switching to MySQL needs a full restart, not /bazaar reload.

A menu looks broken after I edited it

Run /bazaar reload and check the console — RoyalBazaar logs the file if it can't parse. Common causes: tabs instead of spaces, an unquoted name: with special characters, or a location row/column outside the menu's rows. See Menus & GUI.

Do I have to restart to apply config changes?

No — /bazaar reload re-reads config.yml, categories, and menus live. The one exception is storage.type, which needs a full restart.

How do I add or remove items and categories?

Edit the files in categories/ — one file per category — then /bazaar reload. Full walkthrough on the Categories page.

---

Still stuck? Open an issue on the GitHub repo with your console log and the relevant config.