Moderation

Eranio

Moderation

Sperren und Stummschaltungen verwalten, mit Grund, Dauer und dem verantwortlichen Admin.

Übersicht

Oben stehen drei Kennzahlen: Gesperrte Spieler, Stummgeschaltet und Bekannte Spieler. Darunter liegen zwei Reiter, Sperren und Stummschaltungen, jeweils mit eigener Tabelle und Suchfeld (Spielername, Grund, verantwortlicher Admin). Beide Tabellen aktualisieren sich alle 30 Sekunden.

Aktion	Berechtigung
Listen ansehen	`hytale-admin.moderation-read`
Sperren, entsperren, stummschalten, Stummschaltung aufheben	`hytale-admin.moderation-manage`

Spieler werden in allen Formularen aus der Liste der bekannten Spieler gewählt (mit Suche), nicht von Hand eingetippt.

Sperren

Die Tabelle zeigt je Sperre Avatar, Spieler, Art (Permanent rot, sonst zeitlich begrenzt), Grund, verantwortlichen Admin und Zeitpunkt.

Datenquelle

Zuerst die Datei bans.json auf dem Server, gelesen über Pelicans Datei-Schnittstelle
Sonst die API des Java-Mods

Spieler sperren

Spieler sperren fragt nach Spieler und optionalem Grund.

Detail	Wert
API	`POST /api/bans`
Erfolg	„:player wurde gesperrt“
Fehler	„Spieler konnte nicht gesperrt werden“
Protokolliert als	`server:hytale-admin.ban-player`

Sperre aufheben

Sperre aufheben fragt nach einer Bestätigung. Das Plugin entfernt den Eintrag zuerst direkt aus bans.json und ruft nur, wenn das nicht klappt, die API auf (DELETE /api/bans/{name}).

Detail	Wert
Erfolg	„:player wurde entsperrt“
Fehler	„Die Sperre des Spielers konnte nicht aufgehoben werden“

Stummschaltungen

Die Tabelle zeigt je Stummschaltung Avatar, Spieler, Dauer (verbleibende Zeit wie „in 25 Minuten“, Abgelaufen grau oder Permanent rot), Grund, verantwortlichen Admin und Zeitpunkt.

Spieler stummschalten

Spieler stummschalten fragt nach Spieler, Dauer (Minuten) und optionalem Grund. Ein leeres Dauerfeld bedeutet dauerhaft.

Detail	Wert
API	`POST /api/mutes` mit `player`, `reason`, `muted_by`, `duration_minutes`
Erfolg	„:player wurde stummgeschaltet“
Fehler	„Spieler konnte nicht stummgeschaltet werden“

Die Dauer ist in Minuten: 60 sind eine Stunde, 1440 ein Tag.

Stummschaltung aufheben

Stummschaltung aufheben fragt nach einer Bestätigung (DELETE /api/mutes/{player}).

Detail	Wert
Erfolg	„Die Stummschaltung von :player wurde aufgehoben“
Fehler	„Die Stummschaltung des Spielers konnte nicht aufgehoben werden“

UUID zu Name

Sperren speichert Hytale mit UUID. Das Panel zeigt stattdessen den Spielernamen und sucht ihn in:

known_players.json
whitelist.json

Wird kein Name gefunden, steht die UUID da.

Fehlerbehebung

Sperrliste lädt nicht

bans.json gibt es erst nach der ersten Sperre
Pelicans Datei-Schnittstelle kann die Datei nicht lesen, Dateirechte prüfen
Auch die API antwortet nicht, Java-Mod und Verbindung prüfen

„Spieler konnte nicht gesperrt werden“

Verbindung zum Java-Mod unterbrochen, Status auf dem Dashboard prüfen

Stummschaltung hält falsch lange

Die Dauer ist in Minuten, 60 ist eine Stunde
Zeitzone des Servers kann von der des Panels abweichen

Sperre zeigt UUID statt Name

Der Spieler steht weder in known_players.json noch in whitelist.json
Neue Spieler übernimmt das Panel beim Öffnen von Dashboard oder Spielerseite (höchstens alle fünf Minuten)