Buczaak's WebMarket

By
buczaak

A fictional in-game crypto exchange for Paper servers: living market with bots and events, candlestick charts, in-game GUI and a built-in website. Server currency only (Vault) — no real money.

Download

6-admin.png

5-ranking.png

3-portfolio-news.png

2-chart.png

1-market-overview.png

Description

WebMarket

NOTE: All Comands and Website made in POLISH (future updates will include english)

A living, fictional crypto exchange for your Minecraft server – with its own built-in website.

Players trade made-up coins (MineCoin, CreepDoge, Enderium, WardenCoin…) using your server's economy. Prices move on their own, bots trade, news and events shake the market, and everyone can watch live candlestick charts in the browser or trade through an in-game menu.

This is a game mechanic only. It uses your server's Vault economy. There is no real money, no payment integration, no deposits or withdrawals of real currency, and the plugin sends no data anywhere outside your server.

Features

Live market – prices move every few seconds (real server-side changes, identical for every player), plus a 5-minute market cycle with mood, mean reversion and an optional hidden admin trend.
Fair price curve – the price depends on order size: big buys push the price up, big sells push it down. Splitting orders or buy-and-instantly-sell gives no profit. A configurable sell fee (default 2%) applies.
Bots and events, openly labelled – bots create demand and supply; 16 default events (one bull run and one crash for each of the 8 coins) broadcast news in chat and on the site. Bots and events are marked as such for players.
Built-in website – candlestick chart with timeframes, live-updating price, portfolio with profit/loss, trade history, leaderboard, news and live trade feed, support/resistance lines, admin panel. Remembers your selected coin and timeframe.
In-game menu – /gielda opens wallet, market and broker (BUY 1/10/100/MAX, SELL 1/10/100/ALL).
Limit orders – buy when the price drops, sell when it rises, funds are escrowed.
Passwordless login – players get a one-time code in game (/gielda link) and enter it on the site.
Safe money handling – integer arithmetic (no rounding exploits), atomic transactions, crash-resistant withdrawal queue, audit log of admin actions.
SQLite out of the box, MySQL optional. No extra libraries to install.
Fully configurable – coins, volatility, fee, bots, events, events' multipliers, web port, rate limits, look of the site (override HTML/CSS/JS).

Requirements

Paper (or a fork) 1.21.x, Java 21
Vault and an economy plugin (e.g. EssentialsX)

Quick start

Drop KryptoGielda-x.y.z.jar into plugins/ together with Vault and your economy plugin.
Start the server once – config.yml and messages.yml are generated.
Edit config.yml (coins, web port, web.public-url), restart.
In game run /gielda link, then enter the code on the website (default port 8123).

For a public site use a reverse proxy with HTTPS (nginx/Caddy) and set web.bind: 127.0.0.1, web.secure-cookie: true, web.trust-forwarded-headers: true.

Commands & permissions

Command	Description	Permission
`/gielda` (`menu`, `wallet`, `market`, `link`, `help`)	menu and info	`gielda.use` (everyone)
`/wplac <amount>`	move money from your game balance to the exchange account	`gielda.use`
`/wyplac <amount>`	move money from the exchange account back to the game balance	`gielda.use`
`/gieldaadmin …`	price control, hidden trend, force cycle, run events, edit player accounts, reset, pending payouts	`gielda.admin` (OP)

Security

One-time login codes, HttpOnly + SameSite=Strict session cookies, request rate limits, Origin checks, request size limits, strict CSP, no external scripts or libraries on the site, all price logic is server-side.

Language

The in-game messages and the default website are currently in Polish. All in-game messages are editable in messages.yml, and the website files can be overridden in plugins/KryptoGielda/web/.

Support

Found a bug? Open an issue: · Discord: https://discord.com/users/332591015527448576