Skip to main content

Using TDUtilities

Mod version shipped with FlammiCraft: 1.32.0

TDUtilities 1.15.0: LBR extensions now belong to the Little Big Redstone fork. Earlier LBR descriptions in this handbook are historical; components, recipes, editor and readers are maintained in LBR. Old TD IDs are not migrated. Client and server need matching updated JARs.

Deutsch · Feature reference

This guide follows the current source. Pack recipes and enabled modules can differ; source review does not establish gameplay acceptance.

TDUtilities stores live WATUT AFK flags in shared MariaDB from 1.30.0. Updated TD LeaderBoard builds can show remote AFK icons, and AFK chat announcements reach other backends when enabled at both ends. Use matching TDUtilities builds on clients and all backends. See the AFK reference and Forsaken migration instructions.

Little Big Redstone features (data network, Filtered Storage Reader, hold-to-reset and chip display scaling) live in the Little Big Redstone fork from 1.15.0 onward, not in TDUtilities. Former tdutilities: IDs for those features are no longer provided here.

Flammit textures

Flammit ores, storage blocks, tools and armor share a yellow-gold palette inspired by Flammi, FlammiCraft's yellow candle. Core icons show an unfinished candle, a candle with a face and flame, and a refined candle with a pink ribbon and bright clasp. Raw Flammit and binder have dedicated pixel textures. Recipes and stats stay the same. Source assets are checked; inventory rendering, enchantment glint and worn armor still need an in-game check after manual installation.

Requirements and upgrade (1.16.0)

Integrated features retain their own enable/disable settings. The standalone mods watut, chat_heads, cleanswing, nerb, colorfulhearts, enchdesc, flickerfix, glow_up, novillagerdm, yeetusexperimentus, modelfix, diagonalwrench, wits and elytraslot are incompatible. Curios Elytra flight no longer requires Caelus; Caelus may remain installed for other mods. Vanilla and HDPE Elytras retain slot rules, flight conditions and durability use. Deeper and Darker special handling is removed. MariaDB connection settings live in tdlibrary-database.toml.

Client conveniences

From 1.29.0, TDUtilities hides the underlying menus and blocks their mouse and keyboard input during startup and resource reloads outside a world. In a running world, a small progress bar appears over the game or current menu while both remain usable. Leaving the world during a reload restores the full loading screen. Drippy Loading Screen can continue to supply its background. Remove the standalone Remove Reloading Screen (rrls) mod before installation, as it conflicts with this feature. After manual installation, check a full startup, a main-menu reload, and an in-world reload including a disconnect while loading.

Consecutive identical chat messages from the same sender share a counter in the chat display. Long HUD titles fit the screen width. Command suggestions rank prefix matches before other partial matches. The chat field accepts longer slash commands. The narrator shortcut is unbound by default and can be assigned under Options → Controls → Key Binds.

config/tdutilities-client.toml contains compactConsecutiveChat, toastSlots, moveWorldToTrash, moveOptionalResourcePacks and skipResourcePackVersionWarning. Three toast slots fit three regular notifications. Larger toasts take several slots. If moving a world to the system trash fails, the client reports the failure and retains the world folder. The LAN screen prefers port 25565.

The integrated No Chat Reports uses the existing files under config/NoChatReports/, including per-server preferences. TDUtilities also disables Minecraft's telemetry sender for events outside a play session.

Start with the performance display

Use /tdu hud on, then select /tdu hud panel on or /tdu hud bossbar on. Both may be enabled. /tdu hud off hides both without losing the selection. These commands save your preferences.

At 20 TPS the server has 50 ms per tick. Yellow begins at half the target budget and red at the full budget. Client FPS and connection ping measure different things. Dashes and an age indicator mean server samples are unavailable or stale. The panel identifies native or optional Spark measurements.

Edit position/scale in the performanceHud section of tdutilities-client.toml, save, then use /tdu hud reload to apply the HUD settings.

Recipe book

disableRecipeBook in tdutilities-common.toml stops new vanilla recipe book unlocks and preserves saved unlocks. Recipes remain available for crafting and for mods that look them up by recipe ID.

With the setting on and EMI installed, the recipe book button stays. A click hides and shows the EMI sidebars named in emiToggleSidebars in the client configuration. The default is craftables. An empty list toggles the whole EMI UI. Without EMI the button is removed. JEI is unchanged.

Player plushies

Player plushies are placeable figures with player skins, custom poses, held items, nameplates, hearts, and country flags.

Diagonal lattice fences

Since TDUtilities 1.18.0 the diagonal Refurbished Furniture lattice fences belong to the Diagonal Fences fork (21.2.0 or newer), which documents them. The Diagonal Wrench in TDUtilities still switches them.

Name tags

Right-clicking with a name tag in hand opens a rename window; no anvil or experience is required. The window renames the held tag directly. Codes such as &4 color the finished name, and the preview shows the formatting before it is applied.

A named tag keeps naming living mobs as before. If the target already carries the identical name, the tag stays in the inventory. When the name changes, the old name returns as a new name tag, either into the inventory or onto the ground. Sneak shears on a named living mob remove its name in the same way; this takes the place of the mob's usual shearing behavior, so a named sheep loses its name instead of its wool. Named mobs other than players drop their name tag on death. Successful naming and name removal play a short confirmation sound.

Server settings live in the [nameTags] section of tdutilities-server.toml: editor, renameSound, keepSameName, shearsRemoveName, mobsDropNameTag and returnOldNameTag. The client file holds [nameTags] editorScreen for the rename window; the server must additionally allow the editor for commits. After manual installation, renaming, applying names to mobs, the identical name rule, returning old names, shears removal and death drops still need in-game acceptance.

Inventory and player activity

With Sophisticated Backpacks and FramedBlocks installed, the craftable Framing Saw Upgrade adds shape search, material and additive slots, and a persistent output slot inside the backpack. FramedBlocks Plus is optional; its crafting and stonecutting recipes are included when present.

Collected XP repairs eligible equipped items before damaged enchanted items in the direct inventory. Inventory totems activate only when neither hand holds a totem and do not protect against damage that bypasses vanilla totems. Containers inside the inventory are not searched. Server settings can disable these features or restrict mending to the hotbar.

Review integrated What Are They Up To privacy settings before using activity visualisation: mouse, typing, GUI and item information have separate controls. The reference covers these and the Curios/utility additions.

Build a dimension portal

Starting with TDUtilities 1.27.0, world generation skips End Portal Frames, including during Chunky pregeneration. Structures still generate, and existing frames remain in the world.

Build a Nether-style frame in the Overworld with a clear interior 2–21 blocks wide and 3–21 tall. Mining uses Blackstone and the Seal of the Deep Rift; Event uses Polished Blackstone Bricks and the Event Seal. Use the matching operator-obtained seal on the frame. It is not consumed.

Mining world generation depends on FlammiCraft content. Former KubeJS dimensions are not migrated. The administrator command /miningboss reset changes chamber state; do not use it to troubleshoot an ordinary portal.

From TDUtilities 1.21.0, common ore veins and large industrial deposits are smaller, and copper-bearing Veridium is rarer. The existing search heights still apply. After the server restarts, the new values apply to newly generated chunks. Deposits in already generated chunks remain in place.

In 1.24.0, TDUtilities provides Quartz and Flammit ores and their deepslate variants. Flammit ore requires a diamond pickaxe and drops raw Flammit. Fortune increases the yield and Silk Touch drops the ore block. Quartz ore requires an iron pickaxe and drops the ore block.

Quartz and Flammit content uses the new tdutilities: IDs. Saved blocks and items using the old KubeJS IDs are not migrated. Activate the new mod data and remove the former KubeJS registrations together when updating the pack.

Flammit processing uses Create, Mekanism and Extended Crafting when the corresponding mods are present. An actual kill of a Forsaken from Alex’s Caves drops a refined core. With Only Hammers and Excavators installed, the Flammit Hammer and Excavator mine a three-by-three area. Otherwise they work as a pickaxe and shovel respectively. The Flammit Hammer takes five ingots and two sticks.

Troubleshooting and operation

Water, glass and other translucent blocks could look opaque while WATUT indicators, GUI previews or item transfers were shown, for example after opening a menu. From TDUtilities 1.22.0, the integrated WATUT particles no longer leave a changed render state behind. In-game acceptance is still pending.

From TDUtilities 1.21.0, the CartographyTableScreenCompatMixin startup crash with Moonlight and Supplementaries is fixed. If a mod version does not provide the expected fields, TDUtilities disables its slot animation fix and logs a warning on the client.

Configuration migration

When opening an unconverted world, TDUtilities also imports its legacy serverconfig/tdutilities-additions.toml and tdutilities-inventory.toml into tdutilities-server.toml. From 1.10.0 this includes worlds opened after another world prepared the global server file. The global file stays unchanged; no world override is created without existing world configuration files.

Legacy files remain available. An old file already using the target name is preserved byte for byte as .legacy.bak before replacement. Invalid TOML or a conflicting backup stops migration with an error. Targets already marked configFormat = 1 remain authoritative and are not reimported. If a previously converted file is missing a setting, compare the retained originals and set that value explicitly in the valid new file; do not delete configurations as a repair. Migration opens no database. Automated checks use temporary files; migration during a real world start still needs manual acceptance.

Other troubleshooting

For a dark portal check dimension, frame material, clear interior and matching seal. For unexpected reader counts check accessible side and filter membership. A waiting HUD needs a compatible server and live samples.

From 1.28.0 activity logging runs on dedicated servers whenever [database] enabled = true is set in TDLibrary's private tdlibrary-database.toml; it has no settings of its own. It creates its tables on server start and records the cluster backend of each session, so several backends can share one database; new timestamps are UTC while historical local timestamps remain unchanged. Failed writes queue in memory and do not survive process exit. Consult the reference before enabling logging or changing world data.