NexusExchange - Stock & Crypto Engine v1.1.0

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: set limit orders and stop-losses, earn dividends, chase IPO launches, build a watchlist with price alarms, and push every event straight to Discord.

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 and more to your scoreboards, TAB and chat. Skipped silently if not installed.
• 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 and watchlists are all stored via HikariCP.
• Multi-database backend: SQLite (zero setup), embedded H2, and MySQL/MariaDB for sharing market data across a network.
• Folia-native: one jar, both platforms, modern async architecture.

Advanced Trading

• 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.
• Per-asset leaderboards: rank the best traders on any asset by unrealised profit, shown in chat or a player-head GUI.

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, holdings and top gainer/loser as placeholders for scoreboards, TAB, chat and holograms.

Asset Types






Crash & Hype Dynamics

• Market-wide shocks: one event runs at a time. On trigger, every affected asset takes an instant price shock, then drift biases toward the event direction for its duration.
• Crash: an instant drop (configurable, e.g. -60%) with a red title, a random news headline in the action bar, and a panic-selling atmosphere.
• Hype: an instant surge (configurable, e.g. +60%) that kicks off a bull run players race to ride.
• Configurable odds: chance-per-interval, min/max duration, and per-direction enable toggles.
• Admin-forced: trigger a crash or hype on demand with /market crash and /market hype.
• Reality-safe: live CoinGecko coins are left untouched so they keep mirroring the real market.

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. 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, and dividends earned today.
• /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.
• /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.

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.admin (op) for reload, forced events and the tax pool; nexusexchange.ipo.admin (op) for launching and managing IPOs.


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 and IPO launches give players something to check every single login.
• Strategic depth: 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.
• Hype machine: IPO launches and Discord alerts pull your community to the market together.
• Zero-hassle setup: no required dependencies, SQLite by default — drop it in and go.
• Network-ready: MySQL backend shares one market across your whole network.
• 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 — without it the market still simulates, charts, and runs events. PlaceholderAPI and shop plugins are optional integrations.

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.

What happens if CoinGecko is down?
Live coins fall back to simulated drift automatically, so the market never freezes or breaks.

How do limit orders and dividends work?
Players queue buy, sell or stop-loss orders that fill automatically when the price hits their target, even offline. Stocks can pay dividends per share held on a set interval — offline holders get paid too, and every payout is logged so reloads never double-pay.

What are IPOs?
Admins launch a new stock as a timed, fixed-price offering with a capped supply. When it closes, the stock joins the live market and every buyer's shares move straight into their portfolio.

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.

What's persisted?
Player holdings, a full transaction audit log, price history, open orders, dividend payouts, IPO purchases and watchlists.




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, limit orders, stop loss, dividends, IPO plugin, watchlist, price alerts, 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.