Mysql-Whitelist

EN – Revised Description

🧩 Summary: MySQL-Based Whitelist System for Hytale

This system uses a MySQL database to control access to a Hytale server.
Whitelist entries can be managed externally, for example via a forum, website, or any other synchronization system.

🔁 How It Works

Username registration

• A player registers their Hytale in-game username in an external system (e.g. forum or web panel).

• The username is stored in the MySQL database.

Whitelist verification

• The plugin synchronizes the database regularly.

• For each username, the server resolves the official Hytale UUID using the Hytale profile service.

• The player is automatically added to the whitelist without needing to join the server first.

Live whitelist synchronization

• If a username is removed from the database:

  • whitelist access is revoked immediately

  • if the player is currently online, they are instantly kicked from the server

⚡ Key Features

• Centralized MySQL-based whitelist

• External management via forum or web panel

• Automatic UUID resolution (no initial server join required)

• Live synchronization without server restart

• Immediate removal of access when a database entry is deleted

🧠 Short Description

The Hytale server continuously synchronizes its whitelist with a MySQL database.
Usernames stored in the database are resolved to their official UUIDs and granted access automatically.
Removing an entry instantly revokes access — even while the player is online.

DE – Überarbeitete Beschreibung

🧩 Funktionsbeschreibung: MySQL-Whitelist-System für Hytale

🗄️ Zentrales und extern verwaltbares Whitelist-System

Dieses System nutzt eine MySQL-Datenbank, um den Zugriff auf einen Hytale-Server zu steuern.
Whitelist-Einträge können über ein Forum, ein Webinterface oder ein anderes externes System gepflegt werden.

🔁 Ablauf im Detail

Externe Registrierung des Benutzernamens

• Ein Spieler trägt seinen Hytale-Ingame-Namen in einem Forum oder Verwaltungstool ein.

• Der Benutzername wird in der MySQL-Datenbank gespeichert.

Whitelist-Synchronisation

• Das Plugin synchronisiert regelmäßig die Datenbank.

• Für jeden Benutzernamen wird serverseitig die offizielle Hytale-UUID ermittelt.

• Der Spieler wird automatisch auf die Whitelist gesetzt
  ohne den Server vorher betreten zu müssen.

Dynamische Whitelist-Verwaltung

• Wird ein Benutzer aus der Datenbank entfernt:

  • wird der Whitelist-Zugriff sofort entzogen

  • ist der Spieler online, wird er direkt vom Server gekickt

⚡ Wichtige Eigenschaften

✅ Zentrale MySQL-basierte Whitelist
🔄 Live-Synchronisation mit der Datenbank
🌐 Forum- oder Web-Anbindung möglich
🚫 Kein Server-Neustart erforderlich
🧹 Entfernen aus der DB = sofortiger Whitelist-Entzug

🧠 Kurzfassung

Der Hytale-Server gleicht seine Whitelist automatisch mit einer MySQL-Datenbank ab.
Benutzernamen werden serverseitig zur offiziellen UUID aufgelöst und freigeschaltet.
Wird ein Eintrag entfernt, verliert der Spieler sofort den Zugriff – auch während er online ist.