NexusExchange
A hybrid in-game stock market & live crypto exchange for Survival, Economy, and Network servers
Simulated stocks, live CoinGecko crypto, an economy-driven price engine, crash & hype events — now with margin trading, cross-server sync, NPC brokers, a web dashboard, achievements, limit orders, dividends, IPOs and more.
Bukkit • Spigot • Paper • Purpur • Folia • Vault • CoinGecko • PlaceholderAPI • Citizens
What is NexusExchange?
NexusExchange turns your server economy into a living financial market. Players trade simulated company shares and crypto coins whose prices move under a real stochastic model, react to what players actually do in the world, mirror real-world crypto prices, and occasionally get rocked by market-wide crash and hype events.
It's a money sink, a player retention loop, and a daily reason to log in — driven by a clean chest GUI with live prices, trend arrows, and per-player profit/loss tracking. And it goes far beyond simple buying and selling: open leveraged margin positions, set limit orders and stop-losses, earn dividends, chase IPO launches, build a watchlist with price alarms, unlock achievements, run a live web dashboard, and share one market across your whole network.
Result: give your economy depth, give your players something to obsess over, and give your richest members a reason to keep their balances moving.
Dependency Stack
- No hard dependencies: runs out of the box on any Paper/Purpur/Folia 1.20+ server.
- Vault optional: connect any Vault economy plugin to enable real buying and selling. Without it, the market still simulates and charts live — players just can't trade yet.
- CoinGecko optional: realtime coins mirror live crypto prices via a single batched request; an optional Pro API key is supported, and the free endpoint works out of the box.
- PlaceholderAPI optional: expose live prices, trends, portfolio value, your worn title and more to your scoreboards, TAB and chat. Skipped silently if not installed.
- Citizens optional: enables NPC brokers players can right-click to open the exchange. Ignored cleanly when absent.
- Shop plugins optional: ShopGUI+, ChestShop and EconomyShopGUI trades feed market pressure when present — and are ignored cleanly when absent.
- Folia-aware scheduling: the platform is detected at startup and all task scheduling runs through a single Paper/Folia abstraction.
Main Feature Set
- Mean-reverting price engine: prices follow geometric Brownian motion in log-space with an Ornstein-Uhlenbeck pull toward each asset's base price — they oscillate realistically instead of drifting into the floor or ceiling and sticking.
- Economy-driven stocks: mining or selling tracked materials adds supply pressure that pushes a stock's price down; block-break and Vault-sell tracking are both supported and toggleable per stock.
- Live crypto: coins in realtime mode mirror CoinGecko prices, batched into one request per cycle, with automatic fallback to simulated drift if the API is unreachable — the market never freezes.
- Crash & hype events: random or admin-forced market-wide shocks with title, action-bar news ticker, boss bar, and sound; realtime coins keep tracking reality.
- Native trading GUI: every asset is an item with live price, trend arrow, source tag, your holdings, and live P/L; one-click sorting by name, price, trend or holdings; materials and custom-model-data are configurable for resource-pack icons.
- Full persistence: holdings, a complete transaction audit log, price history, orders, dividends, IPO purchases, margin positions, achievements and watchlists are all stored via HikariCP.
- Multi-database backend: SQLite (zero setup), embedded H2, and MySQL/MariaDB for sharing one market across a network.
- Folia-native: one jar, both platforms, modern async architecture.
Advanced Trading
- Margin & leverage: open long or short leveraged positions, profit in either direction, and manage them in a dedicated GUI. Positions are checked every tick and liquidated at the maintenance floor (full or partial). Payouts are margin ± market move, floored at zero — no money is created from nothing.
- Limit orders & stop-loss: players queue buy, sell and stop-loss orders that fill automatically the moment a price target is hit — keeping them engaged with the market even while offline.
- Dividends: stocks can pay recurring dividends per share held, on a configurable interval, rewarding long-term holders over quick flippers. Offline players still get paid, and payouts are logged so reloads never pay twice.
- IPO events: launch new stocks as timed, fixed-price offerings with a capped supply and per-player limit. When the IPO closes it graduates into the live market and every buyer's shares move into their portfolio automatically.
- Watchlist & price alarms: players track their favourite assets and get an instant alert when a price breaks an upper or lower threshold, with a configurable cooldown to prevent spam.
- Insider tips: rare redeemable items that hint at an asset's momentum — a nudge, not a guaranteed win. Drops from mob kills and mining, or hand them out via command and crates; every source is toggleable.
- Per-asset leaderboards: rank the best traders on any asset by unrealised profit, shown in chat or a player-head GUI.
Network, NPCs & Web
On a shared MySQL/MariaDB backend, one node computes prices while the others mirror them read-only, so every server on your network shows the exact same live market. Leadership is handled by a self-renewing lease, so if the leader goes down another node takes over cleanly. Servers on SQLite or H2 simply run standalone, exactly as before — the feature only activates on a shared database.
Place broker NPCs that open the exchange GUI when a player right-clicks them — turn your spawn into a real trading floor instead of a command tip in chat. Brokers are created and removed with a simple admin command. Citizens is a soft dependency: if it isn't installed, the rest of the plugin runs completely untouched.
A built-in web page shows your market live in the browser, with mini price charts per asset and — optionally — public leaderboards and player portfolios. It's built on the JDK's own HTTP server, so there's no extra dependency and nothing writes back into your server. Flip it on, set a port, and optionally protect the JSON endpoints with an API token. Per-player portfolios are off by default, and when enabled only expose what the in-game leaderboard already shows.
Progression: Achievements & Titles
- Trader milestones: players unlock achievements for trade counts, a big single win, total realised profit, portfolio value and diversification — each independently configurable.
- Wearable titles: pick a title from the achievement GUI and show it off in chat via PlaceholderAPI (%nexus_title%), alongside an unlocked-count placeholder.
- Optional rewards: each achievement can pay a configurable cash reward — set to 0 by default, so progression stays purely cosmetic and balance-neutral until you decide otherwise.
Integrations & Automation
- Discord webhooks: crashes, hype runs, big trades, IPO launches and a daily market report stream straight to your Discord as rich, color-coded embeds. Built on the JDK HTTP client — no external library, no bloat. Player names on big-trade alerts can be anonymized for privacy.
- Transaction tax: apply a configurable buy/sell fee in BURN mode (deflationary) or POOL mode (collected for events), with per-asset overrides and admin payout/burn controls.
- Shop integration: ShopGUI+, ChestShop and EconomyShopGUI transactions feed straight into the market-pressure pipeline — closing the loop between your existing economy and your exchange.
- PlaceholderAPI support: live prices, trends, market status, portfolio value, diversification, holdings, worn title and top gainer/loser as placeholders for scoreboards, TAB, chat and holograms.
- Backup & migrations: export and restore your full market data as JSON with /exchangebackup (off-thread, with a confirm step), backed by a versioned schema-migration framework for safe future updates.
Asset Types
Company shares whose price is pure local math: a mean-reverting random walk around a configurable base price, with per-asset volatility and min/max bounds. Perfect for fictional in-world companies (TNT firms, mining co-ops, nether energy) that react only to the simulation and market events.
Simulated stocks with a twist: flagged materials are tracked, and every time players mine or sell them, supply pressure nudges the stock's price down. A saturation threshold and a max-impact-per-tick cap keep the effect balanced — the more players farm, the more the price reacts.
High-volatility coins driven by the same stochastic engine as stocks, but tuned for bigger swings. Ideal for fantasy coins (BlockCoin, Enderium) that feel like a wild crypto market without touching the real world.
Coins in realtime mode mirror actual market prices — Bitcoin, Ethereum, or any CoinGecko-listed coin by ID — fetched in a single batched request per cycle and priced in your chosen fiat currency. If the API is unreachable they fall back to simulated drift, so the market keeps running.
The Price Model
NexusExchange doesn't fake price movement with a coin flip. Each interval, every simulated asset is updated in log-price space with three forces: a mean-reversion pull toward its base price, a drift bias from any active crash/hype event, and a gaussian random shock scaled by the asset's volatility. Working in log-space keeps prices strictly positive without ugly clamping, and the reversion term is what stops a random walk from escaping to the bounds and sticking there. Economy pressure and event shocks are layered on top as multiplicative factors — so prices feel alive, but never break.
GUI Controls
- Left-Click: buy 1
- Shift-Left: buy in bulk (configurable amount)
- Right-Click: sell 1
- Shift-Right: sell all held
Each icon shows the live price, a colored trend arrow, the price source (Live / Economy / Simulated), the expected transaction tax, and — when you hold the asset — your quantity, value, and signed profit/loss. Large buys and sell-all now ask for a quick confirmation click to prevent fat-finger trades. A footer item reports the current market status (stable, crash, or bull run), and a sort button reorders the whole market with a click.
Commands & Permissions
- /exchange (aliases: /ex, /market-gui): open the trading GUI.
- /stocks / /crypto: open the exchange GUI.
- /portfolio (alias: /pf): list your holdings, live value, diversification, and dividends earned today.
- /margin (open / list / close / closeall): manage leveraged positions.
- /order (buy / sell / stop / list / cancel / cancelall): manage limit orders and stop-losses.
- /watchlist (alias: /wl): open your watchlist and set price alarms.
- /ipo: browse active IPOs, or manage them as an admin.
- /achievements (aliases: /achievement, /titles): view achievements and set a title.
- /market info <asset>: a snapshot with an ASCII price sparkline and 24h high/low.
- /market top <asset>: view the per-asset trader leaderboard.
- /market tax (status / payout / burn): manage the transaction-tax pool.
- /market reload: reload config and assets.
- /market crash / /market hype: force a market-wide event.
- /exchangenpc (alias: /broker): place or remove broker NPCs.
- /insider: grant insider-tip items.
- /exchangebackup (export / list / import): back up and restore market data.
Permissions: nexusexchange.use (default) for trading, the GUI, the watchlist and leaderboards; nexusexchange.orders (default) for limit orders; nexusexchange.ipo.participate (default) for joining IPOs; nexusexchange.achievements (default) for achievements and titles; nexusexchange.admin (op) for reload, forced events and the tax pool; nexusexchange.ipo.admin (op) for launching and managing IPOs; nexusexchange.backup.admin (op) for backups.
Why Choose NexusExchange?
- A real money sink: gives wealthy players a reason to keep their balances moving instead of hoarding — and transaction tax can quietly drain inflation.
- Daily engagement: live prices, crashes, bull runs, dividends, IPO launches and achievement chases give players something to check every single login.
- Strategic depth: margin, limit orders, stop-losses and watchlists reward players who actually learn the market.
- Genuinely realistic: a proper stochastic price model, not a random number generator.
- Connected to your world: economy-driven stocks and shop integration tie the market to actual gameplay.
- Real crypto, in Minecraft: live Bitcoin and Ethereum prices on your server, the talking point that sells itself.
- Network-ready: one MySQL-backed market shared across your whole network, with one node leading and the rest mirroring.
- Show it off: a built-in web dashboard puts your live market in the browser for your whole community.
- Zero-hassle setup: no required dependencies, SQLite by default — drop it in and go.
- Folia-native: modern async architecture with no main-thread price-crunching.
FAQ
Do I need any other plugins?
No. NexusExchange runs standalone. Vault (plus an economy plugin) is only needed to let players actually buy and sell. PlaceholderAPI, Citizens and shop plugins are optional integrations.
How does margin trading stay balanced?
Payouts are your posted margin plus or minus the market move, floored at zero, and positions liquidate at a maintenance threshold. No new money is created — it's a redistribution of what traders put in.
Can I really share one market across my network?
Yes. On a shared MySQL/MariaDB database, one server computes prices and the rest mirror them read-only, with automatic leadership handover. SQLite/H2 servers run standalone.
What is the web dashboard?
A read-only web page, served by the JDK's built-in HTTP server, showing your live market with charts and optional leaderboards. It needs no extra dependency, can be protected with an API token, and never writes back to your server.
Does it really use real crypto prices?
Yes. Coins in realtime mode mirror live CoinGecko prices, batched into one request per cycle. A Pro API key is optional; the free endpoint works out of the box. If CoinGecko is down, live coins fall back to simulated drift so the market never freezes.
How do achievements and titles work?
Players unlock achievements by trading — trade counts, big wins, profit, portfolio value, diversification — and can wear a title shown in chat via PlaceholderAPI. Each achievement can optionally pay a configurable reward, off by default.
Can it post to Discord?
Yes. Crashes, hype runs, big trades, IPO launches and a daily report can be sent to Discord webhooks as rich embeds, using only the built-in HTTP client — no extra library needed.
Is it Folia-ready?
Yes. The platform is detected at startup and all scheduling runs through a unified Paper/Folia abstraction. The jar is marked folia-supported.
Which databases are supported?
SQLite (zero setup), embedded H2, and MySQL/MariaDB for network-wide market data.
Can I add my own stocks and coins?
Yes. Every asset is defined in a heavily commented config.yml — set the display name, item icon, base/min/max price, volatility, dividends, and (for stocks) the tracked materials. Custom-model-data is supported for resource-pack icons.
Can I back up my market data?
Yes. /exchangebackup exports every table to a JSON file and restores from one, running off-thread with a confirmation step before any restore.
Turn your economy into a living market.
Install NexusExchange, define your assets, and give your players stocks to trade, crypto to chase, leverage to risk, orders to set, and crashes to survive.
SEO keywords: NexusExchange, Minecraft stock market plugin, Minecraft crypto plugin, economy plugin, market plugin, trading plugin, stocks plugin, crypto exchange, CoinGecko Minecraft, Bitcoin Minecraft, live crypto prices, margin trading, leverage, limit orders, stop loss, dividends, IPO plugin, watchlist, price alerts, achievements, titles, NPC broker, Citizens, web dashboard, cross-server market, network economy, Discord webhook, PlaceholderAPI, transaction tax, shop integration, leaderboard, Vault economy, money sink plugin, server economy, GUI shop, Folia economy plugin, Paper economy plugin, Purpur, SQLite, MySQL, market crash event, bull run, portfolio plugin.
