TradeHub Market — Simulated Stock Market System for Your Server

Transform your server into a self-contained economy. TradeHub Market brings a fully simulated stock market system to your Paper server—featuring stocks, crypto, commodities, realistic bid-ask spreads, and trading fees. Everything runs entirely locally: no connection to real financial markets, no external APIs, and no ongoing costs.

✨ Features

4 Asset Categories Stocks, crypto, commodities, and rare commodities—each category has its own configuration file and menu icon. Comes pre-filled with example assets (Diamond Industries, BitRock, Iron, Gold, and more), but is fully customizable.

Realistic Trading No more trading exactly at the market price: players buy at the ask price and sell at the bid price. The bid-ask spread and optional broker fees are fully configurable (percentage-based or fixed amounts) and can be disabled entirely if simpler trading is preferred.

Automated Price Simulation Prices for each stock move automatically and randomly within a set volatility range—including minimum and maximum price limits. Each asset also displays a risk level (Low/Medium/High) so players can make informed investment decisions.

Intuitive GUI A single menu for everything: category selection, risk explanations, and account balance & portfolio value at a glance. Buy with left-click, sell with right-click, or buy/sell in batches of 10 by holding Shift.

Full In-Game Asset Management No need to edit YAML files: a dedicated management interface displays all assets, complete with search and category filters. The editor displays all fields at a glance as clickable items; simply click a field and enter a new value in the chat, and the editor automatically reopens with the updated value. Changes are only applied when clicking "Save." Admins can create, edit, duplicate, (de)activate, or delete assets (with a confirmation prompt)—including an automatic backup before every change.

Vault Integration Works with any Vault-compatible economy plugin. It automatically detects multiple registered economy providers and always integrates the best available one, regardless of plugin load order.

Persistent Data Portfolios and current prices are stored in a local SQLite database—asynchronously, without impacting the server tick. Restarts or updates do not reset prices.

Optional Discord Integration Market news can be sent directly to your Discord server—no bot required, just a webhook. Fully controllable via a dedicated admin GUI (on/off, URL configuration, testing, status display); disabled by default. Servers without a Discord connection remain completely unaffected. Nine message types (market events, new/activated/deactivated assets, price records, high volatility) can be toggled individually; embed colors, title prefixes, and footer text are fully customizable—including a local preview and send log right in the admin GUI. Additionally, it offers automatic summary market reports (every 30 minutes, hourly, every 6 hours, or daily) featuring top gainers/losers, a category overview, market sentiment, and key events since the last report. Dynamic Market News The market writes its own story: simulated economic events (e.g., "📈 Crypto on the rise!") appear regularly in the chat, noticeably shifting the price of a specific category. Market trends and volatility evolve organically based on recent events, with built-in safeguards against crashes or 100% spikes. Admins manage event types, categories, frequency, and custom headlines entirely via a dedicated GUI.

Portfolio Performance Profit/loss at a glance: The account display shows the percentage change in value over 1 hour, 12 hours, one day, one week, and since the start—green for gains, red for losses. This runs fully automatically in the background.

Portfolio Statistics Total profit, daily profit, average purchase price per position, and the best/worst currently held investment—all tracked automatically with every buy/sell transaction. Existing holdings from before the update are transparently marked as "Unknown" rather than displaying incorrect figures.

Asset Statistics All-time high/low, moving average price, creation date, trading volume, and the largest price change ever recorded—accessible for any asset via /stocks info <Symbol>.

Optional Trading Hours Each category can be restricted to a specific time window (e.g., stocks only from 08:00 to 20:00, while crypto remains open around the clock) or left open 24/7 by default. Settings are fully configurable via a dedicated admin GUI, including time windows that span across midnight.

Multilingual (German & English) All chat messages are fully translated.