Hytale Admin Dokumentation
Vollständige Serververwaltung für Hytale-Server, Spieler, Inventarberarbeitung, Moderation, Chat, Welten und Spielerwelten, Abenteuer, 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 | Welten anlegen, einstellen, zurücksetzen, auslagern und löschen, Hytale-Warps, Zeit und Wetter |
| Abenteuer (Hytale 0.7) | Welt-Ereignisse, Portal-Zeit, Stufen der Void-Invasion, aktive Instanzen auf dem Dashboard |
| Spielerwelten | Spieler legen im Spiel eigene Welten an, mit Mitgliedern, Gästen, /tpa und Sperre nach jedem Neustart |
| Backup-System | Drei Backup-Typen (Welt, Mods, Voll), Wiederherstellung mit Diff-basierter Dateiersetzung |
| Serverkonfiguration | Serverkonfiguration bearbeiten, Whitelist verwalten |
| Berechtigungen | 17 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 |
| Erinnerungen | Entdeckte Erinnerungen nach Kategorien auf einer eigenen Seite |
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 |
| Spielerwelten | mods/Eranio_HytaleAdminAPI/player-worlds.json |
| Weltart und Besitzer | mods/Eranio_HytaleAdminAPI/worlds-meta.json |
| Warps | Hytales TeleportPlugin (eigene warps.json) |
| Ausgelagerte und gelöschte Welten | universe/worlds-parked/, universe/worlds-trash/ |
| Spieler-Speicherdateien | universe/players/*.json |
Voraussetzungen
- Pelican Panel 1.0.0-rc.1 oder neuer
- PHP 8.5
- 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 Ins...
Eranio
Dashboard
# Dashboard Das Dashboard bietet eine Echtzeit-Übersicht über deinen Hytale-Ser...
Eranio
Spielerverwaltung
# Spielerverwaltung Vollständige Anleitung zur Spieler-Seite, Online-/Offline-S...
Eranio
Moderation
# Moderation Sperren und Stummschaltungen verwalten, mit Grund, Dauer und dem v...
Eranio
Chat
# Chat Server-Chat, Spielerereignisse, Tode und das Aktivitätslog des Panels in...
Eranio
Weltverwaltung
# Weltverwaltung Die World-Seite verwaltet alle Welten des Servers: dauerhafte...
Eranio
Spielerwelten
# Spielerwelten Mit HytaleAdminAPI 1.14 legen Spieler im Spiel eigene Welten an...
Eranio · 13.10.2026
Erinnerungen
# Erinnerungen Hytales Erinnerungen (entdeckte Kreaturen, Orte und Hintergrundw...
Eranio · 13.10.2026
Backup-System
# Backup-System Backups erstellen, wiederherstellen und löschen. Die Seite zeig...
Eranio
Mods
# Mods Die Seite **Mods** zeigt alle Mods im Mod-Ordner des Servers, prüft, ob...
Eranio · 15.10.2026
Serverkonfiguration
# Serverkonfiguration Die Hytale-Serverkonfiguration, die Whitelist und die Rec...
Eranio
Berechtigungen
# Berechtigungen Vollständige Anleitung zum Berechtigungssystem, 17 granulare B...
Eranio
Changelog
# Changelog ## v2.9.5 (2026-10-16) - Removed the "Skip Mod Validation For Versi...
Eranio · 13.10.2026