TDClaim mit Datenbank und mehreren Backends
Mit FlammiCraft ausgelieferte Mod-Version: 4.30.0
Dedizierte Server verwenden ab TDClaim 4.28.0 die gemeinsame MariaDB, wenn in config/tdlibrary-database.toml unter [database] die Einstellung enabled = true gesetzt ist. Für mehrere Backends wird zusätzlich [cluster] aktiviert. Verwende auf allen Backends dieselbe Datenbank. Einzelspieler und dedizierte Einzelserver ohne aktivierte Datenbank verwenden die Weltdatei.
Welt-ID und erster Import
- Sichere die Weltordner und die Datenbank vor der Umstellung. Stelle zuerst eine Testkopie um.
- Gib jedem eigenständigen Weltstand eine dauerhafte, eindeutige Welt-ID. TDClaim verwendet die gemeinsame
world_idauf oberster Ebene incluster-node.tomloder die bisherige Angabe unter[tdclaim]. Stehen beide Angaben in der Datei, müssen sie gleich sein. Die Welt-ID bleibt beim Umzug des Weltordners erhalten. Ein Einzelserver mit Datenbank kann die ID automatisch erzeugen lassen. - Starte die Backends mit gesperrtem Spielerzugang für den Import. TDClaim prüft
data/tdclaim_claims.dataus jedem Weltordner und übernimmt die Daten. Die Datei bleibt als Stand vor der Umstellung erhalten. TDClaim merkt den Import indata/tdclaim_database.txt. Eine unterbrochene Erstübernahme verwendet beim nächsten Start die reservierte ID ausdata/tdclaim_database_pending.txt. - Prüfe Claims, Spawns, Vorlagen und offene Verkäufe je Welt, bevor Spieler wieder beitreten. Abweichende Daten unter derselben Welt-ID oder gleichnamige, abweichende Vorlagen führen zum Startabbruch. Kläre den Konflikt anhand der Sicherungen.
Daten und Verhalten
- Claims, Rechte, Blockregeln, Force-Load-Flächen, Änderungshistorie, gespeicherte Spawns und Verkäufe gehören zum jeweiligen Weltstand. Zwei eigenständige Overworlds dürfen an denselben Koordinaten unterschiedliche Claims haben. Betreibe einen Weltordner nur auf einem Backend gleichzeitig.
- Vorlagen und die Anzeige von Claim-Grenzen gelten clusterweit. Die Spielerauswahl berücksichtigt die Präsenz auf anderen Backends und das zentrale Spielerverzeichnis von TDLibrary.
- Grundstückskäufe verwenden das TDEconomy-Ledger und dieselbe Kauf-ID bei der Wiederaufnahme. TDClaim speichert Ergebnis und ausstehende Meldung gemeinsam und behält die Meldung, bis sie im aktiven TDLibrary-Archiv steht. Im Cluster ist dieses Postfach auf allen Backends verfügbar.
- Mit
forceLoadRequiresOnlineMember = trueundforceLoadUsesClusterPresence = truehalten Mitglieder auf anderen Backends die Flächen ihrer Claims geladen. Das Backend der Welt verwaltet die Chunk-Tickets.
Datenbankausfall und Wiederherstellung
Ein bereits umgestellter Weltstand braucht seine Datenbank zum Start. Im laufenden Betrieb nutzt TDClaim die zuletzt bestätigten Schutzdaten und lehnt fehlgeschlagene Schreibvorgänge ab. Nach einem Konflikt oder Ausfall die Ansicht aktualisieren und den Vorgang erneut versuchen. Ausstehende Verkäufe werden mit ihrer bestehenden Kauf-ID weiter geprüft.
Ab 4.30.0 leiht TDClaim seine Datenbankverbindungen aus dem gemeinsamen Pool von TDLibrary. Wartet ein Speichervorgang länger als eine Sekunde auf eine Zeile, die ein anderer Server gesperrt hält, wird er wie bei einem Ausfall abgelehnt; die Verbindung bleibt dabei bestehen. Bisher brach die Verbindung nach zwei Sekunden ab.
Sichere Weltordner, TDClaim-Daten und TDEconomy-Ledger zum selben Zeitpunkt. Bei einer Wiederherstellung gehören diese Stände zusammen. Die alte tdclaim_claims.dat enthält den Stand vor dem Import. Beim Umzug einer Welt den ursprünglichen Weltordner einschließlich seiner Importmarkierung mitnehmen.
Leere Datenbank nach einem Weltumzug
Eine bereits migrierte Welt kann mit einer leeren Claim-Datenbank starten. Fehlende Claims werden als leer initialisiert. Eine vor der Migration verbliebene Weltdatei dient dabei nicht als aktueller Bestand. Fehlt ein bereits registriertes Weltdokument nachträglich, stoppt das Laden zum Schutz der Berechtigungen. In der Claim-Verwaltung stammen Ersteller- und Berechtigtennamen pro Seite aus einer gemeinsamen Abfrage.