Hytale Admin Dokumentation
Vollständige Serververwaltung für Hytale-Server — Spieler, Inventarberarbeitung, Moderation, Chat, Welt, Backups, Berechtigungen und KI-Log-Analyse über eine Java-Mod-REST-API.
Über das Hytale Admin Panel
Hytale Admin Panel ist ein Pelican-Panel-Plugin von Eranio, das eine umfassende Serververwaltung für Hytale-Gameserver bietet. Es kommuniziert mit einem eigens entwickelten Java-Mod auf dem Hytale-Server über eine lokale REST-API und ermöglicht Echtzeit-Spielerverwaltung, Inventarbearbeitung, Moderation, Chat-Überwachung, Weltkontrolle, Backups, Serverkonfiguration und ein granulares Berechtigungssystem — alles direkt aus dem Browser.
Hauptfunktionen
| Funktion | Beschreibung |
|---|---|
| Dashboard | Echtzeit-Serverstatus — Online-Spieler, TPS, Betriebszeit, Schnellaktionen |
| Spielerverwaltung | Kicken, Heilen, Teleportieren, Spielmodus setzen, OP/De-OP, Items geben, Inventar leeren |
| Inventar-Editor | Visueller Inventar-Editor — Drag-and-Drop, Rüstungsplätze, Itemsuche mit Auto-Vervollständigung |
| Moderation | Bannen/Entbannen, Stummschalten/Entstummen mit Gründen, Dauer und Admin-Zuordnung |
| Live-Chat | Echtzeit-Chat-Überwachung mit konfigurierbarem Abfrageintervall, Broadcast-Nachrichten |
| Weltverwaltung | Zeit und Wetter setzen, Warps erstellen/löschen/teleportieren |
| Backup-System | Drei Backup-Typen (Welt, Mods, Voll), Wiederherstellung mit Diff-basierter Dateiersetzung |
| Serverkonfiguration | Serverkonfiguration bearbeiten, Whitelist verwalten |
| Berechtigungen | 16 granulare Berechtigungen, benutzerdefinierte Berechtigungsgruppen, OP-Verwaltung |
| Aktivitätslog | Vollständiges Audit-Trail aller Admin-Aktionen über Pelicans Aktivitätsprotokollierung |
| KI-Log-Analyse | Gemini-gestützte Crash-Log-Analyse (kostenloser Tarif, max. 100 KB) |
| Demo-Modus | Vollständige Demo-Umgebung mit Testdaten ohne echte Servereffekte |
| Erinnerungstracker | Entdeckte Spielerinnerungen nach Kategorien verfolgen |
Architektur
Das Plugin besteht aus zwei Teilen:
- Panel-Plugin (PHP/Livewire) — Auf dem Pelican Panel installiert, stellt die Web-UI bereit
- Java-Mod (Serverseitig) — Auf dem Hytale-Server installiert, stellt eine REST-API auf einem konfigurierbaren Port bereit
Kommunikationsfluss:
Browser → Panel (Livewire) → Java-Mod-API (HTTP) → Hytale-Server
Der Java-Mod betreibt einen leichtgewichtigen HTTP-Server (Standard-Port 5550) und authentifiziert alle Anfragen mit einem X-Admin-Token-Header.
Datenspeicherung
Im Gegensatz zu den meisten Plugins speichert Hytale Admin keine Daten in der Panel-Datenbank. Alle Daten liegen auf dem Hytale-Server:
| Daten | Speicherort |
|---|---|
| API-Konfiguration | mods/Eranio_HytaleAdminAPI/config.json |
| Bekannte Spieler | mods/Eranio_HytaleAdminAPI/known_players.json |
| Ban-Liste | bans.json |
| Whitelist | whitelist.json |
| Serverkonfiguration | serverconfig.json |
| Berechtigungsgruppen | permissions.json |
| Erinnerungen | memories.json |
| Spieler-Speicherdateien | universe/players/*.json |
Voraussetzungen
- Pelican Panel 1.0.0 oder neuer
- PHP 8.1, 8.2 oder 8.3
- Das
hytale-admin-Feature auf deinem Egg - Ein Hytale-Server mit installiertem Eranio HytaleAdminAPI Java-Mod
- Port 5550 (Standard) erreichbar vom Panel zum Server (localhost oder internes Netzwerk)
- Optional:
GEMINI_API_KEYfür KI-Log-Analyse
Anleitungen
Installation & Einrichtung
# Installation & Einrichtung Vollständige Schritt-für-Schritt-Anleitung zur I...
Dashboard
# Dashboard Das Dashboard bietet eine Echtzeit-Übersicht über deinen Hytale-S...
Spielerverwaltung
# Spielerverwaltung Vollständige Anleitung zur Spieler-Seite — Online-/Offlin...
Moderation
# Moderation Vollständige Anleitung zum Moderationssystem — Bannen, Entbannen...
Chat
# Chat Echtzeit-Chat-Überwachung mit konfigurierbarem Polling, Ereignisfilter...
Weltverwaltung
# Weltverwaltung Weltzeit, Wetter und Warp-Punkte verwalten — alles aus dem B...
Backup-System
# Backup-System Drei Backup-Typen, Wiederherstellung mit intelligentem Diff-V...
Serverkonfiguration
# Serverkonfiguration Serverkonfiguration bearbeiten, Whitelist verwalten und...
Berechtigungen
# Berechtigungen Vollständige Anleitung zum Berechtigungssystem — 16 granular...