DolphinStronghold9/ai-minecraft-modmaker

选用指南

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

使用方式

通过终端运行 mortar 命令，在游戏中用自然语言描述建筑，使用幽灵预览和命令交互。

查看 README 依据

| A Paper server you run | The Paper plugin in `plugins` ([build it](#build-from-source)). You need to be an operator | | Minecraft on Rust ([Horizon](https://github.com/horizon-rust/horizon)) | Nothing. Turn on **Agent Control** in Horizon's settings | ## How to use 1. Join your world and stand where you want to build. 2. Run `mortar` in a terminal. 3. Say what you want. Walk around the ghost, then press **1** to place it. ```text › a stone watchtower on this hill, spruce roof, ladder inside › widen the path to the village to three blocks and light it every 8 blocks

部署要求

需要 Windows 10/11，Java Edition 26.1–26.3 配合 Fabric 或 Paper，或 Horizon；默认使用 Ollama 本地模型，也可使用 Claude、GPT 或 Gemini 的 API 密钥。

查看 README 依据

<img src="https://img.shields.io/badge/price-free-7fd49a?style=flat-square" alt="Free"> <img src="https://img.shields.io/badge/Java%20Edition-26.1%E2%80%9326.3-9aa3b2?style=flat-square" alt="Java Edition 26.1 to 26.3"> <img src="https://img.shields.io/badge/works%20with-Fabric%20%C2%B7%20Paper%20%C2%B7%20Horizon-5fa8d3?style=flat-square" alt="Works with Fabric, Paper and Horizon"> <img src="https://img.shields.io/badge/built%20with-Rust-e2763a?style=flat-square" alt="Built with Rust"> </p> <p align="center"> <a href="#install">Install</a> · <a href="#how-to-use">How to use</a> ·

Mortar is an AI agent in your terminal that builds in your Minecraft world. A small companion mod lets it see where you're standing. It shows the build as a ghost you can walk around, and it only places the blocks when you say yes. One `/undo` puts everything back. It writes datapacks too. It's free and open source. Out of the box it runs on a free local model through [Ollama](https://ollama.com); if you already have a key for Claude, GPT or Gemini, it works with that too. No credits, no quotas, no paid tier. ## Install | System | File | |---|---|

| Windows 10 and 11 | [`ai-minecraft-modmaker.zip`](https://github.com/DolphinStronghold9/ai-minecraft-modmaker/releases/latest) — `Main.exe`, its settings and `mortar` | Unpack the zip and start `Main.exe`. Keep `mortar` beside it. Then add the companion for the place you play: | Where you play | What to install | |---|---| | Singleplayer or LAN, Java Edition 26.1–26.3 | The Fabric companion in your `mods` folder, with Fabric Loader and Fabric API ([build it](#build-from-source)) |

已知限制

不支持 Bedrock 版；在服务器上需要操作员权限；Horizon 版本无法在游戏中显示幽灵预览，而是单独窗口。

查看 README 依据

- **The Fabric companion** runs in your game. It reads the area around you and draws the ghost. It talks to `mortar` over a WebSocket on `localhost` and nowhere else. - **The Paper plugin** does the same on a server. The ghost is sent only to you, as glass in the shape of the build. Other players never see it. - **Horizon** needs no mod. Mortar uses Horizon's built-in Agent Control (`horizon-ctl mcp`). Horizon can't draw a ghost in the world yet, so there the preview opens in a window of its own, and placing asks Horizon to confirm.

Only on servers where you're an operator, and only if the server allows it. Mortar never works around permissions. If you can't run `/fill`, Mortar can't either. </details> <details> <summary><b>Does it work on Bedrock Edition?</b></summary> Not today. Mortar supports Java Edition 26.1 to 26.3 through Fabric or Paper, and Minecraft on Rust through Horizon. </details> <details> <summary><b>What does it cost?</b></summary> Nothing. Mortar is free and open source, and with a local model the whole thing costs $0. If you pick a cloud model, you pay only your provider; Mortar takes nothing.