DolphinStronghold9/ai-minecraft-modmaker

Mortar 是一个终端 AI 代理，能把“在这座山上建一座石制瞭望塔”这样的描述变成 Minecraft 世界里的方块。它面向不想敲命令的 Java 版玩家，适合单人、局域网，或你拥有管理员权限的服务器。

它做什么

终端程序 mortar 负责规划，游戏内的配套组件读取周围地形、接收方块改动，并显示只有你能看到的半透明幽灵预览。你可以绕着预览走动、平移或旋转，再在终端确认放置。每一轮都先做快照，并写入世界文件夹下 .mortar/ 的撤销日志，因此 /undo、/redo 可以逐步回退，退出重进后仍然有效。大建筑会分批放置，保持在游戏的方块改动上限内，作者称这样不会中途被截断。/materials 按组和从原材料算起列出所需方块，/export 可导出为 .litematic、.schem 或 .nbt。

另一条使用路径是用它生成数据包而非方块：函数、进度、配方或战利品表。Mortar 会执行 /reload、读取日志、修复失败项并重新测试，不满意的数据包也能像建筑一样用 /undo 撤掉。

按游玩环境选择安装方式

不同环境需要不同的配套组件，这决定了安装流程：

• Java 版 26.1–26.3 的单人或局域网：安装 Fabric 配套组件，以及 Fabric Loader 和 Fabric API；可以从源码构建，也可以解压 Windows 便携包，把 Main.exe 和 mortar 放在一起运行（安装说明）。
• 你自己运营的 Paper 服务器：安装 Paper 插件，你必须是管理员（op）。幽灵预览只以玻璃方块形式发给你本人，其他玩家看不到。
• 通过 Horizon 运行的 Minecraft on Rust：不需要模组，打开 Agent Control 即可。目前还无法在世界里画幽灵预览，预览会在独立窗口中打开，放置时需要 Horizon 确认。

从源码构建配套组件需要 Rust 1.85+ 和 JDK 25（构建说明）。不支持基岩版。

模型、权限与隐私

开箱即用可通过 Ollama 运行免费的本地模型，也可用你自己的 key 接入 Claude、GPT 或 Gemini；作者声明 Mortar 不转售 token、不抽成。它遵守服务器权限：你本人无法执行的 /fill，Mortar 也做不到，在服务器上需要你是管理员。世界文件夹中的 MORTAR.md 可以添加规则，例如出生点附近禁止建造或限定方块配色。README 称唯一的网络请求发往你选择的模型且没有遥测，但仅凭项目描述无法独立验证。

项目采用 MIT 许可证且免费（许可证）。

撰写时 GitHub 页面显示 115 星、5 个 fork；HotRepo 在 2026-10-31 的 Java 新项目榜记录为第 6 名、共 115 星，但每日榜历史不足，无法判断趋势。这只是热度背景，不代表对项目质量的评价。