Stonks
A player-driven stock market for your server. Supply & demand pricing, random market events, polished GUIs.
A player-driven stock market for your server. Supply & demand pricing, random market events, polished GUIs.
What is Stonks?
Stonks adds a living stock market to your server. Players buy and sell shares in 8 configurable companies — and the market reacts to what they actually do. Heavy buying pushes prices up, panic selling drags them down. On top of that, random market events (booms and crashes, single company or market-wide) shake things up and are broadcast to the whole server.
Prices, holdings and price history are fully persistent across restarts.
Features
- Player-driven prices — every trade moves the market (configurable sensitivity and per-tick cap)
- Market events — random booms/crashes every 15-45 min (configurable), single company or market-wide, exact announced % move, silencable broadcasts
- Polished GUIs — market overview with trend arrows and sparklines, company trading screen, portfolio with profit/loss tracking, sell-all confirmation with fee breakdown
- Vault economy — configurable fee on every trade (burned), per-player share limits
- Persistent — SQLite by default, MySQL optional; prices, holdings, history and even a running event survive restarts
- Async everything — all database work off the main thread, zero lag
- Fully configurable — every company (name, icon, base price, volatility, min/max), every message, every broadcast
Commands
| Command | Description | Permission |
|---|---|---|
| /stonks (aliases: /stocks, /market) | Open the market | stonks.use (default: everyone) |
| /stonks portfolio | Open your portfolio | stonks.use |
| /stonksadmin reload | Reload config and messages | stonks.admin (default: op) |
| /stonksadmin forceevent [boom|crash] [ticker|market] | Force a market event | stonks.admin |
Setup
- Drop the jar into plugins/ with Vault and an economy plugin (EssentialsX etc.)
- Start the server, edit plugins/Stonks/config.yml to taste
- /stonksadmin reload — done
Config showcase
Companies are fully defined in config.yml — add your own, theme them to your server:
Code:
companies:
WHEAT:
name: "BreadBasket Co"
icon: BREAD
base-price: 100.0
volatility: 0.03 # max random % move per tick
min-price: 25.0
max-price: 400.0Requirements
- Paper/Spigot 1.20.4+ (Java 17+)
- Vault + an economy plugin
- MySQL optional (SQLite built in)
Found a bug or want a feature? Message me before leaving a review — I answer fast.
