TDGroupe mit Datenbank und mehreren Servern
Mit FlammiCraft ausgelieferte Mod-Version: 0.29.0
Ab Version 0.23.0 kann TDGroupe Gruppen, Ränge, Einladungen, Titel und Aktivzeit in MariaDB statt im Weltordner speichern. Damit teilen sich mehrere Backend-Server eines Clusters denselben Stand. Ohne Datenbank bleibt alles wie bisher in der Welt.
Datenbank einschalten
Ab Version 0.26.0 hat TDGroupe keine eigene Datenbankeinstellung mehr. Ein dedizierter Server speichert in MariaDB, sobald in config/tdlibrary-database.toml unter [database] enabled = true steht. Dort stehen auch Verbindung (Host, Port, Datenbank, Benutzer, Passwort, TLS) und migration_conflicts: REFUSE bricht den ersten Datenbankstart ab, wenn die Datenbank schon andere Daten enthält, KEEP_DATABASE behält die Datenbankkopie. Änderungen anderer Backends liest TDGroupe im Abstand von [cluster] poll_millis. Einzelspielerwelten speichern immer in data/tdgroupe.dat und data/tdgroupe_titles.dat. Die Tabellen beginnen mit tdgroupe_ und werden beim ersten Start angelegt. Eine alte config/tdgroupe-database.toml wird nicht mehr gelesen und kann gelöscht werden.
Für mehrere Backends muss in tdlibrary-database.toml auf jedem Backend zusätzlich [cluster] aktiviert sein. Die eindeutige id und owned_dimensions stehen in cluster-node.toml im jeweiligen Serverordner. TDGroupe 0.27.0 benötigt TDLibrary 0.68.0 und denselben TDGroupe-Stand auf Servern und Clients.
Ab 0.28.0 leiht TDGroupe seine Datenbankverbindung aus dem gemeinsamen Pool von TDLibrary und benötigt TDLibrary ab 0.74.0. Wartet eine Änderung länger als drei Sekunden auf eine Zeile, die ein anderer Server gesperrt hält, scheitert sie mit einer Fehlermeldung und kann erneut versucht werden; die Verbindung bleibt dabei bestehen.
TDGroupe reserviert die Backend-ID world für importierte aktive Spielzeit. Beim ersten Datenbankstart übernehmen auch frische Welten die Titelregeln aus der Serverkonfiguration, wenn in der Datenbank noch keine Regeln stehen.
Was geteilt wird
- Gruppen, Mitglieder, Rollen, Farben, Namen, Spielerprofile, globale Ränge und ihre Zuweisungen.
- Einladungen und ausstehende Gruppenbenachrichtigungen. Ein gewähltes Backend übergibt bestätigte Meldungen an TDLibrary, unabhängig davon, wo der Empfänger gerade spielt. TDLibrary nimmt die Meldung in seine Warteschlange auf und archiviert sie vor dem Live-Hinweis. Postfach, Lesestand und Anzeigeeinstellungen folgen dem Spieler beim Serverwechsel.
- Titelbesitz, Auswahl, Sperren durch Widerruf und die Freischaltregeln aus dem Titel-Editor.
- Mitgliederlimit, Laufzeit neuer Einladungen, öffentliche Gruppennamen und die Inaktivitätsgrenze für den Titelfortschritt. Änderungen über
/tdgroupe configgelten clusterweit. Die Fristen bestehender Einladungen bleiben erhalten. - Aktivzeit. Jedes Backend zählt nur die Spieler, die gerade bei ihm spielen, in eine eigene Zeile. Die Summe aller Zeilen ergibt die Aktivzeit, deshalb wird beim Serverwechsel keine Sekunde doppelt gezählt oder verloren.
- Der private Gruppenchat, Wegpunkte und der Online-Status erreichen Mitglieder auf anderen Backends.
- Waystones-Teamfreigaben verwenden den geteilten Gruppenstand.
Titelkäufe laufen weiter über TDEconomy, ohne feste Versionsbindung. Einmal freigeschaltete Titel liegen in der Datenbank und gelten auf jedem Backend, auch wenn die Quest- oder Kaufdaten von TDEconomy nur auf einem Backend vorliegen.
Welten, Wegpunkte und Karten
Bei mehreren Welten in cluster-node.toml eine stabile world_id und die konkreten owned_dimensions eintragen. Zwei Overworlds brauchen verschiedene IDs. Ein Wegpunktlink enthält Welt und Dimension. Öffne ihn auf dem Backend, das diese Route bedient. Ohne eingetragene Route verwendet der Link die ID aus data/tdgroupe_world_id.txt der Welt.
Die Kartendateien bleiben in tdgroupe-maps auf dem Backend der jeweiligen Dimension. Beim ersten erfolgreichen Laden im Datenbankmodus bindet TDGroupe den aktiven Datensatz an data/tdgroupe_world_id.txt. Sichere diese Datei und das Kartenarchiv zusammen. Übernimm beim Weltumzug beides und behalte die konfigurierte world_id bei. Verwende für eine neue oder zurückgesetzte Welt eine eigene Welt-ID und einen frischen Kartendatensatz. Passt das Archiv zur ID einer anderen Welt, meldet der Server den Konflikt und lässt den Kartenabgleich gesperrt. Stelle die zusammengehörigen Dateien wieder her oder wähle den passenden Datensatz.
Erste Umstellung
Vorher eine Kopie der Welt und eine leere Testdatenbank verwenden, nicht die Produktivdatenbank.
- Server stoppen, in
tdlibrary-database.tomldie Verbindung eintragen und[database] enabled = truesetzen. - Server starten. Beim ersten Start mit vorhandenen Weltdateien kopiert TDGroupe
data/tdgroupe.datunddata/tdgroupe_titles.datnachtdgroupe-migration-backups/<Zeitpunkt>/, prüft sie vollständig und überträgt sie. Erst danach entfernt es die Weltdateien und legt die Markierungdata/tdgroupe_database.jsonan. - Stimmt ein vorhandenes Datenbankdokument mit der Welt überein, bleibt es unverändert. Weicht es ab, bricht der Start mit
REFUSEab, ohne etwas zu schreiben. Aktivzeit aus der Welt landet in der Zeileworld; ein zweiter Import derselben Welt zählt sie nicht doppelt. - Bei einem Cluster zuerst das Backend mit den bisherigen Daten umstellen (bisher Backend A), danach die übrigen mit frischen oder übereinstimmenden Welten.
Eine Welt mit der Markierung startet ohne eingeschaltete Datenbank nicht, damit sie nie unbemerkt mit leeren Gruppen läuft. Liegen trotz Markierung wieder Weltdateien vor, startet der Server ebenfalls nicht, bis eines von beiden bewusst entfernt ist.
Ohne erreichbare Datenbank startet ein Server mit eingeschalteter Datenbank nicht.
Bei einem bestehenden Cluster zuerst die alten Backends stoppen. Starte das aktualisierte Backend mit den gewünschten Gruppenregeln zuerst. Dessen Serverkonfiguration liefert die Startwerte für das neue Dokument group_rules. Starte die übrigen aktualisierten Backends mit ihren bisherigen Weltordnern, damit TDLibrary deren alte Postfächer und ausstehende Meldungen übernehmen kann. Im Datenbankmodus bearbeitet /tdgroupe config die gemeinsamen Werte, und der Reload stößt das erneute Lesen aus der Datenbank an. Ausstehende Schreibvorgänge und Konflikte zeigt /tdgroupe storage status.
Betrieb und Ausfälle
Änderungen gelten sofort auf dem eigenen Backend und werden im Hintergrund geschrieben. Jedes Dokument hat eine Revision. Hat ein anderes Backend zuerst geschrieben, führt TDGroupe die eigene Änderung mit dem neueren Stand zusammen: Änderungen an verschiedenen Gruppen oder Spielern bleiben beide erhalten. Ändern zwei Backends gleichzeitig dieselbe Gruppe oder die Titel desselben Spielers, gilt der zuerst geschriebene Stand. Würde das Zusammenführen eine Regel verletzen, etwa zwei Gruppen mit gleichem Namen, gilt der Datenbankstand vollständig.
Andere Backends lesen ein Änderungsprotokoll ohne Lücken. Fehlen Einträge, weil ein Backend zu lange nicht lesen konnte, lädt es den gesamten Stand neu.
Ist die Datenbank während des Spiels nicht erreichbar, lehnt TDGroupe Gruppen- und Titeländerungen von Spielern mit einer Meldung ab. Bereits lokal erfolgte Änderungen und Aktivzeit werden geschrieben, sobald die Datenbank wieder antwortet. Beim Stoppen wartet der Server kurz auf ausstehende Schreibvorgänge.
Aktivzeit wird alle 30 Sekunden und beim Abmelden geschrieben. Bei einem Absturz fehlen höchstens die letzten 30 Sekunden des abgestürzten Backends.
Befehle für Betreiber
/tdgroupe storage statuszeigt Modus, Backend, Datenbankzustand, Position im Änderungsprotokoll, Revisionen, ausstehende Änderungen sowie Zahl der Konflikte und Rückfälle./tdgroupe storage exportschreibt den geteilten Stand im Weltformat nachtdgroupe-export/<Zeitpunkt>/(tdgroupe.dat,tdgroupe_titles.datmit summierter Aktivzeit undtitle-rules.json).
Zurück zur Weltspeicherung
/tdgroupe storage exportausführen und den Server stoppen.- Die exportierten Dateien nach
data/kopieren unddata/tdgroupe_database.jsonlöschen. - Die Einstellungen aus
title-rules.jsonnachserverconfig/tdgroupe-server.tomlübernehmen. Die drei Gruppeneinstellungen stehen auf der obersten Ebene.idleSecondsund die Titelregeln gehören unter[titles]. [database] enabled = falseintdlibrary-database.tomlsetzen und starten. Das gilt für alle TD-Mods dieses Servers.
Abnahme
Quelltests prüfen das Übernehmen und Zusammenführen von Einstellungen, die Annahme einer Einladung auf einem zweiten Backend mit Abgleich auf einem dritten sowie die Trennung von Welten und Kartenarchiven. Lade für die Abnahme im Testcluster einen Offline-Spieler ein. Melde ihn auf einem anderen Backend an, prüfe Postfach und Annahme und wechsle danach erneut, um Mitgliedschaft und Lesestand zu prüfen. Wiederhole den Test mit einem Wechsel während der Zustellung. Prüfe bei zwei Overworlds mit unterschiedlichen Routen, dass ein Link sich nur in der Zielwelt importieren lässt.