Zum Hauptinhalt springen

TDUtilities bedienen

Mit FlammiCraft ausgelieferte Mod-Version: 1.32.0

TDUtilities 1.15.0: Die LBR-Erweiterungen gehören ab dieser Version zu Little Big Redstone. Ältere LBR-Beschreibungen dieser Mod sind historisch; Bausteine, Rezepte, Editor und Reader werden im LBR-Fork gepflegt. Keine automatische Migration alter TD-IDs. Client und Server benötigen zusammenpassende neue JARs.

English

TDUtilities bündelt Komfortfunktionen, Anzeigen, Curios-Erweiterungen und die FlammiCraft-Dimensionen. Dieses Handbuch beschreibt den aktuellen Quellstand. Verfügbare Rezepte, aktivierte Module und Dimensionen hängen vom Pack ab; Quellprüfung ersetzt keinen Spieltest.

Little-Big-Redstone-Funktionen (Datennetz, Filtered Storage Reader, Hold-to-Reset und Chip-Skalierung) liegen ab 1.15.0 im Little-Big-Redstone-Fork, nicht mehr in TDUtilities. Bisherige tdutilities:-IDs dafür entfallen hier.

Voraussetzungen und Wechsel (1.16.0)

Die integrierten Funktionen verwenden weiterhin ihre eigenen Ein-/Ausschalter. Die Einzelmods watut, chat_heads, cleanswing, nerb, colorfulhearts, enchdesc, flickerfix, glow_up, novillagerdm, yeetusexperimentus, modelfix, diagonalwrench, wits und elytraslot sind inkompatibel. Curios-Elytra-Flug benötigt kein Caelus mehr; Caelus darf für andere Mods installiert bleiben. Vanilla- und HDPE-Elytra behalten Slotregeln, Flugbedingungen und Haltbarkeitsverbrauch. Deeper-and-Darker-Sonderbehandlung entfällt. Die MariaDB-Verbindung wird in tdlibrary-database.toml verwaltet.

Flammit-Texturen

Flammit-Erze, Lagerblöcke, Werkzeuge und Rüstung verwenden eine gemeinsame gelb-goldene Farbpalette, angelehnt an Flammi, die gelbe Kerze von FlammiCraft. Die Kernsymbole zeigen eine Kerze: unvollständig, mit Gesicht und Flamme sowie veredelt mit rosa Band und heller Schnalle. Rohes Flammit und Bindemittel besitzen eigene Pixeltexturen. Rezepte und Werte bleiben gleich. Die Texturen werden im Quellstand geprüft; Inventardarstellung, Verzauberungsglanz und angelegte Rüstung sind nach dem manuellen Einbau noch im Spiel zu prüfen.

Client-Komfort

Seit 1.29.0 sperrt TDUtilities beim Start und bei Ressourcen-Reloads außerhalb einer Welt die darunterliegenden Menüs für Maus und Tastatur und blendet sie während des Ladens aus. In einer laufenden Welt erscheint ausschließlich ein kleiner Fortschrittsbalken über der Spielansicht beziehungsweise dem geöffneten Menü; Spiel und Menüs bleiben bedienbar. Beim Verlassen der Welt während eines Reloads kehrt der vollständige Ladebildschirm zurück. Drippy Loading Screen kann weiterhin dessen Hintergrund gestalten. Entferne vor der Installation die Einzelmod Remove Reloading Screen (rrls), die mit dieser Funktion inkompatibel ist. Prüfe nach dem manuellen Einbau einen vollständigen Start, einen Reload im Hauptmenü und einen Reload in der Welt einschließlich eines Disconnects während des Ladens.

Der Client fasst direkt aufeinanderfolgende gleiche Chatmeldungen desselben Absenders mit einem Zähler zusammen und passt lange HUD-Titel an die Bildschirmbreite an. Befehlsvorschläge sortieren Präfix- vor Teiltreffern. Das Chatfeld akzeptiert längere Befehle mit Schrägstrich. Die Erzählertaste lässt sich unter Optionen → Steuerung → Tastenbelegung belegen und ist zunächst unbelegt.

In config/tdutilities-client.toml stehen compactConsecutiveChat, toastSlots, moveWorldToTrash, moveOptionalResourcePacks und skipResourcePackVersionWarning. Drei Toast-Plätze entsprechen drei normalen Benachrichtigungen. Größere Toasts belegen mehrere Plätze. Kann eine Welt nicht in den Papierkorb verschoben werden, meldet der Client den Fehler und behält den Ordner. Beim Öffnen einer LAN-Welt verwendet der Client Port 25565 als erste Wahl.

No Chat Reports ist integriert und verwendet die bisherigen Dateien unter config/NoChatReports/, einschließlich der Einstellungen pro Server. TDUtilities deaktiviert außerdem Minecrafts Telemetriesender für Ereignisse außerhalb einer Spielsitzung.

Erste Schritte und Anzeigen

  1. Installiere die Mod und ihre deklarierten Abhängigkeiten auf den benötigten Seiten. Entferne integrierte Einzelmods nur nach einem geprüften Wechsel; zwei parallele Handler können dieselbe Aktion ausführen.
  2. Öffne mit /tdu hud on die persönliche Leistungsanzeige. /tdu hud bossbar on und /tdu hud panel on wählen die Ansichten, /tdu hud off blendet beide aus. Die Auswahl bleibt gespeichert.
  3. Lies TPS zusammen mit MSPT: bei 20 TPS stehen 50 ms pro Tick zur Verfügung. Gelb beginnt bei halbem Zeitbudget, Rot bei vollem. FPS gehört zum Client; Ping ist keine reine Server-Rechenzeit.
  4. Striche oder eine Warteanzeige bedeuten fehlende beziehungsweise veraltete Daten. Prüfe Verbindung und Serverunterstützung, bevor du Werte vergleichst.

Position und Größe stehen unter performanceHud in tdutilities-client.toml. Nach dem Speichern übernimmt /tdu hud reload die HUD-Einstellungen. Spark ist optional; die Anzeige nennt ihre Messquelle.

Rezeptbuch

disableRecipeBook in tdutilities-common.toml schaltet neue Freischaltungen für das Vanilla-Rezeptbuch ab und bewahrt bereits gespeicherte Freischaltungen. Die Rezepte bleiben für die Herstellung und für Mods verfügbar, die sie über ihre Rezept-ID abrufen.

Ist die Einstellung an und EMI installiert, bleibt der Rezeptbuch-Knopf. Ein Klick blendet die EMI-Seitenleisten aus emiToggleSidebars in der Client-Konfiguration aus und wieder ein. Voreingestellt ist craftables. Eine leere Liste schaltet die ganze EMI-Oberfläche. Ohne EMI verschwindet der Knopf. JEI bleibt unverändert.

Diagonale Gitterzäune

Seit TDUtilities 1.18.0 gehören die diagonalen Gitterzäune von Refurbished Furniture zum Diagonal-Fences-Fork (ab 21.2.0), der sie beschreibt. Der Diagonal-Schraubenschlüssel aus TDUtilities schaltet sie weiterhin um.

Namensschilder

Ein Rechtsklick mit einem Namensschild in der Hand öffnet ein Umbenennen-Fenster; Amboss und Erfahrung sind dafür nicht nötig. Das Fenster benennt das gehaltene Schild direkt. Codes wie &4 färben den fertigen Namen; die Vorschau zeigt die Formatierung vor dem Anwenden.

Ein benanntes Schild benennt Lebewesen wie bisher. Trägt das Ziel bereits denselben Namen, bleibt das Schild im Inventar. Ändert sich der Name, wird der alte Name als neues Namensschild ins Inventar oder auf den Boden zurückgegeben. Schleichen mit Scheren an einem benannten Lebewesen entfernt den Namen auf demselben Weg; dabei tritt an die Stelle des üblichen Scherverhaltens dieser Aktion, ein benanntes Schaf verliert also seinen Namen statt der Wolle. Benannte Tiere ausgenommen Spieler lassen beim Tod ihr Namensschild fallen. Gelungende Namensvergabe und Namensentfernung spielen einen kurzen Bestätigungssound.

Die Servereinstellungen stehen unter [nameTags] in tdutilities-server.toml: editor, renameSound, keepSameName, shearsRemoveName, mobsDropNameTag und returnOldNameTag. Die Clientdatei hält [nameTags] editorScreen mit editorScreen für das Umbenennen-Fenster; der Server muss das Fenster zusätzlich zulassen. Nach dem manuellen Einbau sind Umbenennen, Namensvergabe, gleicher Name, Rückgabe alter Namen, Namensentfernung mit Scheren und Todesdrops noch im Spiel zu prüfen.

Inventar und Sichtbarkeit

Spielerplüschtiere sind platzierbare Figuren mit eigenen Skins, Posen, Handgegenständen, Namensschildern, Herzen und Länderflaggen.

Der Statuseffekt „Enthüllung“ (tdutilities:revealing) ist in der EMI-Zutatenliste ausgeblendet. Seine Tränke und Braurezepte bleiben sichtbar; die Effektfunktion bleibt erhalten. Die Filterressource ist im Quellstand enthalten; die Anzeige muss nach dem manuellen Einbau noch im Spiel geprüft werden.

Der Diagonal-Schraubenschlüssel verwendet die unveränderte Originaltextur aus Diagonal Wrench 1.0.1. Die Textur wird mitgeliefert; dafür ist die Einzelmod nicht nötig.

Mit Sophisticated Backpacks und FramedBlocks steht das herstellbare Framing-Saw-Upgrade zur Verfügung. Der Rucksack-Reiter bietet eine Formensuche, Material- und Zusatzslots sowie einen gespeicherten Ausgabeslot. FramedBlocks Plus ist optional; seine Werkbank- und Steinschneiderrezepte werden ebenfalls angeboten.

Inventar-Reparatur nutzt eingesammelte XP zunächst für geeignete ausgerüstete, dann für beschädigte verzauberte Inventargegenstände. Inventartotems greifen nur ohne Totem in einer Hand und umgehen keine Schäden wie /kill. Rucksack- und Shulker-Inhalte zählen nicht. Die Servereinstellungen unter inventory können beide Funktionen abschalten oder Reparatur auf die Hotbar begrenzen.

Die integrierte Aktivitätsanzeige What Are They Up To besitzt Datenschutzoptionen für Maus, Tippen, offene Oberflächen und Iteminformationen. Prüfe diese Einstellungen vor Nutzung; die Funktionsreferenz erklärt Curios, Utility-Gegenstände und Sichtbarkeit im Detail.

Ab 1.30.0 speichert TDUtilities den aktuellen WATUT-AFK-Status in der gemeinsamen MariaDB-Tabelle tdu_afk_status. Alle Backends verwenden dafür dieselbe TDLibrary-Datenbank und einen aktivierten Cluster mit eindeutigen Backend-IDs. Passende TDUtilities-Builds auf Client und Server zeigen den Status auch für Spieler ohne lokalen TAB-Eintrag im TD LeaderBoard an.

Ab 1.32.0 leihen AFK-Status und Aktivitätsprotokoll ihre Datenbankverbindungen aus dem gemeinsamen Pool von TDLibrary; dafür ist TDLibrary ab 0.74.0 nötig.

Der Cluster aktualisiert die Einträge alle 20 Server-Ticks im Hintergrund. Ein Eintrag gilt zehn Sekunden ab dem letzten Schreiben. Für die Anzeige zählt das Backend, dem TDLibrary den Spieler aktuell zuordnet. Während des Wechsels kann das Symbol ausblenden, bis der Zielserver seinen ersten gültigen Stand liefert. Bei Ausfall des Clusters oder der Datenbank blendet der Server entfernte AFK-Symbole aus. tdu_afk enthält weiterhin die historischen AFK-Intervalle.

Ist announceIdleStatesInChat auf Sender und Empfänger aktiviert, werden AFK und Rückkehr auch auf anderen Backends im Chat angezeigt. Die Meldung gilt für Spieler, die zu diesem Zeitpunkt erreichbar sind. GUI-Bilder, Maus, Tippen und Inventardetails behalten ihren bisherigen Verteilungsbereich. Eingabeerfassung und Datenschutzschalter gelten wie bisher. Die Anzeige und der Chat sollen nach dem Einbau mit Spielern auf zwei Backends und beim Serverwechsel geprüft werden.

Dimensionsportale

Ab TDUtilities 1.27.0 überspringt die Weltgenerierung Endportalrahmen auch bei der Vorabgenerierung mit Chunky. Die Strukturen werden weiterhin platziert. Bereits vorhandene Rahmen bleiben erhalten.

Im Overworld einen Netherportal-Rahmen mit freiem Innenmaß 2–21 × 3–21 bauen. Für Mining: Blackstone und Seal of the Deep Rift; für Event: Polished Blackstone Bricks und Event Seal. Das passende Siegel am Rahmen benutzen. Die Siegel werden nicht verbraucht und sind nur administrativ erhältlich.

Die Mining-Welt benötigt FlammiCraft-Inhalte und ist keine allgemeine Standalone-Dimension. Alte KubeJS-Dimensions-IDs werden nicht automatisch übernommen. /miningboss reset ist ein administrativer Eingriff in Kammerzustand und kein Reparaturschritt für ein gewöhnliches Portalproblem.

Ab 1.30.0 liegt der Forsaken-Spielstand unter <Welt>/dimensions/tdutilities/mining/data/tdutilities_forsaken_chamber.dat. Nur der Server, dem die Mining-Dimension in cluster-node.toml zugeordnet ist, kann die Kammer anlegen, den Anker ändern oder sie zurücksetzen. Betreiber mit Berechtigungsstufe 2 können als Spieler /miningboss auf anderen Backends benutzen. Der Mining-Server liefert Status und Koordinaten zurück. Der Teleport-Link steht bei einer Abfrage direkt auf dem Mining-Server zur Verfügung.

Fehlt die Datei in der Mining-Dimension, übernimmt TDUtilities auf dem Mining-Server einen gültigen alten Stand aus <Welt>/data/tdutilities_forsaken_chamber.dat und behält die Originaldatei. Liegt der letzte gültige Stand vor dem Upgrade in einem anderen Weltordner, sichere ihn und stelle ihn vor dem ersten Start auf dem Mining-Server am alten Pfad bereit. Eine vorhandene Mining-Datei hat Vorrang. Bei einem späteren Backend-Umzug gehört die Datei zusammen mit der kompletten Mining-Dimension ins Backup.

Ab TDUtilities 1.21.0 entstehen in neuen Mining-Chunks kleinere Adern häufiger Erze und kleinere Großlager. Kupferhaltiges Veridium ist seltener. Die bisherigen Suchhöhen gelten weiter. Die neuen Werte greifen nach dem Serverneustart für neu generierte Chunks. Bereits gespeicherte Vorkommen bleiben erhalten.

Ab 1.24.0 gehören Quarz- und Flammiterze samt Tiefenschiefer-Varianten zu TDUtilities. Flammiterz benötigt eine Diamant-Spitzhacke und liefert rohes Flammit. Glück erhöht den Ertrag, Behutsamkeit liefert den Erzblock. Quarzerz benötigt eine Eisen-Spitzhacke und lässt den Erzblock fallen.

Quarz- und Flammit-Inhalte verwenden die neuen tdutilities:-IDs. Gespeicherte Blöcke und Gegenstände mit alten KubeJS-IDs werden nicht migriert. Beim Pack-Update gehören die neuen Moddaten und die Entfernung der früheren KubeJS-Registrierungen zusammen.

Die Flammit-Verarbeitung nutzt bei vorhandenen Partnermods Create, Mekanism und Extended Crafting. Ein tatsächlich getöteter Forsaken aus Alex’s Caves lässt einen veredelten Kern fallen. Mit Only Hammers and Excavators bauen Flammit-Hammer und -Excavator drei mal drei Blöcke ab. Ohne die Mod funktionieren sie als Spitzhacke beziehungsweise Schaufel. Der Flammit-Hammer benötigt fünf Barren und zwei Stöcke.

Gespeicherte Kammern mit ungültigem Zustand oder einer Bodenhöhe außerhalb von -48 bis 280 werden unverändert für die Wiederherstellung erhalten. Generierung und Kammerbefehle bleiben für diese Daten gesperrt; ein Reset ist kein Ersatz für die gezielte Reparatur des erhaltenen Speicherstands.

Administration und Fehlerhilfe

Konfigurationsmigration

Beim Öffnen einer noch nicht konvertierten Welt übernimmt TDUtilities auch deren alte serverconfig/tdutilities-additions.toml und tdutilities-inventory.toml in tdutilities-server.toml. Das gilt ab 1.10.0 auch dann, wenn eine andere Welt die globale Serverdatei bereits vorbereitet hat. Die globale Datei bleibt dabei unverändert; ohne vorhandene Weltdateien wird kein Welt-Override erzeugt.

Legacy-Dateien bleiben erhalten. Eine alte Datei mit dem neuen Zielnamen wird vor dem Ersetzen unverändert als .legacy.bak gesichert. Ungültiges TOML oder eine widersprüchliche Sicherung stoppt die Migration mit einer Fehlermeldung. Bereits mit configFormat = 1 konvertierte Ziele haben Vorrang und werden nicht erneut aus alten Quellen befüllt. Falls in einer früher konvertierten Datei ein Wert fehlt, die erhaltenen Originale vergleichen und den gewünschten Wert gezielt in der gültigen neuen Datei setzen; keine Konfigurationsdateien zur Fehlerhilfe löschen. Die Migration öffnet keine Datenbank. Automatisierte Prüfungen verwenden temporäre Dateien; die Übernahme beim echten Weltstart ist noch manuell zu prüfen.

Weitere Fehlerhilfe

  • Wasser, Glas und andere durchscheinende Blöcke wirkten undurchsichtig, solange WATUT-Anzeigen, GUI-Vorschauen oder Item-Transfers sichtbar waren, etwa nach dem Öffnen eines Menüs. Ab TDUtilities 1.22.0 hinterlassen die integrierten WATUT-Partikel keinen veränderten Renderzustand mehr. Die Prüfung im Spiel steht noch aus.
  • Ein Startabsturz in CartographyTableScreenCompatMixin mit Moonlight und Supplementaries ist ab TDUtilities 1.21.0 behoben. Sind die erwarteten Felder einer Mod-Version nicht verfügbar, deaktiviert TDUtilities nur seine Korrektur für die Slot-Animation und meldet das im Client-Log.
  • Portal bleibt aus: Overworld, Material, Siegel und freie Innenfläche prüfen.
  • Reader zählt falsch: ausgewählte Seite, Filter-ID und tatsächlich zugängliche Slots prüfen; Aktualisierung erfolgt regulär alle zehn Serverticks.
  • HUD wartet: Client und Server müssen die Funktion unterstützen. Ein deaktivierter HUD löscht die gespeicherte Auswahl nicht.
  • Aktivitätsprotokoll: Ab 1.28.0 ohne eigene Einstellungen. Es läuft auf dedizierten Servern, sobald in der privaten tdlibrary-database.toml von TDLibrary [database] enabled = true steht, und erzeugt seine Tabellen beim Serverstart. Jede Sitzung speichert das Cluster-Backend, daher können sich mehrere Backends eine Datenbank teilen; UTC für neue Intervalle; alte lokale Zeitstempel werden nicht umgerechnet. Warteschlangen überleben keinen Prozessabbruch.

Die englische Referenz beschreibt Datenhaltung, Einschränkungen und weitere Funktionen. Datenbank- und Weltänderungen gehören in einen geplanten Betreiberablauf mit gesichertem Datenstand.