Baritone 使用笔记：把 Minecraft 生存模式变成“自动驾驶”

Baritone 是 Minecraft Java 版里非常有代表性的自动化工具。它不是一个独立机器人账号，也不是服务器插件，而是装在客户端里的“自动驾驶系统”。它可以控制玩家角色走路、寻路、挖矿、种田、建造、挖隧道、回家、跟随目标等。

它最适合的场景不是创造模式，也不是完全替代玩家，而是在生存模式里把重复、机械、耗时间的操作交给程序完成。比如自动收割农田、自动补种、自动找矿、自动回到起点、自动去指定坐标。这种体验很特别：游戏规则仍然存在，资源不是凭空来的，但重复劳动被机器接管了。

一、Baritone 是什么

Baritone 可以理解成：

Minecraft 玩家角色的自动驾驶系统

它会控制：

移动
跳跃
视角
挖掘
放置方块
选择路径
避开部分危险
寻找目标方块
执行建筑蓝图

但它不会生成一个新的玩家。安装 Baritone 之后，服务器里不会多出一个叫 Baritone 的角色。它控制的是当前登录的玩家本人。

所以使用 Baritone 时，看到的仍然是自己的角色。执行命令后，是自己的角色自动移动、自动挖矿、自动种田。

如果想要“站在旁边看一个机器人干活”，需要第二个 Minecraft 账号和第二个客户端。主账号旁观，副账号安装同样的模组和 Baritone，让副账号执行任务。

二、Baritone 和 Mineflayer 的区别

Mineflayer 是 Node.js 生态的 Minecraft bot 框架，可以用代码创建一个独立机器人账号登录服务器。它适合纯净服、插件服或不强制客户端模组的服务器。

Baritone 是客户端模组。它装在玩家自己的 Minecraft 客户端里，直接控制玩家角色。

两者区别大致是：

项目	Mineflayer	Baritone
形态	独立 bot 客户端	玩家客户端自动驾驶
是否生成新玩家	是	否
是否能加载 Forge/Fabric 模组	通常不行	可以，取决于版本
适合环境	原版服、插件服	模组服、生存服
自动寻路	可以	很强
自动种田	需要自己写逻辑	内置 #farm
自动挖矿	需要自己写逻辑	内置 #mine
使用门槛	偏开发	游戏内命令即可

如果服务器是 Forge / Fabric / NeoForge 模组服，而且客户端没有对应模组就会被拒绝连接，那么 Mineflayer 往往不适合。Baritone 更适合这种环境，因为它作为客户端模组加入原本的模组客户端。

三、安装时最重要的是版本匹配

Baritone 必须匹配三个东西：

Minecraft 版本
Mod Loader 类型
Baritone 对应版本

例如：

Minecraft 1.19.4
Forge
baritone-standalone-forge 对应 1.19.4 的版本

不要下载 Fabric 或 NeoForge 版本，也不要下载 1.20、1.21 的文件。

安装方式和普通 Forge 模组一样：

关闭游戏
把 Baritone jar 放入客户端 mods 文件夹
启动 Forge 客户端
进入服务器
聊天框输入 #help

如果 #help 能显示 Baritone 帮助，就说明客户端加载成功。

有些 Forge 模组服会检查客户端与服务器模组列表。如果客户端多了 Baritone，服务器端没有，可能会提示模组不兼容。理论上 Baritone 主要是客户端工具，服务器端不一定需要；但如果服务器强制 mod list 一致，可以尝试把同版本 Baritone jar 也放到服务器 mods 目录。只要服务器能正常启动，并且客户端能进入，就可以这样使用。

四、命令前缀

Baritone 默认命令前缀是：

#

例如：

#help
#stop
#farm 16
#mine iron_ore
#goto 100 64 -200

建议始终使用 # 前缀。不要直接在聊天框里输入无前缀命令，否则如果打错，有可能被当成普通聊天发出去。

五、最重要的安全命令

使用 Baritone 前，最重要的不是学会挖矿，而是学会停止。

立即停止当前任务

#stop

或者：

#cancel

如果任务异常，可以试：

#forcecancel

清除目标

#goal clear

关闭自动破坏方块

#allowBreak false

关闭自动放置方块

#allowPlace false

日常安全状态建议是：

#stop
#goal clear
#allowBreak false
#allowPlace true
#allowSprint true
#allowParkour false
#allowParkourPlace false
#avoidance true

这个配置的意思是：

停止当前任务
清除目标
默认不允许乱挖
允许放方块
允许疾跑
禁止危险跑酷路径
尽量避开怪物和危险源

需要挖矿、挖隧道、砍树、清理区域时，再临时打开：

#allowBreak true

任务结束后立刻关掉：

#allowBreak false

这是非常重要的习惯。

六、基础移动与寻路

设置目标并开始移动

#goto x y z

例如：

#goto 120 64 -300

也可以只写 X/Z：

#goto 120 -300

只写 X/Z 时，Baritone 会自己处理高度。

先设置目标，再开始寻路

#goal 120 64 -300
#path

区别是：

#goal 只是设置目标
#path 才开始执行路径

朝当前面对方向走一段距离

#thisway 20
#path

#thisway 20 是把目标设置在当前面对方向 20 格外，通常还需要接 #path 才会开始走。

回地表

在地下迷路时可以用：

#surface

或者：

#top

它会尝试寻找最近的地表或上方开放空间。

七、路标：回家、回矿区、回农田

Baritone 的 waypoint 非常实用。

保存当前位置

#wp save user home

保存家：

#wp save user farm

保存农田：

#wp save user mine_start

保存挖矿起点。

前往路标

#wp goal home
#path

去农田：

#wp goal farm
#path

回挖矿起点：

#wp goal mine_start
#path

查看路标

#wp list

死亡点

Baritone 通常会记录死亡点，可以试：

#wp goal death

然后：

#path

Waypoint 是 Baritone 深入使用时的核心功能。只要先保存好位置，很多任务就变成了：

去农田 → 自动收割 → 回家
去矿区 → 自动挖矿 → 回起点
去树林 → 自动砍树 → 回家

八、自动农田：最舒服的功能

#farm 是 Baritone 里体验最自然、最稳定、风险最低的功能之一。

站在农田附近，输入：

#farm

更推荐限制范围：

#farm 16

大一点的农田可以：

#farm 24

或者：

#farm 32

但不要一开始就开太大范围。范围过大时，它可能跑到其他农田、村庄田地或奇怪地形。

#farm 会自动做：

识别成熟作物
走过去
收获
补种
继续巡回附近农田

它适合：

小麦
胡萝卜
土豆
甜菜

比较理想的农田结构是：

9x9 农田
中间一格水
外围一圈路
旁边放箱子
周围照明充足
附近不要有洞、水流、悬崖

推荐保存农田路标：

#wp save user farm

日常使用：

#wp goal farm
#path
#farm 16

这是 Baritone 最适合长期使用的功能之一。它不会破坏生存模式的规则，只是把重复劳动交给机器完成。

九、自动挖矿：强大但要受控

自动挖矿比自动农田危险得多。农田是在平整、已知、固定区域内操作；挖矿是在地下复杂环境里操作，Baritone 会转头、挖墙、绕路、向下钻、重新规划路线。

所以挖矿要建立固定流程。

挖矿前保存起点

#wp save user mine_start

开启挖矿权限

#allowBreak true
#allowPlace true
#allowSprint true
#avoidance true

普通挖矿与 legitMine

如果想让它更像正常玩家，只挖能合理看到或发现的矿：

#legitMine true

如果想大范围找矿，利用已加载/缓存区块，并且找不到时继续探索：

#legitMine false
#exploreForBlocks true

两种模式区别：

模式	特点
#legitMine true	更自然、更保守、不容易乱跑
#legitMine false	范围更大、效率更高、行为更激烈

刚开始建议用：

#legitMine true

熟悉后再用大范围模式。

十、常见矿石命令

以下适用于 Minecraft 1.19.4 原版矿石。

煤矿

#mine coal_ore deepslate_coal_ore

限制数量：

#mine 64 coal_ore deepslate_coal_ore

铁矿

#mine iron_ore deepslate_iron_ore

限制数量：

#mine 64 iron_ore deepslate_iron_ore

铜矿

#mine copper_ore deepslate_copper_ore

限制数量：

#mine 64 copper_ore deepslate_copper_ore

金矿

#mine gold_ore deepslate_gold_ore

下界金矿：

#mine nether_gold_ore

红石矿

#mine redstone_ore deepslate_redstone_ore

青金石矿

#mine lapis_ore deepslate_lapis_ore

钻石矿

#mine diamond_ore deepslate_diamond_ore

建议限制数量：

#mine 8 diamond_ore deepslate_diamond_ore

绿宝石矿

#mine emerald_ore deepslate_emerald_ore

下界石英

#mine nether_quartz_ore

远古残骸

#mine ancient_debris

建议限制数量：

#mine 8 ancient_debris

十一、大范围挖各种矿石

如果要大范围挖主世界常见矿石，可以先设置：

#allowBreak true
#allowPlace true
#allowSprint true
#avoidance true
#legitMine false
#exploreForBlocks true
#maxCachedWorldScanCount 64
#mineMaxOreLocationsCount 256

然后执行：

#mine 256 coal_ore deepslate_coal_ore iron_ore deepslate_iron_ore copper_ore deepslate_copper_ore gold_ore deepslate_gold_ore redstone_ore deepslate_redstone_ore lapis_ore deepslate_lapis_ore diamond_ore deepslate_diamond_ore emerald_ore deepslate_emerald_ore

这里的 256 是总共挖 256 个目标方块，不是每种矿各 256 个。

如果不写数量：

#mine coal_ore deepslate_coal_ore iron_ore deepslate_iron_ore copper_ore deepslate_copper_ore gold_ore deepslate_gold_ore redstone_ore deepslate_redstone_ore lapis_ore deepslate_lapis_ore diamond_ore deepslate_diamond_ore emerald_ore deepslate_emerald_ore

它可能会持续找矿，跑很远，适合已经熟悉 Baritone 行为后再使用。

挖完回起点

#stop
#allowBreak false
#wp goal mine_start
#path

回到起点后：

#goal clear

十二、为什么挖矿时看起来像乱跑

#mine 不是“原地往下挖”。它的逻辑是：

寻找目标矿物
计算路径
走过去
必要时挖开路
挖目标矿
继续寻找下一个目标

所以它会：

突然转头
跳跃
挖墙
绕路
向下钻
回头
在洞里反复调整方向

这不是完全失控，而是路径规划的结果。

它不是按固定半径扫描。Baritone 更多是根据：

客户端已加载区块
Baritone 缓存
当前可见方块
目标方块类型
路径成本
是否允许探索

来决定去哪挖。

所以如果想要稳定，就用：

#legitMine true
#mine 16 iron_ore deepslate_iron_ore

如果想要范围大，就用：

#legitMine false
#exploreForBlocks true
#mine 256 ...

但范围越大，行为越激烈。

十三、挖矿时不要抢鼠标

Baritone 执行任务时会控制：

WASD
跳跃
视角
左键挖掘
右键放置
物品栏选择

如果玩家同时移动鼠标、按键、切换物品栏，就会出现“它在乱打、乱转、乱挖”的感觉。

正确习惯是：

Baritone 执行中，不要抢鼠标键盘
想接管，先 #stop

尤其是挖矿、砍树、建造时，先停再手动操作。

十四、自动挖隧道

挖隧道属于第二阶段功能，比挖矿更激进。

默认 1×2 隧道：

#tunnel

指定高度、宽度、长度：

#tunnel 3 2 100

可以理解为挖一个高 3、宽 2、长 100 的隧道。

使用前：

#allowBreak true
#allowPlace true

如果想让它回填后方：

#backfill true

不想回填：

#backfill false

新手不要在家附近测试 #tunnel。它会真的挖地形。

十五、自动砍树

Baritone 没有真正的“智能砍整棵树”功能。它只是把原木当成目标方块去挖。

例如：

#allowBreak true
#mine oak_log

多种木头一起：

#mine oak_log birch_log spruce_log jungle_log acacia_log dark_oak_log mangrove_log

限制数量：

#mine 32 oak_log birch_log spruce_log

如果单独使用 Baritone，可能会留下悬空木头，因为它不一定理解“整棵树”的结构。

如果安装了 Tree Chopper 这类整树砍伐模组，可以配合 Baritone 使用。理想效果是：

Baritone 找到树干并挖一块
Tree Chopper 触发整棵树砍伐
Baritone 继续找下一棵树

如果 Tree Chopper 需要半蹲才能触发，Baritone 不一定稳定配合。更适合把 Tree Chopper 设置为“不需要半蹲也能砍整棵树”。

砍树流程可以是：

#wp save user wood_start
#allowBreak true
#allowPlace true
#mine 32 oak_log birch_log spruce_log

结束：

#stop
#allowBreak false
#wp goal wood_start
#path

十六、跟随玩家或实体

跟随玩家：

#follow player 玩家名

跟随附近所有玩家：

#follow players

跟随某种实体：

#follow entity pig

停止：

#stop

这个功能只是“跟随”，不是自动打怪，也不是自动喂动物。

比如跟随猪：

#follow entity pig

Baritone 会尝试接近猪，但不会自动拿胡萝卜喂猪，也不会自动把猪赶进猪圈。

十七、畜牧自动化的限制

Baritone 不擅长自动养猪、养牛、喂动物、屠宰动物。

它可以辅助：

自动种胡萝卜
自动去猪圈
自动回家

例如：

#wp save user carrot_farm
#wp save user pigpen
#wp goal carrot_farm
#path
#farm 16
#wp goal pigpen
#path

然后手动喂猪。

完整自动养殖更适合：

畜牧类自动化模组
机械模组
红石结构
刷怪/动物农场设计
客户端宏

Baritone 的强项仍然是农田、寻路、挖矿、简单砍树和工程类任务。

十八、找方块

#find 可以查找 Baritone 缓存里知道的方块位置。

例如：

#find chest
#find iron_ore
#find diamond_ore
#find village_bell

注意，它不是全世界雷达，只能找客户端加载过或 Baritone 缓存知道的位置。

也可以直接去某类方块：

#goto chest
#goto portal
#goto ender_chest

如果它一直尝试去一个错误目标，可以用：

#blacklist

让它不要再尝试当前最近的那个目标。

十九、自动探索

从当前位置探索未知区域：

#explore

从指定坐标附近探索：

#explore 0 0

这个功能会让它不断寻找未探索区块，容易跑很远。新手慎用。

停止：

#stop

二十、自动建造 schematic

Baritone 可以根据 schematic 建造。

基础命令：

#build house.schematic

指定原点：

#build house.schematic 100 64 -200

它的逻辑是：

读取 schematic
以玩家脚下或指定坐标为原点
比较蓝图和现实世界方块
把不一致的位置列为任务
自动走位、放方块、必要时挖方块
让现实世界逐步接近蓝图

但它不是建筑 AI。它不会自动判断：

这个地形适不适合建房
房子朝向哪里好
是否需要加地基
是否要保留树木
是否要美化周围环境

它只是按照 schematic 坐标施工。

建造前建议：

#allowPlace true
#allowBreak false
#buildInLayers true
#buildIgnoreExisting true

这表示：

允许放方块
不允许拆已有方块
分层建造
已有非空气方块先忽略

如果想严格还原蓝图：

#allowBreak true
#buildIgnoreExisting false

但这样可能会挖掉地形或已有建筑，风险更高。

建议从小型原版方块建筑开始测试，不要一开始就用大型复杂建筑或模组方块建筑。

二十一、选择区域与清理区域

新版 Baritone 的区域选择相关功能可以从帮助里看：

#help sel

这类功能可能涉及选区、清理区域、批量处理地形，破坏性较强，建议熟悉农田、寻路、挖矿之后再学。

二十二、常用设置总结

是否允许破坏方块

#allowBreak true
#allowBreak false

是否允许放置方块

#allowPlace true
#allowPlace false

是否允许疾跑

#allowSprint true

是否允许跑酷路线

#allowParkour false

是否允许边跑酷边垫方块

#allowParkourPlace false

是否避开怪物和危险源

#avoidance true

挖矿是否更接近正常视野

#legitMine true

是否在找不到方块时探索

#exploreForBlocks true

挖矿缓存扫描数量

#maxCachedWorldScanCount 64

挖矿目标位置数量

#mineMaxOreLocationsCount 256

跟随距离

#followRadius 3

挖隧道是否回填

#backfill true
#backfill false

建造是否分层

#buildInLayers true

查看修改过的设置

#modified

重置设置

重置单个设置：

#allowBreak reset

重置全部：

#reset

二十三、生存模式与创造模式的意义差异

Baritone 在创造模式下也能用，但意义明显下降。

创造模式里：

可以飞
可以无限拿材料
可以瞬间破坏方块
不用找矿
不用种田获取食物
不用考虑工具耐久

所以 #mine、#farm 的意义变弱。

Baritone 的真正价值在生存模式：

资源要真实获取
路线要真实走
方块要真实挖
作物要真实收
材料要真实准备

它不会凭空创造资源，而是在规则内把重复劳动自动化。

这也是它最有意思的地方：不是取消生存模式，而是让生存模式变成“玩家设定目标，机器执行重复劳动”。

二十四、推荐的日常工作流

农田工作流

第一次：

#wp save user farm

以后：

#wp goal farm
#path
#farm 16

结束：

#stop

小范围挖铁

#wp save user mine_start
#allowBreak true
#allowPlace true
#avoidance true
#legitMine true
#mine 16 iron_ore deepslate_iron_ore

结束：

#stop
#allowBreak false
#wp goal mine_start
#path

大范围挖矿

#wp save user mine_start
#allowBreak true
#allowPlace true
#allowSprint true
#avoidance true
#legitMine false
#exploreForBlocks true
#maxCachedWorldScanCount 64
#mineMaxOreLocationsCount 256
#mine 256 coal_ore deepslate_coal_ore iron_ore deepslate_iron_ore copper_ore deepslate_copper_ore gold_ore deepslate_gold_ore redstone_ore deepslate_redstone_ore lapis_ore deepslate_lapis_ore diamond_ore deepslate_diamond_ore emerald_ore deepslate_emerald_ore

结束：

#stop
#allowBreak false
#wp goal mine_start
#path

自动砍树

#wp save user wood_start
#allowBreak true
#allowPlace true
#mine 32 oak_log birch_log spruce_log

结束：

#stop
#allowBreak false
#wp goal wood_start
#path

如果配合 Tree Chopper，效果会更好。

二十五、新手最该熟练的命令

第一组，必须熟练：

#stop
#goal clear
#allowBreak false
#allowBreak true
#goto x y z
#thisway 20
#path

第二组，日常核心：

#wp save user home
#wp goal home
#farm 16
#legitMine true
#mine 16 iron_ore deepslate_iron_ore
#surface

第三组，进阶：

#tunnel 3 2 50
#find chest
#follow player 玩家名
#build house.schematic
#help sel

结语

Baritone 最适合被当成一个“生存模式自动驾驶工具”。它不是万能 AI，也不是创造模式建筑生成器。它真正强大的地方，是在 Minecraft 原本的规则里，把玩家本来可以做、但重复又耗时间的事情自动化。

最舒服、最适合长期使用的是农业：

#farm 16

最强大但需要控制的是挖矿：

#mine ...

最实用的配套功能是 waypoint：

#wp save user home
#wp goal home
#path

只要养成三个习惯，Baritone 就会非常好用：

任务前保存位置
危险任务前确认设置
接管前先 #stop

从农业和地下挖矿开始深入学习，是最合理的方向。农业稳定、挖矿有收益，二者正好覆盖了生存模式里最常见、最重复、也最适合自动化的部分。