Zum Hauptinhalt springen

TDClaim bedienen

Mit FlammiCraft ausgelieferte Mod-Version: 4.30.0

TDClaim schützt Gebiete über die volle Welthöhe oder innerhalb ausgewählter Höhengrenzen. Serveroperatoren verwalten die Claims. Der eingetragene Ersteller benötigt eine eigene Freigabe für den Zugriff. Server und Clients benötigen kompatible Builds. Diese Anleitung beschreibt den Quellstand für Minecraft 1.21.1.

Voraussetzungen und Wechsel

TDLibrary ab 0.74.0 einschließlich LDLib2 wird benötigt. Open Parties and Claims (openpartiesandclaims) und FTB Teams (ftbteams) sind inkompatibel. Die OpenPAC-Anbindung entfällt. Vor dem manuellen Wechsel bestehende fremde Claims separat sichern und ihren gewünschten Ersatz prüfen; TDClaim importiert oder löscht sie nicht. Inventarzugriffe verwenden weiterhin die aktuellen Schutzentscheidungen.

Ein Gebiet anlegen

TDClaim 4.30.0 und TDLibrary ab 0.74.0 gehören auf Server und Clients, LDLib2 auf beiden Seiten. Der Testserver verwendet NeoForge 21.1.256 und LDLib2 2.2.46.a. Die Installationsreferenz beschreibt Kompatibilität und Updates. Siehe Datenbank und Cluster für die gemeinsame Speicherung.

  1. Als Operator /tdclaim öffnen und Create claim wählen.
  2. Den Surveyor's Staff über die Oberfläche beziehen. Standardmäßig ist dies tdclaim:claim_tool; eine vorhandene Serverkonfiguration kann ein anderes Werkzeug festlegen.
  3. Mit dem Werkzeug in der Haupthand links auf die erste und rechts auf die zweite Ecke klicken. Beide Ecken müssen in derselben Dimension liegen. X, Y und Z beider Eckblöcke zählen zur Auswahl. Etagen können denselben Grundriss verwenden, wenn sich ihre Y-Bereiche nicht überschneiden.
  4. Zur Verwaltung zurückkehren, etwa mit Umschalt-Rechtsklick mit dem Werkzeug. Einen Namen vergeben und die Auswahl als Claim anlegen.
  5. Im Reiter Claims das neue Gebiet auswählen und ausdrücklich die gewünschten Spieler- oder Gruppenrechte vergeben.

Mit Volle Welthöhe in der Claim-Übersicht lässt sich ein begrenzter Claim ohne neue Auswahl nach oben und unten erweitern. Der Grundriss bleibt erhalten. Falls die Erweiterung einen anderen Claim überdecken würde, lehnt TDClaim sie ab. Bestehende Claims ohne gespeicherte Höhengrenzen behalten beim Upgrade die volle Welthöhe.

Claims dürfen nicht überlappen und höchstens 4096 Chunks berühren. Eine Vorschau ist noch kein gespeichertes Gebiet; den Abschluss erkennst du am Eintrag in der Claims-Liste. Beim Verkleinern entfallen Blockregeln außerhalb der neuen Grenzen.

Namen und Claim-Suchtexte dürfen höchstens 64 Zeichen enthalten, der Dimensionsfilter 128. Bei einer zu langen Eingabe nennt die Oberfläche beim Absenden das zu kürzende Feld. Der Entwurf bleibt auch beim Schließen und erneuten Öffnen erhalten.

Rechte verständlich vergeben

Öffentliche Rechte bilden die Grundregel. Persönliche Regeln haben Vorrang vor Gruppenregeln; bei mehreren Gruppen gewinnt eine Verweigerung auf derselben Entscheidungsebene. Inherit entfernt nur die gewählte Ausnahme. Reset entfernt alle Ausnahmen des ausgewählten Subjekts. Bulk-Allow und Bulk-Deny verändern mehrere Rechte und verlangen deshalb eine bewusste Bestätigung.

Im Gruppeneditor zwischen TDGroup-Spielergruppen und TDEconomy-Geschäftsgruppen wechseln. Gleichnamige Gruppen verschiedener Systeme sind unabhängig. Bei TDGroupe lassen sich die ganze Gruppe oder genau Besitzer, Manager und Mitglieder wählen. Eine ausdrückliche Rollenregel ersetzt die allgemeine Gruppenregel für die betreffende Aktion; eine geerbte Rolle fällt darauf zurück. Einladungen allein gewähren keinen Zugriff.

Zum Prüfen Inspect & manage → Inspector öffnen, einen Spieler und die relevante Position wählen. Der Bericht nennt die entscheidende TDClaim-Regel. Er ist keine Freigabe durch andere Schutzmods.

Die Claim-Umrandung setzt ein aktives persönliches oder Gruppenrecht voraus. Alte Shop- und Kontoterminalrechte allein schalten sie nicht frei; ihre gespeicherten Ausnahmen bleiben erhalten.

Grundstücke kaufen

Grundstücksverkäufe sind standardmäßig aus. Setze claimSalesEnabled = true in tdclaim-server.toml. TDEconomy ab 2.62.0 muss mit storage = "DATABASE" laufen. Server und Clients benötigen zueinander passende Mod-Versionen.

  1. Nimm als OP ein Grundstücks-Kaufschild aus dem Kreativinventar unter Werkzeuge & Hilfsmittel und stelle es im gewünschten Claim auf. Für die Platzierung gelten die normalen Baurechte.
  2. Öffne den Editor mit Strg+Rechtsklick. Wähle ein bekanntes Spieler-, Gruppen- oder endliches Systemkonto für den Erlös. Ein bekannter Spieler darf offline sein. Gib einen positiven Preis in Flammtalern mit höchstens zwei Nachkommastellen ein und wähle die einzelnen Nutzungsrechte.
  3. Aktiviere das Angebot. Eine grüne Tafel zeigt ein aktives Angebot an. Eine goldene Tafel zeigt die ausstehende Zahlung. Vor dem Abbauen eines aktiven Schilds deaktiviere das Angebot im Editor.
  4. Als Käufer öffnest du die Kaufansicht per Rechtsklick. Dort siehst du den Claim-Namen, den Preis mit dem Währungszeichen von TDEconomy und die einzelnen Rechte. Ein Flammtaler entspricht 100 Funken. Kaufen belastet dein Privatkonto. Sobald Zahlung und Freigabe gespeichert sind, verschwindet das Schild.

Ein neues Angebot überträgt nach bestätigter Zahlung das Eigentum im Claim-System an den Käufer. Die ausgewählten Nutzungsrechte gelten für seine Spieler-UUID. Das Serverteam verwaltet weitere Freigaben und die Claim-Grenzen. Bereits konfigurierte Angebote zur Grundstücksnutzung behalten ihre bisherigen Bedingungen. Nur diese älteren Nutzungsfreigaben lassen sich über Gekaufte Freigabe entziehen zurücknehmen.

Während einer ausstehenden Zahlung bleibt das Angebot reserviert. Nach einem Neustart oder einer Datenbankunterbrechung gleicht TDClaim die vorhandene Kauf-ID ab. Ein Konflikt mit einer bereits vorhandenen Buchung bleibt gesperrt und wird mit der Kauf-ID protokolliert. Sichere und restauriere Welt und TDEconomy-Datenbank gemeinsam. Die In-Game-Abnahme mit echten Clients und MariaDB ist ein separater Schritt. Im Datenbankmodus erscheint das Ergebnis auch nach einem Backendwechsel im TDLibrary-Postfach.

Wohnungen und Shops mieten

TDClaim und TDEconomy ab 2.62.0 benötigen für die Miete den Datenbankmodus. Aktualisiere alle TDEconomy-Backends, die Spieler-Kontensperren halten können, bevor du Mietangebote aktivierst.

  1. Stelle als OP ein Grundstücks-Mietschild so im Claim auf, dass man es vom Eingang aus erreichen kann. Öffne es mit Strg+Rechtsklick. Wähle den Kontotyp, gib den exakten Namen des Empfängerkontos und den Wochenpreis in Flammtalern ein und wähle die persönlichen Nutzungsrechte.
  2. Trage für eine optionale Gratiszeit dieselbe Angebotsgruppe auf den zugehörigen Schildern ein. Die erste Aktivierung mit Gratistagen legt die gemeinsame Dauer fest. Mit null Gratistagen kostet das einzelne Angebot ab der ersten Woche. Jeder Spieler kann die Gratiszeit einer Gruppe clusterweit einmal nutzen. Ein sofort bezahltes Angebot verbraucht sie nicht.
  3. Spieler öffnen das Schild per Rechtsklick und starten ihre verfügbare Gratiszeit oder bestätigen den Preis für eine bis vier Wochen. Vorauszahlungen während der Miete verlängern die bereits abgedeckte Zeit. Die Fälligkeit steht im Schildmenü. Eine Erinnerung kommt 24 Stunden vorher ins TDLibrary-Postfach.

Das Schild zeigt den aktuellen Mieter und während der Bestandsprüfung den ehemaligen Mieter. Nur das Team kann zusätzliche Rechte verwalten. Änderungen an den Freigaben während eines Vertrags laufen mit diesem Vertrag aus. Lege dauerhaft gewünschte Regeln vor Vertragsbeginn fest.

Bestätigt TDEconomy fehlendes Guthaben, enden die Mietrechte. TDClaim setzt einen alten Bettpunkt innerhalb des exakten 3D-Claims zurück. Bei einer offenen Buchung bleibt das Angebot bis zum Belegabgleich reserviert.

Während der Bestandsprüfung kann der bisherige Mieter dieselbe Wohnung am Schild erneut mieten. Eine bereits verbrauchte Gratiszeit bleibt verbraucht. Ein Admin kann den gemeldeten Fundort prüfen. Mit Räumung übernehmen sperrt er die Wiederanmietung und kann anschließend im Adminmodus Gegenstände entnehmen. Als leer freigeben prüft den Bestand erneut. Samt Bestand freigeben belässt die Gegenstände für den nächsten Mieter.

Die automatische Prüfung deckt bis zu 64 geladene Chunks ab. Ein nachweislich leerer Claim wird direkt wieder angeboten. Ungeladene Chunks, unbekannte Mod-Lager und Lager über einer Claim-Grenze halten das Angebot in der Bestandsprüfung. Die Prüfung wird wiederholt, wenn die Daten verfügbar werden. Prüfe größere oder weiterhin ungeklärte Bereiche von Hand vor der Freigabe.

Einzelne Blöcke und Leitungen

Für eine Tür, Maschine oder Kiste Block permissions → Add the block you are looking at wählen. Alternativ beim Ansehen des Blocks /tdclaim blockpermission verwenden. Das Ziel muss geladen und höchstens sechs Blöcke entfernt sein. Die Regel gehört zur exakten Position und zum Blocktyp; ein anderer Blocktyp übernimmt sie nicht.

Sichtbare Leitungen über die Claim-Grenze brauchen einen Automation boundary port am geschützten Endpunkt. Bestehende Anlagen werden nicht allein durch ein Update freigeschaltet. Den Endpunkt im Blockeditor aufnehmen und Automation Transfer bewusst erlauben. Übergänge zwischen zwei unterschiedlichen Claims bleiben gesperrt, auch mit Ports auf beiden Seiten. Ein Port prüft nicht, wer ein ungeschütztes äußeres Netz speist. Drahtlose und modinterne Transporte benötigen ihre eigene Integration.

Bewegte Create-Kontraktionen und Züge besitzen eine bewusste Ausnahme. TDClaim bietet dort keine allgemeine Garantie gegen Veränderungen über Gebietsgrenzen; stationäre Maschinen folgen weiterhin den normalen Regeln.

Ein Create-Packager darf eine Create Stock Bridge im selben Gebiet ohne Port bedienen. Über eine Claim-Grenze braucht er denselben gültigen Port wie andere Automation; sonst erhält die Bridge keine Bestellungen.

Ein Kolben im eigenen Claim darf Blöcke in die Wildnis hinausschieben. Außen stehende Kolben können keine Claim-Blöcke bewegen; Bewegungen in einen anderen Claim oder geschützten Spawn bleiben gesperrt.

Laden, Spawn und Verwaltungsmodus

Force-Loading-Flächen in der Claim-Verwaltung konfigurieren. Die vereinigte Fläche muss unter maxForceLoadedChunksPerClaim bleiben. Ein kleineres Limit entfernt Tickets übergroßer Claims, behält aber die gespeicherten Flächen.

Mit der Servereinstellung forceLoadRequiresOnlineMember = true bleiben die Flächen eines Claims nur geladen, solange eines seiner Mitglieder online ist. Als Mitglied zählt, wer im Claim mindestens eine ausdrückliche Erlaubnis hat, persönlich oder über eine Gruppe. Öffentliche Rechte und der Operator, der den Claim angelegt hat, zählen nicht. Nach dem Abmelden des letzten Mitglieds bleibt der Claim noch forceLoadOfflineGraceMinutes Minuten geladen (Standard 10). Nach einem Serverstart ohne Mitglieder wird er erst geladen, wenn ein Mitglied beitritt. Kann eine Gruppenzugehörigkeit nicht ermittelt werden, bleibt der Claim geladen. Die Einstellung wirkt ohne Neustart innerhalb einer Sekunde; der Standard false lädt wie bisher rund um die Uhr. Maschinen und Farmen in einem ausgesetzten Claim stehen still, bis ein Mitglied wieder online ist. Mit forceLoadUsesClusterPresence = true zählen auch Mitglieder auf anderen Backends.

/tdclaim adminmode on aktiviert für einen aktuellen Operator den ausdrücklichen Berechtigungs-Bypass. Mit off beenden und mit status prüfen. Die Sitzung wird nicht gespeichert und umgeht keine festen Umweltschutzregeln.

Spawn rules verwaltet den Overworld-Spawn; Dimension spawns feste Spawnpunkte einzelner Dimensionen. Ein angelegter Overworld-Dimensionsspawn ersetzt dort die allgemeinen Spawn-Radien. History kann passende Claim-Konfigurationen zurücknehmen, stellt jedoch keine abgebauten Weltblöcke wieder her.

Alle Spieler mit Xaero's World Map sehen den wirksamen Spawnschutz auf Welt- und Minikarte, unabhängig vom Schalter Claims map. Gezeigt wird jede Dimension mit Schutzzone: Dimensionsspawns und in der Overworld der konfigurierte spawnProtectionRadius um den Weltspawn, den der Server beim Start oder beim letzten /tdclaim reload übernommen hat. Radius 0 zeigt nichts. Jeder berührte Chunk wird gelb gefüllt und umrandet; der Tooltip nennt die Zone, die blockgenauen Grenzen als x min..max / z min..max und ausdrücklich erlaubte oder gesperrte Rechte eines Dimensionsspawns. Bei eingeschalteter Claims map behalten Claim-Chunks ihre Claim-Farbe, weil Claims vor dem Spawnschutz gelten. Clients ohne diese Version funktionieren weiter und zeigen die Anzeige nur nicht.

Einstellungen und Fehlerhilfe

Die Serverdatei ist serverconfig/tdclaim-server.toml in der Welt, die Darstellung liegt in config/tdclaim-client.toml. /tdclaim reload liest die Servereinstellungen neu; Vanilla-/reload ersetzt das nicht. debugSingleplayer in tdclaim-common.toml benötigt dagegen ein erneutes Öffnen der Welt. directSameRegionCapabilities (Standard true) lässt Verbindungen innerhalb eines Gebiets ohne TDClaim-Prüfschicht laufen und wird nur beim Serverstart übernommen.

Problem Prüfen
Zugriff trotz eingetragenem Ersteller verweigert Persönliche Rechte und Gruppenregeln im Inspector prüfen.
Rechtsklick auf einen Block schlägt mit NoClassDefFoundError in ItemMutationClassifier oder invalid dist DEDICATED_SERVER im selben Stacktrace fehl Server und Clients auf TDClaim 4.25.0 aktualisieren. Danach den Klick mit dem betroffenen Gegenstand im Spiel wiederholen und prüfen, ob der Claim die Benutzung wie eingestellt erlaubt oder verweigert.
Leitung arbeitet innerhalb, aber nicht außerhalb Endpunkt, Blocktyp und Automation-Port prüfen.
Umrandung fehlt Inventarsymbol, Berechtigung, Dimension sowie serverseitige und clientseitige Reichweite prüfen.
Verwaltungsantwort läuft ab Erst Refresh verwenden und den Serverzustand prüfen; die Aktion nicht blind wiederholen.
Daten werden beim Start abgelehnt Server anhalten und eine geprüfte Sicherung von Welt und data/tdclaim_claims.dat verwenden; die Datei nicht als vermeintliche Reparatur leeren.

Die englische Detailreferenz enthält die weiteren Verwaltungs-, Schutz- und Konfigurationsregeln.