Spielerverwaltung

Eranio

Spielerverwaltung

Vollständige Anleitung zur Spieler-Seite, Online-/Offline-Spieler anzeigen, Spieleraktionen (Kicken, Heilen, Teleportieren, Spielmodus, OP, Sperren), Inventarbearbeitung und Items geben.

Spielerliste

Oben stehen vier Kennzahlen: Gerade online, Bekannte Spieler, Offline und Häufigster Spielmodus.

Die Tabelle zeigt alle bekannten Spieler aus zwei zusammengeführten Quellen:

Quelle	Wofür	Daten
Java-Mod-API (`GET /api/players`)	Online-Spieler	Name, UUID, Position, Spielmodus, Werte
Speicherdateien (`universe/players/*.json`)	Offline-Spieler	Letzte Werte, Inventar, letzte Position

Online gilt immer die API, für Offline-Spieler die Speicherdatei. Meldet der Server 0 Spieler online, die API aber noch Spieler, werden alle als offline angezeigt.

Neue Spieler aus den Serverdateien übernimmt das Panel automatisch beim Öffnen von Dashboard oder Spielerseite (höchstens alle fünf Minuten je Server) und trägt sie in known_players.json ein. Einen Knopf dafür gibt es nicht mehr.

Die Tabelle aktualisiert sich alle 15 Sekunden. Der Filter Status zeigt nur Online- oder nur Offline-Spieler.

Spalten

Spalte	Beschreibung
Avatar	Kopf des Spieler-Skins (Identicon im Demo-Modus)
Name	Spielername, mit Status online oder offline
Spielmodus	Aktueller Spielmodus
Abenteuer	Aktuelle Welt, Hinweis auf Instanz, Größe, Wildnis-Karte und gesperrte Debug-Anzeige als Abzeichen
Gesundheit, Ausdauer, Mana, Verteidigung	Aktuelle Werte
Position	X, Y, Z

Aktionen-Menü

Jeder Online-Spieler hat ein Drei-Punkte-Menü mit zwei Abschnitten mit Titel.

Abenteuer

Aktion	Wirkung
Zu Spieler	Teleportiert zu einem anderen Spieler, auch weltübergreifend
Zum Spawn	Schickt den Spieler zum Spawn seiner aktuellen Welt
In Welt schicken	Teleportiert den Spieler zum Spawn einer anderen geladenen Welt
Zurück / Vor	Geht durch den Teleport-Verlauf (Hytales `/back`)
Größe	Skaliert den Spieler von 25 bis 400 %
Wildnis-Karte	Wildnis-Debug-Karte an oder aus
Instanz öffnen	Öffnet eine Instanz aus einer Vorlage und schickt den Spieler hinein; beim Verlassen kehrt er an seine alte Position zurück
Instanz verlassen	Holt den Spieler aus der Instanz
Debug-Anzeige	Sperrt oder erlaubt die Debug-Anzeige (F3)

Die Spielerkarte zeigt aktuelle Welt (mit Hinweis auf Instanz), Größe, Wildnis-Karte und gesperrte Debug-Anzeige als Abzeichen.

Spieler verwalten

Kicken, Heilen, Teleportieren, Spielmodus, OP und Inventar-Aktionen wie unten beschrieben.

Spieleraktionen

Inventar öffnet den Inventar-Editor (siehe unten). Die übrigen Aktionen liegen im Menü Spieler verwalten:

Aktion	Nur online	Berechtigung	Meldung bei Erfolg	Meldung bei Fehler
Heilen	ja	`players-manage`	„:player wurde vollständig geheilt“	„Der Spieler konnte nicht geheilt werden“
Teleportieren (X, Y, Z)	ja	`players-manage`	„:player wurde teleportiert“	„Spieler konnte nicht teleportiert werden“ oder der Grund vom Mod
Spielmodus setzen	ja	`players-manage`	„Der Spielmodus von :player ist auf :gamemode gesetzt“	Fehlermeldung
Gegenstand geben (Gegenstand, Menge)	ja	`players-inventory`	„:amount x :item gegeben an :player“	„Gegenstand konnte nicht gegeben werden“ oder der Grund vom Mod
Inventar löschen	ja	`players-inventory`	„Das Inventar von :player wurde gelöscht“	„Das Löschen des Inventars ist fehlgeschlagen“
OP / De-OP	nein	`players-manage`	„:player ist jetzt Operator“ / „:player ist kein Operator mehr“	Fehlermeldung
Kicken	ja	`players-manage`	„:player wurde gekickt“	„Spieler konnte nicht gekickt werden“
Spieler sperren (Grund)	nein	`players-manage`	„:player wurde gesperrt“	„Spieler konnte nicht gesperrt werden“

Berechtigungen sind hier ohne das Präfix hytale-admin. angegeben. Sperren über die Spielerseite braucht players-manage, auf der Moderationsseite moderation-manage. Alle Aktionen landen im Aktivitätslog.

Inventar-Editor

Der visuelle Inventar-Editor erfordert die Berechtigung hytale-admin.players-inventory.

Online vs. Offline Bearbeitung

Spielerstatus	Methode	Latenz	Risiko
Online	Java-Mod-API	Echtzeit	Gering, API validiert Änderungen
Offline	Direkte Speicherdatei-Bearbeitung	Sofort	Mittel, keine Validierung, Vorsicht geboten

Inventar-Bereiche

Bereich	Plätze	Beschreibung
Rüstung	4	Kopf, Brust, Hände, Beine
Hilfsmittel	4	Plätze für Hilfsmittel
Hotbar	9	Schnellleiste
Lagerung	36	Hauptinventar
Rucksack	je nach Rucksack	Erscheint mit der Kapazität des getragenen Rucksacks
Freigeschaltete Gegenstände	Liste	Einzigartige Gegenstände, die der Spieler freigeschaltet hat (nur Anzeige)

Bearbeitet wird erst nach einem Klick auf Bearbeiten im Fenster (Berechtigung hytale-admin.players-inventory). Danach öffnet ein Klick auf einen Platz das Platz-Menü mit Menge ändern, Ersetzen (Gegenstandsauswahl) und Löschen. Gegenstände lassen sich zwischen Plätzen verschieben.

Rüstungs-Slot-Filterung

Items werden nach passendem Rüstungsslot per Suffix gefiltert:

_Head → Nur Kopf-Slot
_Chest → Nur Brust-Slot
_Hands → Nur Hände-Slot
_Legs → Nur Bein-Slot

Slot-Operationen

Platz setzen: Erfolg „Slot erfolgreich aktualisiert“

Platz löschen: Erfolg „Steckplatz :section #:slot gelöscht“

Verschieben: Erfolg „Gegenstand wurde verschoben“

Item-Suche

Die Item-Suchfunktion (GET /items/search) hat besonderes Verhalten:

Max. 50 Ergebnisse um Livewire-Snapshot-Aufblähung zu verhindern
Rückwärtssuche für nicht-englische Panels: Übersetzte Item-Namen werden auf englische Schlüssel zurückgemappt, dann via API mit englischen Begriffen gesucht
Auto-Vervollständigung mit Debounce
Base64-Item-Icons aus Item-Daten extrahiert für visuelle Darstellung

BSON-Kompatibilität: Spieler-Speicherdateien verwenden json_decode($content, false) (NICHT assoziative Arrays), da Hytale eine BSON-ähnliche Kodierung nutzt, bei der die Unterscheidung zwischen {} (Objekt) und [] (Array) wichtig ist.

Fehlerbehebung

Spielerliste ist leer

Keine Spieler haben je den Server betreten
Java-Mod läuft nicht (API nicht erreichbar)
known_players.json fehlt, Dashboard oder Spielerseite neu öffnen, das Panel liest die Spielerdateien dann neu ein

Online-Spieler wird als offline angezeigt

Veralteter-API-Schutz ausgelöst: Status meldet 0 online, API gibt aber noch Spieler zurück
Nächste Aktualisierung abwarten (15 Sekunden)

Inventar-Editor lädt nicht

Spieler-Speicherdatei fehlt oder ist beschädigt
Bei Online-Spielern: API-Endpunkt hat Fehler zurückgegeben
storage/logs/laravel.log auf „Hytale API error" prüfen

„Item-Gabe fehlgeschlagen" mit spezifischem Fehler

Ungültige Item-ID, Schreibweise des Item-Namens prüfen
Menge außerhalb des Bereichs
Die API gibt spezifische Fehlermeldungen in $result['error'] zurück

Speicherdatei-Bearbeitung, Probleme

Niemals Speicherdateien bearbeiten, während ein Spieler online ist, der Server überschreibt die Änderungen
Der Offline-Editor modifiziert das JSON direkt, Fehler können die Datei beschädigen
Speicherdatei vor größeren Änderungen sichern