Zum Hauptinhalt springen

Mit TDGroupe gemeinsam spielen

Mit FlammiCraft ausgelieferte Mod-Version: 0.29.0

TDGroupe verwaltet Spielergruppen, Gruppenchat, Titel und optionale Karten- und Waystones-Integrationen. Eine Spielergruppe ist kein TDEconomy-Geschäftskonto und verkauft keine Claims. Diese Anleitung beschreibt den aktuellen Quellstand; Server und Clients müssen kompatible Builds verwenden.

Gruppe gründen und Mitglieder aufnehmen

  1. /tdgroupe oder das Drei-Personen-Symbol im Inventar öffnen. Mit FTB Library liegt es in dessen Seitenleiste, andernfalls oberhalb der rechten Inventarkante.
  2. Eine freie Gruppe mit einem eindeutigen Namen von 3 bis 32 Zeichen anlegen. Pro Spieler ist nur eine Mitgliedschaft möglich.
  3. Namen und eine der 16 Textfarben wählen und speichern. Linksklick schaltet Farben vorwärts, Rechtsklick rückwärts.
  4. Als Besitzer oder Manager einen bekannten Online- oder Offline-Spieler einladen.
  5. Der Eingeladene nimmt im Dialog, per Chat-Schaltfläche oder mit /tdgroupe accept an. /tdgroupe decline lehnt ab.

Eine Einladung reserviert keinen Mitgliederplatz. Beim Annehmen werden Mitgliedschaft, Kapazität, Frist und Einladungsrecht erneut geprüft. Neue Welten verwenden standardmäßig sieben Tage; bestehende Einstellungen und bereits ausgegebene Fristen bleiben erhalten. Den Erfolg erkennst du an der Mitgliedsliste, nicht allein an der gesendeten Einladung.

Rollen und Eigentum

Besitzer können Einstellungen und Rollen ändern, Mitglieder verwalten, Eigentum übertragen und die leere Gruppe auflösen. Manager dürfen einladen, Einladungen zurückziehen und gewöhnliche Mitglieder entfernen. Sie dürfen keine anderen Manager oder den Besitzer entfernen und keine Rollen oder Gruppeneinstellungen ändern.

Mitglieder können austreten. Vor dem Austritt eines Besitzers muss das Eigentum übertragen werden; alternativ erst alle anderen Mitglieder entfernen und die Gruppe auflösen. Nach einer Übertragung wird der frühere Besitzer gewöhnliches Mitglied. Kritische Aktionen verlangen eine Bestätigung.

Ein verknüpftes Economy-Konto bleibt ein eigener Berechtigungsbereich. Dessen Verknüpfung im Gruppen-Dashboard prüfen; aus einer sichtbaren Gruppe folgt weder Zugriff auf Geld noch automatisch ein Claim-Recht.

Mit TDEconomy und bestehender Gruppe liegen erhaltene Einladungen und verknüpfte Konten auf getrennten Schaltflächen nebeneinander. Darunter folgen Gruppenchat und Statusmeldungen. Nur der aktuelle Gruppenbesitzer kann die Kontenverwaltung öffnen.

Chat, Wegpunkte und Waystones

/gc <Nachricht>, /teammsg <Nachricht> und das vorhandene Minecraft-Kürzel /tm <Nachricht> erreichen die aktuell verbundenen Gruppenmitglieder. TDGroupe ersetzt den Vanilla-Teamchat-Handler; Scoreboard-Teams bestimmen weder Empfänger noch Zugriffsrechte. Alle drei Aufrufe verwenden dasselbe Chatlimit und geben den Nachrichtentext ohne Selektorauflösung weiter. Unvollständige Ausdrücke wie @e[ bleiben auch für OPs normaler Nachrichtentext. Öffentliche Gruppentags lassen sich serverseitig ausblenden, der private Gruppenchat behält den Gruppennamen.

In Xaero einen Wegpunkt auswählen und Share with group verwenden. In der Zielwelt öffnet der Chatlink den Xaero-Importdialog. Meldet der Link eine andere Welt, wechsle zum Backend der Zielwelt und öffne ihn dort erneut. Ohne Xaero bleiben die Koordinaten lesbar.

Waystones' Share for team verwendet bei vorhandener Integration die aktuelle TDGroupe-Mitgliedschaft des Besitzers. Nach einem Gruppenwechsel eine bereits offene Zielliste erneut öffnen. Persönlich aktivierte und öffentliche Ziele behalten die normalen Waystones-Regeln.

Gemeinsame Karte und Wiederherstellung

Mit Xaero's World Map wird persönliche Erkundung auch ohne Gruppe auf dem Server archiviert. Aktuelle Gruppenmitglieder erhalten zusätzlich hochgeladene Kartenteile der anderen Mitglieder. Die Karte mit Xaeros konfigurierter Taste öffnen; standardmäßig ist dies M. Vorhandene Dimensionen aktivieren und den schrittweisen Import abwarten. Es werden keine unbekannten Weltgebiete erzeugt.

Nach einem lokalen Kartenverlust kann nur zuvor erfolgreich hochgeladene Erkundung mit derselben Spieleridentität zurückkommen. Wegpunkte und XaeroPlus-Sonderdarstellungen sind kein Teil dieses Archivs. Empfangene fremde Kartenkenntnis verschwindet beim Gruppenaustritt nicht nachträglich.

Ab Version 0.16.0 setzt laufende Erkundung den Kartenimport nicht mehr zurück: Nur geänderte Teile werden erneut vorgemerkt, und wartende Regionen lassen andere Regionen sofort weiterarbeiten. Kartenkopien und Übernahmen teilen sich pro Bild ein Planungsbudget von einer Millisekunde; ein bereits begonnener Kartenteil wird noch abgeschlossen. Bis zu 16 Übertragungen je Richtung überbrücken Wartezeiten auf Bestätigungen, bei weiterhin begrenztem Pufferspeicher. Das ist keine zugesicherte Übertragungsdauer oder Ruckelfreiheit; beides muss mit euren Karten und Rechnern im Spiel geprüft werden.

Ab Version 0.18.0 wartet der Abgleich, bis Xaero einen Kartenteil etwa drei Sekunden lang nicht mehr neu geschrieben hat; spätestens nach zwanzig Sekunden wird er trotzdem geprüft. Unveränderte Kartenteile werden anhand eines Prüfwerts erkannt und weder neu kodiert noch erneut angeboten. Für den Abgleich gespeicherter Regionen fordert TDGroupe höchstens alle zwei Sekunden eine Region bei Xaero an und nur, wenn Xaeros eigene Ladeliste leer ist; empfangene Kartenteile höchstens alle 0,25 Sekunden. Bereits geladene Regionen kommen zuerst an die Reihe, und der Abgleich drängt sich nicht mehr vor die Regionen, die gerade auf der Karte angesehen werden. Empfangene Kartenteile werden im Hintergrund vollständig vorbereitet. Dadurch wird beim Abgleich in Xaero weniger Arbeit pro Bild erledigt. Die Prüfung im Spiel mit großen Karten steht nach Quelltests und Build separat aus.

Außerdem lädt ein Login nicht mehr die gesamte Karte erneut hoch oder herunter. Jeder Client speichert im Ordner .tdgroupe-sync seiner Xaero-Karte, welche Kartenteile er bereits hat. Der Server schickt pro Region nur einen kurzen Prüfwert; abweichende Regionen werden verglichen, und nur fehlende oder geänderte Kartenteile werden übertragen. Gespeicherte Regionen werden nur erneut geprüft, wenn sich ihre Xaero-Datei geändert hat, und ein Kartenteil wird nur hochgeladen, wenn er sich vom zuletzt bestätigten Upload unterscheidet. Empfangene Kartenteile werden zuerst auf die Festplatte geschrieben und eingefügt, sobald Xaero ihre Region geladen hat; sie überstehen auch einen Neustart. Neue Kartenteile werden kompakter kodiert, ältere Archiveinträge bleiben lesbar. Die Bandbreite begrenzen mapDownloadKiBPerSecond in serverconfig/tdgroupe-server.toml (Standard 1024 KiB/s je Spieler) und mapUploadKiBPerSecond in config/tdgroupe-client.toml (Standard 512 KiB/s).

Neue Beiträge für denselben Chunk und Kartenlayer teilen sich die Geländedaten, wenn die gespeicherten Bytes übereinstimmen. Der Client sendet zuerst einen 48-Byte-Nachweis aus dem Inhaltshash und einem spielergebundenen Prüfwert. Liegt die gleiche Kachel bereits im Archiv, kann der Server den neuen Spieler ohne erneuten Gelände-Upload eintragen. Jeder Spieler behält einen eigenen Erkundungsnachweis, auch über Gruppengrenzen hinweg. Lädt ein Spieler später verändertes Gelände hoch, behalten die anderen ihre bisherige Fassung. Eine Datei umfasst bis zu 4 × 4 Chunks einer Dimension und eines Layers. Vorhandene Einzeldateien funktionieren weiter. Ihr Platz wird beim Update nicht automatisch frei.

Für die Verdichtung eine vollständige Offline-Kopie oder einen unveränderlichen Sicherungsstand verwenden. Im TDGroupe-Quellprojekt mit Java 21 ./gradlew compactMapArchive --args='"quelle/tdgroupe-maps" "ziel/tdgroupe-maps"' ausführen (unter Windows mit gradlew.bat). Absolute Pfade angeben. Der Zielordner muss neu sein, sein übergeordnetes Verzeichnis bereits existieren und außerhalb der Quelle liegen. Platz für beide Kopien einplanen. Der Export verdichtet das aktive Dataset und kopiert inaktive Datasets und Begleitdateien. Anschließend öffnet er das Ergebnis erneut und vergleicht jeden Spieler, jede Position und alle Geländedaten. Bei einem Fehler nennt er das unfertige Arbeitsverzeichnis. Zur Übernahme den Server vom letzten Quellabzug bis zum Austausch gestoppt halten, das Original separat aufbewahren und die geprüfte Kopie als vollständiges Verzeichnis tdgroupe-maps einsetzen. Für ältere Builds die Sicherung vor dem Update verwenden.

Server und alle Clients gemeinsam auf diesen Build mit Kartenprotokoll 12 aktualisieren und vollständig neu starten. Lokale Karten, die Ordner .tdgroupe-sync und .tdgroupe-received sowie das Serverarchiv erhalten; ältere .tdgroupe-received-Markierungen werden beim ersten Start einmalig übernommen und nicht verändert. Der erste Login danach baut den Abgleichstand auf, ohne bereits archivierte Kartenteile erneut hochzuladen. Wer .tdgroupe-sync verliert, bekommt fehlende Kartenteile einfach erneut vom Server; zum Nachholen keine Dateien löschen und keine Dataset-ID ändern. Der Abgleich startet nach der Archivprüfung automatisch für die aktive Xaero-Dimension. Bereits erkundete Gebiete müssen nicht erneut abgelaufen werden, solange ihre persönlichen lokalen Kartendaten vorhanden sind. Die Prüfung mit mehreren Spielern, Dimensionswechseln und erneutem Laden steht nach Quelltests und Build separat aus.

Betreiber müssen das externe Verzeichnis tdgroupe-maps zusätzlich zur Welt sichern. Die Dataset-ID darf bei einem Weltwechsel nicht versehentlich weiterverwendet oder bei einer Reparatur gelöscht werden. Die Umstellung vom alten data/tdgroupe_maps.dat importiert dessen alleinigen Bestand nicht: Clients müssen ihre persönliche Erkundung erneut anbieten. Die englische Referenz beschreibt den vollständigen Wechsel- und Sicherungsablauf.

Beim Serverstart werden sämtliche externen Kartenbeiträge geprüft, bevor der Abgleich freigegeben wird. Bis zu vier Hintergrundleser prüfen jeweils bis zu 32 Dateien pro Auftrag. Höchstens acht Aufträge sind gleichzeitig offen, auf kleinen CPUs entsprechend weniger. Bei längeren Prüfungen meldet das Serverlog etwa alle zehn Sekunden die bereits geprüfte Anzahl. Bestehende Archivdateien der Formate 1 und 2 sowie eine vorhandene alte data/tdgroupe_maps.dat bleiben erhalten. Bei einem Fehler bleibt der Abgleich für diesen Lauf gesperrt. Die gemeldete Datei erhalten und die Ursache untersuchen. Die tatsächliche Startdauer lässt sich nach manuellem Update und Neustart messen.

Große Karten werden Region für Region nachgeladen. Bei der Rückkehr in eine Dimension vergleicht der Client den gespeicherten Abgleichstand erneut und fordert fehlende Kartenteile an. Kurze Windows-Dateisperren fängt der Speicherthread mit Wiederholungsversuchen ab, bevor der Client den Upload erneut senden muss.

Titel und Einstellungen

/tdgroupe title öffnet My titles. Titel suchen, Bedingungen prüfen und einen eigenen Titel auswählen oder verbergen. Bei einem Kauf vor der Bestätigung Titel, exakten Preis und persönliches Guthaben prüfen. Ein Flammtaler entspricht 100 Funken. Gib im Titel-Editor oder Kaufbefehl 9,99 oder 9.99 für 9 Flammtaler und 99 Funken ein. Ein explizit gewählter Titel bleibt bei späteren Freischaltungen ausgewählt.

Betreiber öffnen /tdgroupe config für Mitgliederlimit, neue Einladungsfristen, öffentliche Gruppennamen und die Inaktivitätsgrenze. Im Datenbankmodus gelten diese Änderungen clusterweit. Ein kleineres Limit entfernt keine vorhandenen Mitglieder. Persönliche Symbolversätze liegen in config/tdgroupe-client.toml. Die lokale Serverkonfiguration und den Umstieg beschreibt Datenbank und mehrere Server.

Problem Vorgehen
Einladung kann nicht angenommen werden Mitgliedschaft, freie Plätze, aktuelle Rolle des Einladenden und Ablauf prüfen.
Karte ergänzt sich nicht Xaero-Version, aktive Dimension, tatsächliche Gruppenmitgliedschaft und Bereitschaft des Serverarchivs prüfen.
Fremde Kartenteile zeigen Stein statt eines Mod-Blocks Der Block stammt aus einer Mod, die nur das hochladende Mitglied installiert hat; das Clientlog nennt ihn einmalig. Gleiche Modliste installieren; bereits empfangene Stellen werden erst korrekt gezeichnet, wenn das Mitglied sie neu erkundet.
Kartenarchiv meldet einen Fehler Berichteten Dateifehler untersuchen und geprüft sichern; kein leeres Ersatzarchiv anlegen.
Gekaufter Titel fehlt Kaufstatus prüfen und erneut verbinden; nicht sofort nochmals kaufen. Dauerhafte Freischaltungen werden ohne zweite Zahlung nachgeliefert.
Server startet nicht wegen tdgroupe_database.json Die Welt wurde in die Datenbank übertragen. In tdlibrary-database.toml [database] enabled = true setzen oder nach Datenbank und mehrere Server zur Weltspeicherung zurückkehren.
Meldung, die Gruppendatenbank sei nicht erreichbar /tdgroupe storage status prüfen; Änderungen nach Rückkehr der Datenbank erneut versuchen.