Web Panel & Minigames

GensCore includes an integrated React 18 + Javalin web server running on port 8080.

Security & Architecture

Embedded Micro-Server: Javalin runs inside the Minecraft server process with zero external web server configuration required.
BCrypt Password Protection: The default admin password (gens in modules/web.yml) is automatically converted to a secure BCrypt hash on first startup.
Session Tokens:
- Admin routes use 24-hour Bearer tokens.
- Player sessions use 7-day tokens tied to /register credentials.
Brute Force Rate Limiting: Locks out any IP address attempting more than 5 failed logins per minute.

Access at: http://<your-server-ip>:8080/admin

Live Performance Metrics: Real-time gauges for TPS, active players, JVM memory allocation, and CPU load.
Interactive Web Console: Real-time server log streaming with command dispatching safely routed to Folia's GlobalRegionScheduler.
Player Management: Search players, inspect balances, adjust money, and execute kicks/bans/mutes from the browser.
Live Module Switchboard: Toggle any of the 30 modules on or off with a single click.
Dynamic Config Editor: Modify shop inflation, auction house fees, head drop rates, quest reroll limits, and MOTD lines live.
Integrated BlueMap: Embedded interactive 3D/2D territory map.
Emergency Server Wipe: Password-guarded atomic database reset button.

Access at: http://<your-server-ip>:8080

Player Dashboard: Login with in-game /register credentials.
Live Stats: Wallet balance, global job levels, blocks broken, mobs killed, deaths, and K/D ratio.
Guild Management Tab (/dashboard/team):
- Shared Treasury Management: View and deposit/withdraw dollars or XP levels directly from the web. When the Economy module is disabled, currency fields are automatically hidden and replaced by stored XP levels.
- BlueMap Territory Controls: View claimed chunks count, maximum limit, live territory link, and customize the team color on BlueMap via an interactive hex color picker.
- Web Perks Shop: Purchase any of the 5 guild upgrades directly from the browser. Purchases are strictly validated and debited from the guild bank.
- Roster & Role Administration: Inspect member cards with role badges (★ Chef, ♦ Admin, Membre). Leaders can promote members to Admin or demote them in one click. Leaders and Admins can kick members directly from the browser with safety confirmation modals.
7-Day Quest Activity: Visual SVG graph tracking daily quest completion history.
Transaction History: Review your last 5 financial transactions.
Head & Avatar Engine (/api/head/{name}/{size}): Renders high-resolution 3D avatars for both Java and Bedrock players.

The server's dynamic shop is fully accessible and synchronized in real-time on the web (http://<your-server-ip>:8080/shop).

Live market price tracking with historical trend charts and stock gauges.
Quick quantity multipliers (x1, x16, x32, x64, Max or precision slider).
Smart Delivery: If the player is online, purchased items are delivered straight to their inventory (or dropped safely at their feet if full). If offline, items are safely stored in the database and automatically dispatched on their next login.

In-Game Deposit: Hold any block or item in hand and type /web deposit. The item is transferred into your web reserve.
Storage Limit (27 Slots): By default, each player has 27 slots (equivalent to a single Minecraft chest), customizable via web.deposit_limit in modules/web.yml.
Intelligent Stacking:
- Identical items (same material and matching NBT/enchants) automatically stack into an existing deposit slot up to Minecraft's natural maximum stack size (64 for ores/blocks, 16 for Ender pearls, etc.).
- Weapons, tools, and armor (max stack = 1) never stack.
- If a stack overflows, a new slot is used if capacity remains, or the overflow is refunded to the player.
Quantity Selectors: In the My Deposited Items tab and in the shop drawer, players can select the exact quantity they want to sell or withdraw via a slider and quick buttons (x1, x16, x32, x64, Max).
In-Game Retrieval (/web withdraw): Click "Retrieve in-game" on the web, or type /web withdraw on the server to open a 54-slot GUI and collect your deposited items!

Daily spin available once every 24 hours.
Configurable weighted loot table:
- 10 Diamonds (40%)
- 2 Netherite Ingots (30%)
- 1 Enchanted Golden Apple (20%)
- 1 Elytra (9%)
- 1 Cow Spawner (1% Jackpot)
Offline Safe: If a player spins while disconnected, the prize is queued in SQLite and automatically delivered upon their next login via Folia's scheduler.