🌐 Web panel

✅ Setup

1. Zapni modul v config/voidium/general.json:
   • enableWeb: true
2. Uprav config/voidium/web.json (port, jazyk, hostname)
3. Restartuj server

Odkaz na panel uvidíš v logu, případně použij /voidium web in‑game.

⚙️ Konfigurace

Soubor: config/voidium/web.json

• port — HTTP port (default: 8081)
• language — jazyk panelu: en nebo cz
• publicHostname — hostname/IP v přístupovém URL

🔗 Přístup & auth

• URL obsahuje token, např.: http://HOST:PORT/?token=UUID
• Token se generuje při každém startu serveru
• Po prvním načtení se nastaví cookie session
• Bez tokenu/cookie vrací panel 401 Unauthorized

🧩 API & akce

Panel má několik endpointů:

Statické assety

• GET / — React SPA (index.html, vyžaduje auth)
• GET /assets/* — hashované JS/CSS bundly (immutable cache)

Dashboard

• GET /api/dashboard — kompletní telemetrie serveru (vyžaduje auth)
• GET /api/feeds — snapshot chatu + konzole
• GET /api/events — Server-Sent Events (SSE) stream, push dashboard dat každé 3 sekundy

Akce (POST)

• POST /api/action (JSON s polem action):
  • 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 — definice polí pro všechny moduly
• GET /api/config/values — aktuální hodnoty
• GET /api/config/defaults — tovární výchozí hodnoty
• GET /api/config/locale — lokální preset (en/cz)
• POST /api/config/preview — náhled změn s impact flagy
• POST /api/config/diff — diff aktuální vs navržené hodnoty
• POST /api/config/apply — aplikuj změny (vytvoří zálohu)
• POST /api/config/rollback — vrátí poslední zálohu
• POST /api/config/reload — reload konfigů z disku

AI API

• POST /api/ai/admin — admin AI konverzace
• POST /api/ai/admin/suggest — AI návrhy konfigurace
• GET /api/ai/players — historie AI konverzací hráčů

Konzole

• POST /api/console/execute — spustí povolené příkazy

Export schématu

• GET /api/config/schema/export — kompletní schéma konfigurace ve formátu JSON Schema draft-07

Správa serveru

• GET /api/server-icon — ikona serveru (PNG, bez auth)
• GET /api/server-properties — čtení server.properties jako JSON key-value
• POST /api/server-properties — zápis server.properties (JSON body s key-value páry)

Discord role

• GET /api/discord/roles — seznam rolí (vyžaduje běžící Discord bota)

🔒 Zabezpečení

• Panel běží přes HTTP; používej interní síť nebo reverse proxy.
• Nesdílej token URL.
• Restart serveru vždy invaliduje staré tokeny.
• Rate limiting: AI endpointy (/api/ai/*) mají limit 120 požadavků/minutu na IP. Po překročení vrací HTTP 429 s hlavičkou Retry-After.
• Téma & jazyk: Dark/light téma a jazyk se ukládají do localStorage (pouze na straně klienta).

🧯 Řešení problémů

Panel se nespustí

• Ověř enableWeb v general.json
• Zkontroluj, jestli port není obsazený

401 Unauthorized

• Použij čerstvé URL z logu nebo /voidium web
• Token se mění po restartu serveru

Chybí data pro Stats/Discord

• Stats vyžaduje enableStats
• Discord role vyžadují zapnutý a připojený Discord modul

Další

• Konfigurace
• Příkazy