Architektur & Übersicht
Eranio
Architektur & Übersicht
HytaleAdminAPI (aktuelle Version 1.15.0, gebaut gegen Hytale Server 0.7.0) ist ein Server-Mod, der im Hytale-Server läuft und eine JSON-REST-API über HTTP bereitstellt. Das Pelican-Plugin Hytale Admin nutzt sie, aber jeder Client mit dem Token kann sie aufrufen.
- Port: Standard
5550, einstellbar - Bind-Adresse: Standard
0.0.0.0, mit127.0.0.1nur lokal erreichbar - Anmeldung: Header
X-Admin-Tokenbei jeder Anfrage - Format: JSON hin und zurück, CORS offen (
Access-Control-Allow-Origin: *)
Handler
Jeder Bereich hat einen eigenen Handler, eingetragen als HTTP-Kontext:
| Kontext | Handler | Bereich |
|---|---|---|
/api/status |
StatusHandler | Serverzustand, Ressourcen |
/api/stats |
StatsHandler | JVM-Werte |
/api/version |
VersionHandler | Version und Protokoll |
/api/players |
PlayersHandler | Spieler, Aktionen, Inventar |
/api/bans |
BansHandler | Banns |
/api/mutes |
MutesHandler | Stummschaltungen |
/api/chat |
ChatHandler | Chat, Ereignis-Logs, Rundnachricht |
/api/world |
WorldHandler | Zeit und Wetter |
/api/warps |
WarpsHandler | Hytale-Warps (TeleportPlugin) |
/api/items |
ItemsHandler | Item-Katalog |
/api/icons |
IconsHandler | Item-Bilder |
/api/permissions |
PermissionsHandler | Benutzer, Gruppen, OP |
/api/whitelist |
WhitelistHandler | Whitelist |
/api/serverconfig |
ServerConfigHandler | Hytales config.json |
/api/deaths |
DeathTrackerHandler | Tode |
/api/memories |
MemoriesHandler | Erinnerungen |
/api/backup |
BackupHandler | Backups |
/api/adventure |
AdventureHandler | Welt-Ereignisse, Portale, Instanzen, Spieler-Werkzeuge |
/api/worlds |
WorldsHandler | Weltverwaltung |
/api/playerworlds |
PlayerWorldsHandler | Einstellungen und Übersicht der Spielerwelten |
Threads
Hytale führt jede Welt auf einem eigenen Thread. Handler, die Objekte lesen oder ändern (Spieler, Inventar, Teleports, Welteinstellungen), führen diesen Teil als Aufgabe auf dem Welt-Thread aus und warten darauf (meist bis zu 5 Sekunden). Abfragen ohne Weltzugriff (Status, bekannte Spieler, Konfigurationsdateien) laufen direkt auf dem HTTP-Thread.
Befehle im Spiel
Neben der API trägt der Mod diese Befehle ein:
| Befehl | Alias | Zweck |
|---|---|---|
/gamemode |
/gm |
Ersetzt Hytales Befehl und protokolliert jede Nutzung |
/meinewelt |
/myworld |
Fenster für Spielerwelten |
/tpa <Spieler> |
/tpanfrage |
Teleport-Anfrage |
/tpaccept |
/tpannehmen |
Anfrage annehmen |
/tpdeny |
/tpablehnen |
Anfrage ablehnen |