RoyalBazaar
A Hypixel-style Bazaar for Paper — a bulk commodity market with algorithmic, supply-and-demand pricing. The server is always the counterparty with infinite depth, so there's no order book and no waiting: players buy and sell instantly, and the price moves as they trade.
Built for the eco suite (EcoItems, EcoArmor, and friends), but it runs perfectly well on a server that has none of them.
How the pricing works
RoyalBazaar isn't a fixed-price shop. Every item sits on an AMM-style price curve:
- Buying walks the price up; selling walks it down. Each trade nudges the item's mid-price along an exponential curve, so a market that everyone dumps into gets cheaper, and a scarce item players keep buying gets pricier — automatically.
- Large orders are priced progressively. Cost and proceeds are the integral along the curve, not a flat multiply, so bulk orders get steadily worse fill prices. Buying 200 then selling 200 is a guaranteed loss by construction — round-trip and whale-draining exploits simply aren't profitable.
- A configurable spread sits between the buy and sell price.
- Mean reversion gently pulls every price back toward its configured base over time, so a one-off spike or crash heals on its own.
- Price floors and ceilings cap how far any item can move.
Everything — base price, spread, elasticity (how fast the price reacts), reversion rate, floor, and ceiling — is configured per item.
Features
- 📈 Live, dynamic prices driven by real player supply and demand
- 🧺 Category-based menus — organize items into pages (farming, mining, …), each its own small, easy-to-edit file
- 🖱️ Clean GUI — browse categories, view an item's live buy/sell/mid price and trend, and buy or sell all, a custom amount (typed in chat), or a fixed quantity
- 🧩 eco-suite item support — trade custom
ecoitem:items right alongside vanilla materials - 🔌 PlaceholderAPI — expose live prices anywhere (holograms, scoreboards, chat)
- 🛡️ EconGuard integration — every trade is reported to the shared audit ledger for anti-abuse / RMT analysis when EconGuard is installed
- 💾 SQLite or MySQL storage — SQLite out of the box, MySQL for a networked setup; drivers are downloaded at runtime, nothing bloats the jar
- ⚙️ Fully configurable & hot-reloadable — tune the market, menus, and categories without a restart
Commands
| Command | Description |
|---|---|
/bazaar |
Open the Bazaar (aliases: /bz, /rbazaar) |
/bazaar price <item> |
Show an item's live buy / sell / mid price |
/bazaar reload |
Reload config, categories, and menus |
Permissions
| Node | Default | Description |
|---|---|---|
royalbazaar.use |
everyone | Open and trade on the Bazaar |
royalbazaar.admin |
op | Reload config and inspect prices |
Requirements
- Paper 1.21+
- Vault + a Vault-compatible economy plugin (EssentialsX, an EcoBits currency, …)
Optional (soft) integrations: eco / EcoItems (custom items), EcoShop, PlaceholderAPI, EconGuard (audit ledger), RoyalBank.
Configuration
config.yml— market engine tick rate, price-history interval, trend smoothing, inventory-full handling (refund / drop / partial), and the storage backend.categories/*.yml— one file per category; add or remove items and set each item's pricing parameters. Add a category by dropping in a new file.gui/*.yml— EcoMenus-style menu layouts, consistent with the rest of the Royal suite.
Part of the Royal suite
RoyalBazaar is one of a set of economy plugins that work together but stand alone: RoyalBank (banking), RoyalAuctions (auction house), and EconGuard (shared economy audit + anti-abuse core). Install any combination — they integrate automatically when they detect each other.
