Installation

Installation

Requirements

Server	Paper 1.21+ (tested on Paper 26.2)
Java	21+
Required	Vault + a Vault-compatible economy plugin (EssentialsX, an EcoBits currency with vault: true, …)

Optional integrations — installed only if you want them:

• eco / EcoItems — trade custom ecoitem: items alongside vanilla materials
• EcoShop — reuse EcoShop item definitions
• PlaceholderAPI — expose live prices anywhere (see PlaceholderAPI)
• EconGuard — report every trade to the shared audit ledger (see EconGuard Integration)
• RoyalBank — the rest of the economy suite

Install

1. Stop the server.
2. Drop RoyalBazaar.jar into plugins/.
3. Make sure Vault and an economy provider are installed too.
4. Start the server.

On first boot RoyalBazaar generates:

plugins/RoyalBazaar/
├── config.yml            # engine + storage settings
├── categories/           # one file per category (farming.yml, mining.yml, …)
├── gui/                  # menu layouts (bazaar_main, bazaar_category, bazaar_product)
└── bazaar.db             # SQLite price data (unless you switch to MySQL)

The JDBC driver and connection pool are downloaded automatically at runtime by Paper's library loader — nothing is bundled into the jar, so the download is small.

Verify

Look for these lines in the console on startup:

[RoyalBazaar] Connected to SQLITE storage.
[RoyalBazaar] eco detected — custom item ids (ecoitem:...) enabled.   (only if eco is installed)
[RoyalBazaar] EconGuard detected ...                                  (only if EconGuard is installed)

Then run /bazaar in-game — the main category menu should open. If it doesn't, check the console for a config warning and see FAQ & Troubleshooting.

Updating

Replace the jar and restart. Your config.yml, categories/, and gui/ files are never overwritten. After any config edit you can hot-reload with /bazaar reload instead of restarting (storage-backend changes still need a restart).