Straitbrashadow/minecraft-ai-mod-builder

选用指南

AI 根据 README 整理 · 2026/10/31 16:11:17

适用场景

适用于在 Minecraft Java Edition 或 Paper 服务器中，通过文字描述快速生成建筑并放置，或生成数据包修改游戏规则。

查看 README 依据

A watchtower on the hill you're standing on. A bridge over the river. A speed boost when you eat a golden carrot. **Type it in your terminal and Trowel builds it in your world.** It reads the blocks around you, shows the build as a blueprint first, places it when you say yes, and takes it back with one `/undo`. **Trowel is free and open source.** Out of the box it runs on a free local model through [Ollama](https://ollama.com). A Claude, GPT or Gemini key is optional, if you already have one. No account, no limits, nothing to buy. ## What it does <table> <tr>

Ask for game rules, not just buildings: recipes, advancements, loot tables and functions. Trowel writes the pack with the right `pack.mcmeta` for your version (data pack format 121 on 26.3), runs `/reload` and reads the log. One bad line makes Minecraft drop the whole function file, so Trowel checks every reload and fixes what failed before it calls the turn done. ## Also - **Survival-ready.** `/materials` lists every block you'd need. `/export` writes `.litematic`, `.nbt` or `.schem`.

目标用户

面向 Minecraft 玩家，尤其是希望快速建造或修改游戏规则的玩家。

查看 README 依据

A watchtower on the hill you're standing on. A bridge over the river. A speed boost when you eat a golden carrot. **Type it in your terminal and Trowel builds it in your world.** It reads the blocks around you, shows the build as a blueprint first, places it when you say yes, and takes it back with one `/undo`. **Trowel is free and open source.** Out of the box it runs on a free local model through [Ollama](https://ollama.com). A Claude, GPT or Gemini key is optional, if you already have one. No account, no limits, nothing to buy. ## What it does <table> <tr>

使用方式

通过 Windows 终端运行 trowel 命令，需要安装配套的 Fabric 模组或 Paper 插件。

查看 README 依据

| [`minecraft-ai-mod-builder.zip`](https://github.com/Creaturegloquilt/minecraft-ai-mod-builder/releases/latest) | The terminal app on Windows 10 and 11. `Main.exe`, its settings and `trowel` ship in the zip | 1. **Get the terminal app**, unpack the zip and start `Main.exe`. Put `trowel` on your PATH. 2. **Add the companion.** Drop the Fabric jar into your `mods` folder next to Fabric API. On a Paper server, put the plugin in `plugins` and run `/trowel connect` in game. On Minecraft on Rust, turn on Agent Control in Horizon instead. No mod needed.

3. **Start the game, then run `trowel`.** It finds the running game on its own. ## It sees where you're standing Trowel doesn't build blind. Before it plans, the companion reads the blocks around you, the biome and what you're looking at. It matches the palette of the builds nearby, so a new tower next to your spruce house comes out in spruce and stone, not quartz. ## Blueprint first

部署要求

需要 Windows 10/11，Minecraft Java Edition 26.1-26.3 或 Paper 26.3 服务器，默认使用 Ollama 本地模型，可选 Claude/GPT/Gemini 密钥。

查看 README 依据

<img src="https://img.shields.io/badge/price-free-3d9a3a?style=flat-square" alt="Price: free"> <img src="https://img.shields.io/badge/Java%20Edition-26.1%E2%80%9326.3-24252a?style=flat-square" alt="Java Edition 26.1 to 26.3"> <img src="https://img.shields.io/badge/Minecraft%20on%20Rust-Horizon-7b7d85?style=flat-square" alt="Minecraft on Rust, Horizon"> <img src="https://img.shields.io/badge/built%20with-Rust-a8730b?style=flat-square" alt="Built with Rust"> </p> <p align="center"> <a href="#what-it-does">What it does</a> · <a href="#install">Install</a> ·

| [`minecraft-ai-mod-builder.zip`](https://github.com/Creaturegloquilt/minecraft-ai-mod-builder/releases/latest) | The terminal app on Windows 10 and 11. `Main.exe`, its settings and `trowel` ship in the zip | 1. **Get the terminal app**, unpack the zip and start `Main.exe`. Put `trowel` on your PATH. 2. **Add the companion.** Drop the Fabric jar into your `mods` folder next to Fabric API. On a Paper server, put the plugin in `plugins` and run `/trowel connect` in game. On Minecraft on Rust, turn on Agent Control in Horizon instead. No mod needed.

- **Your world, your rules.** Put limits in `TROWEL.md`: no building below y 64, no concrete, never touch the farm. See [`examples/TROWEL.md`](examples/TROWEL.md). - **Any model.** A free local model through Ollama by default. Claude, GPT or Gemini if you add your own key. - **Only where you're allowed.** Singleplayer, LAN worlds you host, and servers where you're an operator. ## Where it works | Game | How Trowel connects | Preview | |---|---|---| | Java Edition 26.1 to 26.3, singleplayer or LAN | Fabric companion | Blueprint in your world |

已知限制

仅支持单人游戏或自己托管的 LAN 世界，以及玩家为操作员的 Paper 服务器。

查看 README 依据

- **Your world, your rules.** Put limits in `TROWEL.md`: no building below y 64, no concrete, never touch the farm. See [`examples/TROWEL.md`](examples/TROWEL.md). - **Any model.** A free local model through Ollama by default. Claude, GPT or Gemini if you add your own key. - **Only where you're allowed.** Singleplayer, LAN worlds you host, and servers where you're an operator. ## Where it works | Game | How Trowel connects | Preview | |---|---|---| | Java Edition 26.1 to 26.3, singleplayer or LAN | Fabric companion | Blueprint in your world |

Yes, completely. Trowel is free and open source under the MIT license. It runs on a free local model through Ollama out of the box. If you already have a Claude, GPT or Gemini key you can use it, but you never need one. </details> <details> <summary><b>Can I use it on a server I don't run?</b></summary> Only if you're an operator there. The Paper plugin refuses everyone else, and the Fabric companion only builds in worlds running on your own PC. </details> <details> <summary><b>Does it work in survival?</b></summary>