cabaletta/baritone

项目介绍

Baritone 是 Minecraft 的寻路机器人兼模组。它用 A* 寻路在游戏世界里规划路线并自动执行，你用聊天命令给出目标——坐标、要挖的方块或目的地——它就会把玩家带过去。README 说明它自 4.4 起就是 Impact 客户端使用的寻路系统 README，也是 1.8.9 时代 MineBot 面向 1.12.2 及以后版本的重建版，侧重可靠性和路径计算速度。适用对象是想自动赶路或采集资源的 Minecraft 玩家，以及想把寻路能力嵌入自己客户端的开发者。

核心是寻路规划器以及建立在其上的各类流程：前往目标、挖矿、建造和鞘翅飞行。大部分功能通过聊天命令就能用，Java API 则用于程序化控制。

快速使用

1. 确认 Minecraft 版本和模组加载器。项目为 Forge、Fabric 和较新版本上的 NeoForge 提供预编译 jar，覆盖多个 Minecraft 版本 发布下载。
2. 按 README 的发布表选择与你的游戏版本和加载器对应的 baritone-api-<加载器>-<版本>.jar，放进 mods 目录。Fabric 和 NeoForge 需要先装好对应加载器。
3. 启动游戏，在聊天栏输入 #goto 1000 500 走到 x=1000、z=500，或输入 #mine diamond_ore 挖钻石矿；输入 #stop 停止 README。
4. 更多命令见 使用文档，jar 表未覆盖的安装情形见 安装说明。

项目还提供供自定义客户端使用的 Java API，README 中的示例如下：

BaritoneAPI.getSettings().allowSprint.value = true;
BaritoneAPI.getSettings().primaryTimeoutMS.value = 2000L;
BaritoneAPI.getProvider().getPrimaryBaritone().getCustomGoalProcess().setGoalAndPath(new GoalXZ(10000, 20000));

README 特别说明：API 发布 jar 只支持 baritone.api 包内的内容，包外类不属于支持范围。

使用约束

• 预编译 jar 与具体的 Minecraft 版本和模组加载器绑定。发布表中没有的版本/加载器组合，需要按安装说明处理或从源码构建。
• API 面向自定义工具客户端，使用须遵守 LGPL 3.0 FAQ。项目许可证为 LGPL-3.0，附 anime exception。
• baritone.api 之外的类不属于受支持的 API，依赖内部类可能在版本更新后失效。
• 机器人向 Minecraft 服务器发送真实玩家操作。在某个服务器上是否允许这样做取决于该服务器的规则，而不是模组本身。

HotRepo 点评

在 2026-11-01 的 Java 日榜记录中，Baritone 新增 7 Star，当天最好名次为第 16；仓库总计 9,335 Star、2,088 Fork。对一个 2018 年创建的项目来说，单日这个数字不算高，而且目前只有这一条快照，不足以判断趋势。这条记录能说明的是：一个发布多年的游戏工具仍会出现在 Java 榜单里，这与它作为多个 Minecraft 客户端可复用寻路层的定位相符。