Skip to content
ran4omPublic

About

Kiaclef: a fork of AltoClef for Minecraft 26.2 (Fabric). Autonomous gathering, crafting and Litematica building, with an in-game control panel.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Repository files navigation

Kiaclef: a voxel island at dusk with a small robot mining iron and diamond ore

Kiaclef

Ask for diamonds. It does the rest.
A Minecraft 26.2 bot that gathers, crafts and builds on its own.
A fork of AltoClef.

Latest release Minecraft 26.2 Fabric MIT license

Website  ·  Download 1.0.0  ·  Commands  ·  Install and testing notes


Typing @get diamond makes Kiaclef chop a tree, craft planks and a table, make wooden and stone pickaxes, mine and smelt iron, make an iron pickaxe and mine the diamond

Watch it work

One @get diamond on a brand new world with an empty inventory. This is a real run, sped up: the HUD in the corner is Kiaclef's live task chain, and the timer stops at 3 minutes 33 seconds when the diamond lands.

Time-lapse of the bot gathering wood, crafting tools, smelting iron and mining a diamond, with its task chain shown in the corner

Builds schematics, and keeps going when interrupted

Point it at a Litematica placement or a .litematic, .schem or .schematic file. It counts the materials, gathers and crafts what is missing, then places every block. In this run a skeleton's arrow interrupts the build: Mob Defense takes over to dodge, then the same build resumes and finishes.

The bot placing a Litematica build; the HUD switches to Mob Defense to dodge an arrow, then the build completes

Everything from one panel

Press J in-game. Request items with autocomplete, queue whole shopping lists, pick a schematic, or run any command with history. Ctrl+K stops everything.

The Kiaclef control panel cycling through its Tasks, Build and Console tabs

The website

A scroll-driven 3D tour of everything above lives at ran4om.github.io/kiaclef.

Tour of the Kiaclef website: a 3D voxel island, the dependency chain, the build sequence and the download section

Install

  1. Install Fabric Loader 0.19.5+ for Minecraft 26.2, with Java 25+.
  2. Put Fabric API 0.154.2+26.2 in your mods folder.
  3. Download kiaclef-1.0.0.jar and put it in mods.
  4. Optional, for @build placement: Litematica 0.28.8 and MaLiLib 0.29.6.

Baritone is bundled. Don't install a separate Baritone or AltoClef jar alongside it. Kiaclef keeps AltoClef's internal mod id, so its settings live in the same altoclef/ folder.

SHA-256 of the 1.0.0 jar: d20f06011e64072b9b8c65dba770561ed49373aee647d4710983dea4567157ec

Usage

Press J for the control panel, or type commands in chat with the @ prefix:

@get diamond 3
@get [chest 2, stick 16]
@list
@build myhouse.litematic
@build placement
@stop

All commands and settings are in usage.md.

What's different from AltoClef

Minecraft 26.2 Ported from 1.18.2 to 26.2 with Mojang mappings, Fabric Loader 0.19.5, Fabric API 0.154.2 and Baritone 1.19.0.
Control panel and HUD An in-game panel (J) for tasks, item lists, schematics and commands, and a compact task HUD with elapsed time.
Schematic building Litematica placements and schematic files, with materials gathered and crafted first, and resumption after interruptions.
Fixes from real runs Container tracking under lag and double clicks, several crafting loops, leftover grid items, partial stack top-ups, and Baritone pausing over a carried chest.

Status and limits

Version 1.0.0 passes 1,383 unit tests and automated sessions in the packaged game on freshly generated worlds. Those sessions covered: diamond from an empty inventory on untouched terrain, item lists, Litematica building with mid-build recovery, chest loot, deposits, stashing and stacking, the kelp crafting chain, Mob Defense task selection, and the control panel.

Still rough:

  • Night survival is weak. Mob Defense reacts late to creepers and Drowned, so long tasks in the open at night can end in death and lost items.
  • Not verified: speedrunning (@gamer), Nether and End travel on natural terrain, real combat, multiplayer servers, large schematics, and most of the catalogue's items.

Bug reports are welcome in Issues.

Building from source

./gradlew build

This needs a Java 26 JDK for the Gradle toolchain; the mod targets Java 25. The jar is written to build/libs/kiaclef-1.0.0.jar. The website source is in site/.

Credits and licenses

  • AltoClef, © 2020 Adris Jautakas (TacoTechnica) and contributors, MIT License. Kiaclef is a modified version of it, released under the same MIT License.
  • Baritone 1.19.0 by leijurv, Brady and contributors, bundled unmodified, LGPL-3.0.
  • Jackson 2.20 and Apache Commons Lang 3.20.0, bundled, Apache License 2.0.
  • The README banner and website key art were generated for this project. In-game footage and screenshots come from Kiaclef's automated test runs.

THIRD_PARTY_NOTICES.md lists every bundled and optional component. Kiaclef is not affiliated with Mojang or Microsoft, or with the AltoClef or Baritone projects.

About

Kiaclef: a fork of AltoClef for Minecraft 26.2 (Fabric). Autonomous gathering, crafting and Litematica building, with an in-game control panel.

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages