Clusterbetrieb in 2.56.0
Mit FlammiCraft ausgelieferte Mod-Version: 2.64.0
Zahlungen für TDClaim-Mietverträge
Ab TDEconomy 2.62.0 verarbeitet das Backend mit der aktuellen Spieler-Kontensperre die Mietabbuchung. Bei einem Offline-Spieler ohne Kontosperre kann das anfragende Backend sie erwerben. TDEconomy berücksichtigt reserviertes Guthaben und speichert für jeden Zahlungsversuch einen gemeinsamen Beleg. Bei Neustart oder Verbindungsfehler bleibt eine eingereihte Zahlung unter derselben Kennung erhalten. Aktualisiere alle Economy-Backends vor dem Aktivieren von Mietangeboten. Sichere und restauriere TDClaim-Weltdaten und das gemeinsame Ledger zusammen.
Passende Builds manuell auf allen Backends und Clients installieren und vollständig neu starten. Die folgenden Abläufe sind implementiert und mit isolierten Backends und einer lokalen Testdatenbank geprüft. Die Spielabnahme steht noch aus.
Konten und Rechte
Kontodefinitionen, Namen und Rechte besitzen einen gemeinsamen Schreiber. Vor der Übernahme liest ein Backend den aktuellen Stand. Konkurrierende Änderungen und Zahlungen mit diesen Konten können kurzzeitig nicht verfügbar sein; kurz warten und erneut versuchen. Verwaltungsaktionen melden Erfolg erst nach der Datenbankbestätigung. Konflikte werden als fehlgeschlagene Speicherung gemeldet. System-Auszahlungssummen ändern sich atomar mit der Zahlung beziehungsweise bestätigten Lieferung, einschließlich Rückzahlungen und Wiederherstellung. Ein verspätetes Backend kann neuere Summen nicht überschreiben.
Überweisungen übernehmen alle benötigten Guthabensperren gemeinsam, einschließlich des empfangenden Kontos. Gegenseitige Überweisungen tauschen dadurch keine unvollständigen Sperrensätze endlos hin und her. Erstellung und Umbenennung von Konten werden zwischen Backends serialisiert. Doppelte gespeicherte Kontonamen stoppen das Laden, ohne eines der Konten zu entfernen. Bei diesem Fehler keine Kontodatensätze löschen.
Ab 2.57.0 legt der Datenbank-Worker beim Beitritt eine fehlende Spieler-Kontozeile in tdeconemy_accounts mit dem Startguthaben an. Ein erneuter Beitritt oder Backendwechsel erhält den gespeicherten Kontostand, auch bei null Funken. Bei einem Datenbankausfall bleibt die Anlage zur Wiederholung vorgemerkt. Bereits bekannte Spieler ohne Kontozeile werden beim nächsten Beitritt erfasst.
Shops und unterbrochene Käufe
Item- und Mobshops bestätigen im Datenbankmodus zuerst die Zahlung im Hintergrund. Danach prüft der Server Angebot, Entfernung, Rechte, Bestand und Platz erneut. Eine abgelehnte Zahlung liefert keine Ware. Die beteiligten Guthaben bleiben bis zur bestätigten Lieferung oder Rückzahlung gesperrt, auch wenn eine normale Kontosperre inzwischen abläuft.
Das Schließen eines Fensters storniert keinen bereits abgeschickten Kauf. Erst dessen Ergebnis abwarten. Ein Neustart zahlt eine nicht gespeicherte Lieferung zurück; eine gespeicherte Lieferbestätigung wird ohne zweite Zahlung wiederholt. Beim Löschen oder Deaktivieren des letzten Shopeintrags wird auch das gemeinsame Angebot anhand der bisherigen Dimension entfernt.
Questfortschritt und Weltspeicherung
Bestätigte Aktionsereignisse erhalten eindeutige IDs, den ursprünglichen Versuch und den Ereigniszeitpunkt. Nur der aktuelle Questschreiber verarbeitet sie. Ereignisbestätigung und Queststand werden gemeinsam gespeichert; doppelte Einlieferung erhöht den Fortschritt nicht erneut. Gespeicherte Warteschlangen überstehen Ausfälle und Neustarts des sendenden Backends. Ereignisse eines alten Versuchs zählen nicht für dessen Ersatz. Siehe Questfortschritt.
Ein Buchungsabschnitt gilt erst als gespeichert, wenn sein Economy-Marker tatsächlich aus der gespeicherten Weltdatei gelesen werden kann. Das Vorbereiten einer Speicherung oder eine feste Wartezeit beweisen keinen erfolgreichen Schreibvorgang.
Gemeinsame Benachrichtigungen
TDEconomy 2.62.0 benötigt TDLibrary ab 0.72.0. Kontomeldungen werden im TDLibrary-Postfach gespeichert. Der Hinweis auf dem Zielbackend folgt erst nach der Speicherung und prüft die aktuellen Kontorechte.
Ab 2.64.0 leiht TDEconomy seine Datenbankverbindungen aus dem gemeinsamen Pool von TDLibrary und benötigt TDLibrary ab 0.74.0. Eine Datenbankabfrage, die länger als 30 Sekunden hängt, wird abgebrochen; die Wirtschaft meldet die Datenbank dann als nicht verfügbar und erholt sich wie nach einem Ausfall. Wartet eine Buchung auf eine Zeile, die ein anderer Server gesperrt hält, versucht TDEconomy sie wie bisher bis zu dreimal mit je zehn Sekunden Wartezeit.
Schlägt das Schreiben der Weltdatei beim Export fehl, protokolliert das Backend den Fehler und verschiebt den Export bis zum nächsten Versuch. Die Meldungen werden erst nach erfolgreichem Speichern veröffentlicht.
Bestätigte Einladungen zu Gruppenkonten erscheinen im gemeinsamen Postfach. Über das Wirtschaftsmenü lassen sie sich annehmen oder ablehnen. Wenn ein anderes Backend gerade Kontometadaten ändert, kurz warten und die Antwort erneut versuchen.
Ab 2.58.0 liegen Bestands- und Auftragsmeldungen im Datenbankmodus in MariaDB. Das TDLibrary-Postfach zeigt berechtigte Meldungen auch nach einem Backendwechsel an. Eine aktive Warnung vom anderen Backend zeigt den Bestand als unverifiziert. Sobald das zuständige Backend die Warnung auflöst, übernimmt das Postfach ihren neuen Status.
Shop-Zugangsregeln zum Erstbeitritt verwenden den frühesten gespeicherten Zeitpunkt aus allen Backends. Kontobenachrichtigungseinstellungen gelten ebenfalls clusterweit. Jedes Backend importiert seine vorhandenen Erstbeitrittsdaten und Einstellungen zusammen mit den Meldungen. Weichen zwei gespeicherte Einstellungen für denselben Spieler und dasselbe Konto voneinander ab, stoppt der Import und protokolliert den betroffenen Schlüssel.
Admin-Shopvorlagen sind im Datenbankmodus auf allen Backends verfügbar. TDEconomy prüft den Standort und die Rechte beim Platzieren auf dem gewählten Backend. Der Import stoppt bei unterschiedlichen Vorlagen mit demselben Namen und erhält beide Bestände.
Vor dem gemeinsamen Versionswechsel alle TDEconomy-Backends anhalten und MariaDB zusammen mit ihren Welten sichern. Der erste Start aktualisiert das Datenbankschema von 2 auf 3. Jedes Backend sichert seine Weltdatei, übernimmt die eigenen Meldungen mit ihren bisherigen IDs in die Datenbank und entfernt den lokalen Bestand erst nach erfolgreicher Rückleseprüfung. Bei einem Konflikt bleibt die Weltdatei erhalten. Für eine Rückkehr zur früheren Version den zusammengehörigen Sicherungsstand wiederherstellen.
Weltnamen und Markt
TDEconomy unterscheidet Standorte nach Backend, Dimensions-ID und Koordinaten. OPs setzen einen Anzeigenamen mit /money cluster world-name <backend> <dimension> set <Name> oder entfernen ihn mit /money cluster world-name <backend> <dimension> reset. Ohne Anzeigenamen zeigt der Markt Dimensions-ID und Backend-ID. Kopierte Koordinaten enthalten die Backend-ID. Wegpunkte im Markt sind auf dem Shop-Backend verfügbar.
Die Marktübersicht zeigt die veröffentlichten Preise und fasst die Statistik der Backends zusammen. Auf einem anderen Backend bleibt ein Angebot sichtbar, der Bestand ist dort unverifiziert. Der Handel findet am Schild statt.
Das zuständige Backend speichert Handelszähler und Änderungen am Markt zusammen mit der bestätigten Lieferung. Beim Update ordnet TDEconomy alte Shop- und Queststandorte anhand der bisherigen Dimensionszuordnung zu. Fehlt eine eindeutige Zuordnung, stoppt der Start mit dem betroffenen Standort im Log.
Aufträge und Titel
Die Auftragstafel zeigt öffentliche Aufträge und berechtigte persönliche Aufträge anderer Backends. Verwaltung, Lieferung und Abholung finden auf dem angezeigten Backend statt. MariaDB speichert Auftragsstand, Reservierungen und zugehörige Buchungen zusammen. Inventar-Wiederherstellungsdaten bleiben in der Welt des ausführenden Backends.
Verdiente und gekaufte Titel sind clusterweit verfügbar. Eine Titelzahlung und die Freischaltung werden zusammen gespeichert. Die Chatmeldung bestätigt die Zahlung. Öffne anschließend das Titelmenü erneut, um den Titel zu nutzen. Der Import übernimmt frühere Freischaltungen. Starte beim gemeinsamen Update alle bisherigen Backends und prüfe deren Import, bevor Spieler wieder Titel kaufen.
Sicherung und Wiederherstellung
Beim Start ergänzen die Builds eine Quest-Ereigniswarteschlange und die Lieferbuchhaltung. Datenbank und alle Backend-Welten gemeinsam sichern und wiederherstellen. Bei Warte- oder Fehlermeldungen keine Buchungen, Questereignisse oder Sperrtabellen löschen. Serverlog und betroffene Buchung prüfen. Dauerhafte Fehler beim Lieferabschluss behalten die Zahlungssperre für eine kontrollierte Wiederherstellung bei.
Ein lokaler Build verändert weder Datenbankeinstellungen noch Welten. Installation, Datenbankstart und Spielabnahme bleiben Betreiberaufgaben.
Manuelle Abnahme
- Auf zwei Backends handeln, auch mit zwei Shops am selben Konto, und Items sowie Guthaben vergleichen.
- Ausgabenrechte auf einem anderen Backend entziehen. Während der Übergabe muss eine Aktion warten oder fehlschlagen; danach müssen Abhebung und Shopzahlung verweigert werden.
- Gruppenname und Rechte gleichzeitig bearbeiten. Beide bestätigten Änderungen und die ausdrückliche Ablehnung konkurrierender Speicherungen prüfen. Gleichzeitig denselben Kontonamen anlegen.
- Mit verschiedenen Spielern auf verschiedenen Backends Questfortschritt erzielen und vor sowie nach einem Portalwechsel vergleichen. Abschluss und Belohnung genau einmal prüfen.
- Einen Shop entfernen und Index sowie Angebot auf den anderen Backends kontrollieren.
- Ausfälle, unterbrochene Lieferungen und Schreibfehler nur in wegwerfbaren Testwelten mit separater Testdatenbank auslösen. Vor dem Vergleich neu verbinden und neu starten.
Bestehende Welt und leere Datenbank
Starte beim Neuaufbau zuerst ein Backend mit dem bisherigen Datenbankmarker. TDEconomy sichert seine Weltdatei unter tdeconomy-migration-backups und bindet die Welt an den neuen Bestand. Die alte Warteschlange bleibt in der Sicherung. Ohne ursprüngliche Buchungsbelege würde ihre Wiedergabe Zahlungen möglicherweise doppelt ausführen. Weitere Welten mit derselben alten Cluster-ID können folgen. Eine fremde befüllte Datenbank, eine abweichende Backend-ID und ein unvollständig gelöschtes Ledger bleiben gesperrt. Frühere Shop-Fristen gelten für Bestandskonten weiter. Bei neuen Spielern gilt der früheste beobachtete Login. Solange dieser Zeitpunkt geladen wird, wartet der Kauf an einem zeitbeschränkten Shop. Bei mehrdeutigen Spielernamen lässt sich das Ziel beim Admintransfer per UUID angeben.