Zum Hauptinhalt springen

TDClaim mit Datenbank und mehreren Backends

Mit FlammiCraft ausgelieferte Mod-Version: 4.30.0

Handbuch · English

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

  1. Sichere die Weltordner und die Datenbank vor der Umstellung. Stelle zuerst eine Testkopie um.
  2. Gib jedem eigenständigen Weltstand eine dauerhafte, eindeutige Welt-ID. TDClaim verwendet die gemeinsame world_id auf oberster Ebene in cluster-node.toml oder 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.
  3. Starte die Backends mit gesperrtem Spielerzugang für den Import. TDClaim prüft data/tdclaim_claims.dat aus jedem Weltordner und übernimmt die Daten. Die Datei bleibt als Stand vor der Umstellung erhalten. TDClaim merkt den Import in data/tdclaim_database.txt. Eine unterbrochene Erstübernahme verwendet beim nächsten Start die reservierte ID aus data/tdclaim_database_pending.txt.
  4. 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 = true und forceLoadUsesClusterPresence = true halten 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.