Skip to content

UnionClef v0.95.63 (MC 1.21.11)

Choose a tag to compare

@3ndetz 3ndetz released this 22 Oct 08:25
· 14 commits to 1.21.11 since this release

Installation

  1. Install Fabric Loader for the Minecraft version listed in the release title
  2. Drop the release JAR into your .minecraft/mods/ folder
  3. Launch Minecraft

No separate mods install needed — everything is bundled into the main UnionClef JAR. If you see a separate tungsten-**.jar, do not install it next to UnionClef: UnionClef already contains it.

Modules

UnionClef bundles two systems, each with its own command prefix:

Module Prefix What it does
Tungsten ; Movement — physics-simulated pathfinding, block-space search, bridging, mining
AltoClef @ High-level bot tasks (get items, kill mobs, survive)

Quick start commands

;goto <x> <y> <z>          — tungsten: walk/jump to coordinates
;followPlayer <nick>        — tungsten: follow a player
;stop                       — tungsten: stop current action
;settings debugTime true    — tungsten: enable profiling output

@goto <x> <y> <z>          — altoclef: smart goto (avoids mobs, eats, etc.)

Water, air and buckets

Work from the UNIONCLEF-HARD session (developed and bench-tested 2026-10-02..10-04, left
uncommitted when that session paused), reviewed, rebuilt over 0.95.62 and re-tested before
release.

Pillaring in water uses swimming input. A pillar started in water used to hold sneak with
jump, and sneak sinks the body: the bot sat at a bank holding both. It now swims up while in
water and goes back to the land sneak/jump placement once out. pillarUsesSwimInputInWater is
now on by default (false keeps the old input). Earlier evidence: 42 water/neighbour and 36 dry
interaction trials passed at 29+ FPS; on the retained food-bank checkpoint new food appeared in
5/5 FPS-valid ON observations against 1/5 OFF.

The air escape starts when the way out needs it. The rescue used to wait until half the air
was gone. It now prices the actual exit -- digging the cap overhead, with vanilla's underwater
mining penalty, or swimming to the nearest breathable cell -- and starts early enough to finish
it. A live route to air is followed to its end instead of being re-priced every tick (baritone
PathingBehavior.java:196-224), which stops the dig/swim flip-flop measured in dry-entry tunnels.

Extra water buckets are emptied, one is kept. The task used to empty every water bucket at
its own feet. It now keeps one filled bucket and empties only the extras, against a solid face
within reach.

The block scanner no longer reads the live world from its worker thread. Chunk contents are
copied on the client tick (ChunkBlockSnapshot) and the worker searches the copies.

Re-tested on this build (0.95.62 + this work):

  • nav_water, nav_water_pillar, nav_grid_water_roof, nav_flat, nav_staircase,
    nav_descend, nav_break, nav_bridge, nav_gaps: 9/9 PASS, 29-30 FPS.
  • portal_lava_lake PASS (27.6 FPS), craft_at_distant_table PASS.
  • Same checkpoint 7 minutes before a drowning in the air escape, interleaved: 0.95.62 had two
    deaths in one of two runs (a creeper and a zombie, lowest health 1.8); this build none in two
    (lowest health 11.2 and 20). The drowning itself did not recur in either arm, so this is not
    claimed as a drowning fix.
  • Night in a lake (repro-lake-night): no deaths, health 20.
  • 15-minute native run from full59-before-portal: PASS, 0 deaths, lowest health 17.3, iron and
    crafting rungs. Its median FPS was 20; the interleaved checkpoint pair above read the same FPS on
    both builds (26/22 vs 26/22), so the host was loaded that day rather than the scanner slow.

HOW TO TEST:

python deploy/runner/run_suite.py nav --only nav_water,nav_water_pillar,nav_grid_water_roof --record
python deploy/runner/gamer_smoke.py 15 --from full59-before-portal --raw-resume --record

Also: checkpoints named repro-* are never removed by the budget trim (two reproductions were
lost mid-investigation); rename one to keep it, delete it when its defect is closed.

No speed or FPS gain is claimed. The whole playthrough is still open.

Full Changelog: v0.95.62...v0.95.63