Zum Hauptinhalt springen

Ranglisten mit TD LeaderBoard nutzen

Mit FlammiCraft ausgelieferte Mod-Version: 1.18.0

TD LeaderBoard zeigt Vanilla-Spielerstatistiken an. Kontostände gehören nicht dazu. Die gleiche kompatible Mod und die benötigten Bibliotheken müssen auf Client und Server vorhanden sein.

Die Verbindungsprüfung verlangt passende Nachrichtenkanäle und Protokoll 5. Release-Nummern und JAR-Inhalte werden dabei nicht verglichen; auf beiden Seiten sollte derselbe Build verwendet werden.

Die gewünschte Rangliste anzeigen

  1. TAB für die kompakte Liste halten oder /tdleaderboard für die Vollbildansicht verwenden.
  2. Kategorie und Sortiermetrik wählen. Eine ausgewählte Metrik wird zugleich als Spalte sichtbar.
  3. Zeitraum Gesamt, aktuelle Kalenderwoche oder aktueller Kalendermonat wählen.
  4. Mit Suchbegriff und Enter beziehungsweise Search filtern. To me entfernt die Suche und springt zur eigenen Platzierung.
  5. Einen Namen für Details auswählen. Für einen neuen Detailstand zur Rangliste zurückkehren und erneut öffnen.

Im Datenbankbetrieb sind Statistiken anhand der UUID gemeinsam gespeichert und Spieler auf anderen Cluster-Backends können als online erscheinen. Der Erstimport benötigt lesbare Vanilla-Statistiken und einen Namen. Fehlt der Name lokal, fragt die Mod im Datenbankbetrieb die gemeinsame TDLibrary-Namenshistorie ab. Play Time enthält AFK-Zeit und Mob Kills umfasst auch nicht feindliche Mobs. Wochen beginnen montags um 00:00 UTC, Monate am Monatsersten. Die Perioden zählen Zuwächse ab Messbeginn.

Gemeinsame Datenbank und Cluster

Mit aktualisierten TDUtilities-Builds der Version 1.29.0 auf Clients und allen Backends werden auch die WATUT-AFK-Kennzeichen synchronisiert. TD LeaderBoard zeichnet sie anhand der UUID auch für fremde Spieler ohne lokalen TAB-Eintrag. Die bisherigen AFK-Anzeigeoptionen bleiben maßgeblich; die sichtbaren Symbole sind nach dem manuellen Einbau im Cluster zu prüfen.

TDLibrary 0.74.0 oder neuer muss auf beiden Seiten vorhanden sein. Auf allen Backends in config/tdlibrary-database.toml die Abschnitte [database] und [cluster] aktivieren, dieselbe MariaDB verwenden und in cluster-node.toml jeweils eine eindeutige id setzen. Weitere Leaderboard-Zugangsdaten sind nicht nötig. Einzelspieler und Server ohne aktivierte Datenbank behalten die lokale Speicherung.

Gesamt-, Wochen- und Monatswerte kommen aus der gemeinsamen Datenbank. Jeder Knoten addiert die lokal beobachteten Fortschritte. Ein Login setzt eine neue lokale Zählerbasis. Schreibquittungen verhindern Doppelzählungen bei Wiederholungen. Hintergrundabfragen starten regulär alle 20 Server-Ticks, sobald der vorige Auftrag fertig ist. Für Sichtbarkeit und Ping anderer Spieler muss eine aktuelle Sitzung zum von TDLibrary gemeldeten Backend passen. Ein verspätetes Logout der vorherigen Sitzung kann die neuere Sitzung nicht verdrängen. Aktualisiere TD LeaderBoard auf allen Backends, damit sie Sitzungsdaten veröffentlichen.

Beim Erstimport zählt der zeitlich früheste erfasste Vanilla-Stand als Ausgangswert für die UUID. Getrennte alte Gesamtstände können Kopien derselben Aktivität enthalten und werden deshalb einzeln als mögliche Ausgangswerte geprüft. Halte die Backend-Uhren für Ausgangswerte, Sitzungen und UTC-Perioden synchron. Bei Datenbankfehlern bleiben die zuletzt geladenen Ranglistenwerte sichtbar. Gesicherte Proben werden nach einem Neustart mit ihrem ursprünglichen Schreibbeleg eingespielt. Erfasst ein Prozess Proben unmittelbar vor einem Absturz, können die seit dem letzten lokalen Sicherungspunkt erfassten Zuwächse verloren gehen.

Sichere td_leaderboard_player, td_leaderboard_sample und td_leaderboard_session gemeinsam. Solange ausstehende Proben vorhanden sind, sichere auch data/tdleaderboard-outbox/ des jeweiligen Weltordners. Behalte beim Wiederanlauf dieselbe Backend-ID und den zugehörigen Datenbankstand. Die neue Sitzungstabelle wird beim Start der Datenbanksynchronisation angelegt und füllt sich mit neuen Spielerbeobachtungen.

Tabellen der früheren unveröffentlichten Datenbankvorschau sind mit diesem Schema inkompatibel. Die Mod meldet den Konflikt und erhält die vorhandenen Daten. Vor der Umstellung Vorschautabellen sichern und ein frisches Leaderboard-Schema verwenden.

Automatisierte Tests prüfen Zuwächse, Schreibwiederholungen, Periodengrenzen und die Wiederherstellung. Ein Minecraft-Clusterlauf mit Mining-/Nether-Wechseln, Verbindungsabbrüchen und Neustarts muss noch manuell abgenommen werden. Die englische Referenz beschreibt Einzelheiten.

Ranglistenstatistiken zurücksetzen

Aktualisiere vor einem Reset alle Backends mit Zugriff auf die gemeinsame Datenbank auf TD LeaderBoard 1.18.0 oder neuer. Die Befehle stehen bei aktiver Datenbankspeicherung ab Operatorstufe 4 und in der Serverkonsole zur Verfügung.

  • /tdleaderboard reset player <Name|UUID> setzt die Werte eines Spielers zurück, auch wenn er offline ist. Der Name wird über die gemeinsame Namenshistorie von TDLibrary aufgelöst. Verwende bei unbekannten oder mehrdeutigen Namen die UUID.
  • /tdleaderboard reset all confirm setzt die Werte aller Spieler zurück, auch für Offline-Spieler, deren lokale Statistiken noch auf den Import warten.

Der Reset setzt alle fünf Metriken der Gesamt-, Wochen- und Monatsranglisten in einer Transaktion auf null. Die Bestätigung erscheint nach dem Speichern. Jedes Backend übernimmt den Reset bei der nächsten erfolgreichen Synchronisation und zählt ab seiner nächsten Live-Messung neu. Alte ausstehende Messwerte können die früheren Ranglistenwerte nicht wiederherstellen. Die Vanilla-Statistiken dienen weiterhin als Messquelle.

Sichere auch die automatisch angelegte Tabelle td_leaderboard_reset zusammen mit den übrigen Leaderboard-Tabellen. Sie hält fest, welche ausstehenden Messwerte und historischen Importe die Datenbank annehmen kann.

Eine Tafel aufstellen

Beide Welt-Tafeln benötigen zwei Blöcke Breite, vier Höhe und festen Boden unter beiden Basispunkten. Die Items haben kein Crafting-Rezept und sind im Creative-Tab Functional Blocks verfügbar.

Als Operator beziehungsweise Einzelspielerhost rechtsklicken, Metrik und optional einen Titel bis 48 Zeichen wählen und Done verwenden. Ohne Betreiberrechte öffnet Rechtsklick die vollständige Rangliste. Eine Welt-Tafel zeigt stets ihre Gesamtmetrik, unabhängig vom Zeitraum im persönlichen Bildschirm.

Beim Abbau eines beliebigen Teils wird die gesamte Struktur mit einem frischen Item zurückgegeben. Frühere Tafeleinstellungen werden dabei nicht im Item behalten.

Anzeige und Fehlerhilfe

Persönliche Spalten und Sortierung liegen in config/tdleaderboard-client.toml. Kleine Fenster können einen Größenhinweis oder den Vanilla-TAB-Fallback zeigen; eine bestimmte GUI-Skalierung ist nicht vorgeschrieben.

Ab Version 1.12.0 unterstützt die optionale AFK-Anzeige auch den aktuellen TDUtilities-Statusrenderer. Ältere unterstützte Manager bleiben nutzbar. Ohne aktives integriertes Modul oder bei installiertem standalone WATUT bleiben die normalen Statussymbole erhalten. Die API-Auflösung wird mit automatisierten Tests geprüft; die sichtbaren AFK-Symbole in TAB und Vollbild müssen im Spiel manuell abgenommen werden.

Bei fehlenden Offline-Namen den Importstatus sowie lokalen Profilbestand und im Datenbankbetrieb die TDLibrary-Namenshistorie prüfen. Bei abweichenden Wochenwerten Beginn der Messung und UTC-Grenze beachten. Bei lokaler Speicherung data/tdleaderboard_periods.dat zusammen mit der Welt sichern. Die englische Referenz beschreibt Einzelheiten.

Spielernamen werden aus der jüngsten gespeicherten Beobachtung aufgelöst. Eine leere Namenshistorie liefert keinen Namen.