العربية Беларуская Български Čeština Dansk Deutsch Ελληνικά English Español Suomi Français עברית Magyar Bahasa Indonesia Italiano 日本語 한국어 Lietuvių Nederlands Norsk ☠ Pirate Polski Português (BR) Português (PT) Română Русский Slovenčina Српски Svenska Türkçe Українська 简体中文 繁體中文

Moderation

Moderation

Vollständige Anleitung zum Moderationssystem — Bannen, Entbannen, Stummschalten, Entstummen mit Gründen, Dauern und Admin-Zuordnung.

Ban-System

Datenquellen

Das Ban-System nutzt duale Datenquellen mit Fallback:

  1. Primär: bans.json-Datei auf dem Server — direkt über die Daemon-Datei-API gelesen
  2. Fallback: Java-Mod-API — verwendet wenn die Datei nicht verfügbar ist

Spieler bannen

Detail Wert
Berechtigung hytale-admin.moderation-manage
API POST /players/{name}/ban
Body { "reason": string, "admin": string }
Erfolg „Spieler gebannt: {player}"
Fehler „Ban fehlgeschlagen"
Protokolliert als server:hytale-admin.ban

Spieler entbannen

Nutzt Dual-Strategie:

  1. Versucht zuerst den Eintrag direkt aus bans.json zu entfernen
  2. Fällt auf API-Aufruf POST /players/{name}/unban zurück wenn Dateiänderung fehlschlägt
Detail Wert
Berechtigung hytale-admin.moderation-manage
Erfolg „Spieler entbannt: {player}"
Fehler „Entbannung fehlgeschlagen"

Die Ban-Tabelle aktualisiert sich alle 30 Sekunden.

Stummschaltungs-System

Spieler stummschalten

Detail Wert
Berechtigung hytale-admin.moderation-manage
API POST /players/{name}/mute
Body { "duration": int, "reason": string, "admin": string }
Dauer In Minuten
Erfolg „Spieler stummgeschaltet: {player}"
Fehler „Stummschaltung fehlgeschlagen"

Dauer ist in Minuten, nicht Sekunden oder Stunden. Eine 1-Stunden-Stummschaltung = duration: 60.

Spieler entstummen

Detail Wert
Berechtigung hytale-admin.moderation-manage
API POST /players/{name}/unmute
Erfolg „Spieler entstummt: {player}"
Fehler „Entstummung fehlgeschlagen"

UUID → Namensauflösung

Die Moderationsanzeige löst UUIDs in Spielernamen auf mittels einer Nachschlagetabelle aus:

  1. known_players.json — primäre Quelle
  2. whitelist.json — Fallback für gewhitelistete Spieler

Falls kein Name gefunden wird, wird die rohe UUID angezeigt.

Fehlerbehebung

Ban-Liste lädt nicht

  • bans.json existiert möglicherweise noch nicht (keine Bans vergeben)
  • Daemon-Datei-API kann Datei nicht lesen — Berechtigungen prüfen
  • Auch der Fallback zur API ist fehlgeschlagen — API-Verbindung prüfen

„Ban fehlgeschlagen"

  • Spielername stimmt möglicherweise nicht exakt überein (Groß-/Kleinschreibung beachten)
  • API-Verbindung unterbrochen — Java-Mod-Status prüfen

Stummschaltungsdauer scheint falsch

  • Dauer ist in Minuten — 60 = 1 Stunde, nicht 1 Minute
  • Server-Zeitzone kann von Panel-Zeitzone abweichen

Ban zeigt UUID statt Name

  • Spieler nicht in known_players.json oder whitelist.json gefunden
  • Spieler entdecken auf der Spieler-Seite ausführen um die Liste zu aktualisieren
Spielerverwaltung Chat