🌐 Web panel

✅ Setup

1. Enable the module in config/voidium/general.json:
   • enableWeb: true
2. Configure config/voidium/web.json (port, language, hostname)
3. Restart the server

You’ll see an access link in logs, or you can use /voidium web in‑game.

⚙️ Configuration

File: config/voidium/web.json

• port — HTTP port (default: 8081)
• language — panel language: en or cz
• publicHostname — hostname/IP used in the access URL

🔗 Access & auth

• The Web panel URL includes a token, for example: http://HOST:PORT/?token=UUID
• The token is generated on every server start.
• After the first successful load, a session cookie is set and used for future requests.
• Without a valid token or cookie, the panel returns 401 Unauthorized.

🧩 API & actions

The panel exposes a few HTTP endpoints:

Static assets

• GET / — React SPA entry (index.html, requires auth)
• GET /assets/* — hashed JS/CSS bundles (immutable cache)

Dashboard

• GET /api/dashboard — full server telemetry JSON (auth required)
• GET /api/feeds — chat + console feed snapshot
• GET /api/events — Server-Sent Events (SSE) stream, pushes dashboard data every 3 seconds

Actions (POST)

• POST /api/action (JSON payload with action field):
  • restart, reload, announce, maintenance_on/off
  • entitycleaner_preview/all/items/mobs/xp/arrows
  • vote_payout/clear/payout_all/clear_all
  • ticket_close/note/transcript

Config Studio API

• GET /api/config/schema — field definitions for all modules
• GET /api/config/values — current config values
• GET /api/config/defaults — factory defaults
• GET /api/config/locale — locale preset (en/cz)
• POST /api/config/preview — preview changes with impact flags
• POST /api/config/diff — diff current vs proposed values
• POST /api/config/apply — apply changes (creates backup)
• POST /api/config/rollback — rollback to last backup
• POST /api/config/reload — reload configs from disk

AI API

• POST /api/ai/admin — admin AI conversation
• POST /api/ai/admin/suggest — AI config suggestions
• GET /api/ai/players — player AI conversation history

Console

• POST /api/console/execute — execute allowlisted commands

Schema export

• GET /api/config/schema/export — full config schema in JSON Schema draft-07 format

Server management

• GET /api/server-icon — server favicon (PNG, no auth required)
• GET /api/server-properties — read server.properties as JSON key-value pairs
• POST /api/server-properties — write server.properties (JSON body with key-value pairs)

Discord roles

• GET /api/discord/roles — role list (requires Discord bot running)

🔒 Security notes

• The panel runs over plain HTTP; keep it on a trusted network or behind a reverse proxy.
• Don’t share the token URL.
• Restarting the server invalidates old tokens.- Rate limiting: AI endpoints (/api/ai/*) enforce 120 requests/minute per IP. Exceeding the limit returns HTTP 429 with Retry-After header.
• Theme & locale: Dark/light theme and language preference are stored in localStorage (client-side only).

  🧯 Troubleshooting

Panel doesn’t start

• Ensure enableWeb is true in general.json
• Check if the port is already in use

401 Unauthorized

• Use a fresh URL from logs or /voidium web
• The token changes after every server restart

Stats/Discord data missing

• Stats require enableStats
• Discord roles require Discord module to be enabled and connected

Next

• Configuration
• Commands