Straitbrashadow/minecraft-ai-mod-builder

Trowel is a free, MIT-licensed companion tool for Minecraft that turns a typed sentence into a build in your world: you describe a tower, bridge or datapack in a terminal, see it as a see-through blueprint, then confirm placement. It suits players who want idea-to-build without command syntax, and who accept its platform and permission limits.

What changes in the workflow

Instead of assembling blocks by hand or writing commands, the player types a request to the trowel terminal app. Before planning, the companion reads nearby blocks, biome and what the player is looking at, and matches the palette of neighbouring builds. The build appears as white outlines visible only to the requesting player, can be moved or rotated conversationally, and fills in after confirmation. The same flow covers datapacks: Trowel writes the pack, runs /reload, reads the log and fixes a failed reload before finishing the turn.

Two mechanisms drive the safety story. Every turn snapshots the region and keeps an undo journal of replaced blocks, so /undo restores the terrain, including grass and path blocks; the README says nothing outside the build is touched. Placement is batched under the max_block_modifications game rule. In survival, Trowel does not place the build: /materials lists required blocks and /export writes .litematic, .nbt or .schem for manual building. Limits such as height restrictions or banned materials can be written in a TROWEL.md file.

Supported paths and requirements

The Windows 10/11 zip distribution provides Main.exe, settings and the trowel command, which must be put on PATH. A game companion differs by path: the Fabric jar for Java Edition 26.1–26.3 singleplayer or LAN, a Paper plugin for 26.3 servers, or Horizon's built-in Agent Control for Minecraft on Rust, which needs no mod. The Fabric companion only builds in worlds running on the player's own PC, and the Paper plugin is limited to operators. On Horizon, the blueprint appears in Trowel's own preview window rather than in the world.

A free local model through Ollama is the default; Claude, GPT or Gemini keys are optional. Building from source needs Rust 1.85+ and Java 25 for the companions README.

Constraints to weigh

Trowel is an independent project, not affiliated with Mojang or Microsoft. It cannot build on servers you do not operate unless you are an operator there. The Horizon preview limitation is explicitly noted as waiting on a game-side hook. The README documents no performance measurements or evaluation scope, so response quality and build correctness depend on the model and are not quantified.