Dashboard

Das Dashboard bietet eine Echtzeit-Übersicht über deinen Hytale-Server mit Live-Statusüberwachung, Schnellaktionen und Server-Gesundheitsindikatoren.

Status-Widget

Das Status-Widget fragt die Java-Mod-API alle 10 Sekunden via GET /status ab:

Metrik	Beschreibung
Online-Spieler	Aktuelle Spieleranzahl und -liste
TPS	Server-Ticks pro Sekunde (20 = optimal)
Betriebszeit	Zeit seit dem letzten Serverstart
Server-Version	Hytale-Server-Version und Revision

TPS-Gesundheitsindikatoren

TPS-Bereich	Status	Bedeutung
18-20	Gesund	Server läuft flüssig
15-18	Warnung	Leichte Verzögerung, bei Dauer untersuchen
<15	Kritisch	Erhebliche Verzögerung, Serverlast prüfen

Schnellaktionen

Je nach Berechtigungen bietet das Dashboard Schnellaktions-Buttons:

Aktion	Erforderliche Berechtigung	API-Aufruf
Online-Spieler anzeigen	`hytale-admin.players-read`	`GET /players`
Spieler kicken	`hytale-admin.players-manage`	`POST /players/{name}/kick`
Broadcast senden	`hytale-admin.chat-broadcast`	`POST /chat/broadcast`
Server-Version anzeigen	`hytale-admin.dashboard`	`GET /version`

Aktivitätslog-Tab

Mit der Berechtigung hytale-admin.activity zeigt das Dashboard ein aktuelles Aktivitätsprotokoll — alle über das Panel durchgeführten Admin-Aktionen:

Kicks, Bans, Entbannungen
Teleportationen, Spielmoduswechsel
Inventaränderungen
Konfigurationsänderungen
Backup-Operationen

Aktivitäten werden mit Pelicans eingebauter activity_logs-Tabelle unter dem Präfix server:hytale-admin.* protokolliert.

Der Aktivitätslog-Tab aktualisiert sich alle 30 Sekunden.

Demo-Modus

Den Demo-Modus vom Dashboard aus aktivieren, um alle Funktionen ohne Auswirkung auf den echten Server zu testen:

Verwendet DemoDataService und DemoInventoryService für Testdaten
Alle Aktionen zeigen Erfolgsmeldungen ohne echte API-Aufrufe
Identicon-Avatare für Demo-Spieler generiert
Nützlich für Schulungen, Screenshots oder UI-Tests

Demo-Modus ist sitzungsbasiert — zurückgesetzt bei Navigation oder Seitenaktualisierung.

Installierte Mods

Das Dashboard zeigt auch eine Liste installierter Java-Mods auf dem Server via GET /mods. Das hilft sicherzustellen, dass der HytaleAdminAPI-Mod zusammen mit eventuellen anderen Server-Mods geladen ist.

Fehlerbehebung

Dashboard zeigt keine Daten

Server ist möglicherweise offline — Serverstatus im Pelican prüfen
Java-Mod möglicherweise nicht geladen — mods/-Verzeichnis prüfen
API-Verbindung fehlgeschlagen — storage/logs/laravel.log auf „Hytale API error: /status" prüfen
Port 5550 möglicherweise blockiert — Firewall-Regeln überprüfen

TPS zeigt 0 oder sehr niedrig

Server startet gerade (normal während der ersten 30 Sekunden)
Server überlastet — CPU-/RAM-Auslastung prüfen
Weltkorruption — Serverkonsole auf Fehler prüfen

Aktivitätslog ist leer

Noch keine Admin-Aktionen durchgeführt
Benutzer hat keine hytale-admin.activity-Berechtigung
Problem mit der Aktivitätsprotokollierungs-Tabelle — Datenbank prüfen