Baritone 聊天命令使用百科

Baritone 是面向 Minecraft Java 版 的开源路径寻找与自动化模组:在客户端侧为玩家提供自动寻路、挖掘、跟随、按原理图建造等能力,并通过聊天命令(默认前缀 #)与配置文件进行控制。项目由 cabaletta 组织维护,源代码、发行版与问题反馈均在 GitHub:https://github.com/cabaletta/baritone。

Baritone 通过聊天框(默认前缀 #)接收指令。下文「命令」均指在聊天框输入的内容;若未关闭无前缀聊天控制,部分客户端也支持直接输入命令名(见 聊天前缀与控制方式)。

全部设置项说明见 《Baritone 插件设置百科》。


1. 聊天前缀与控制方式

1.1 默认前缀 #

  • Baritone 的聊天控制前缀默认为 #(例如 #goto 100 64 -200)。
  • 建议始终带 # 输入命令:若在未加前缀的情况下把命令打错(例如把 goal 打成 gola),内容会作为普通聊天发到公屏,存在隐私风险。
  • 在 Impact 客户端中,还可以使用 .b 作为前缀(例如 .b click 等价于 #click)。Impact 下 .b 无法被关闭。

1.2 关闭某种聊天控制方式

需求设置项设为 false 的效果
禁止无前缀命令(必须带 #)chatControl聊天框里不能直接输入 goto,需 #goto
禁止 # 前缀命令prefixControl不能使用 # 开头的 Baritone 命令

注意:不要同时关闭所有控制方式;若误操作导致无法控制 Baritone,可删除 Minecraft 目录下的 baritone/settings.txt 后重启游戏恢复默认。


2. 版本说明与内置帮助

在 Baritone 1.2.10+、1.3.5+、1.4.2+ 中,大量命令有调整,但 #help 已大幅增强(可点击、支持 Tab 补全)。

相对旧版百科/官方 USAGE 的 1.19.4 要点:schematica 命令在本分支中已移除,取而代之的是 #litematica(依赖 Litematica 中已打开的原理图);新增 #pickup(捡物品)、#elytra(下界鞘翅远程飞行,依赖原生库)、#pause / #resume / #paused 以及路径点别名 #sethome / #home。详见 命令大全。

  • 游戏内优先输入 #help 查看当前版本命令说明。
  • 选区相关(旧版常问的 cleararea 等):使用 #help sel。
  • 死亡点、路径点、前往路径点:使用 #help wp。

3. 命令大全

本节汇总 选区命令 sel 与 常用聊天命令;命令前需加 #(或 Impact 的 .b)。

写法约定:下列表格的「命令」列使用 <参数>、[可选参数] 等形式说明应填内容,一般不在表头直接写死具体坐标、玩家名等;说明列中给出格式说明与示例。合成一整条输入时,将占位符换成你的数值或 ID 即可;更多可复制示例见 3.10 简短示例。

3.1 选区命令(sel)

sel 用于管理 Baritone 的选区(ISelectionManager),风格接近 WorldEdit:先框范围,再填充、替换、清空、几何体填充或复制粘贴。

命令名与别名:sel、selection、s。取消任务请用 #cancel / #stop(或别名 #c),不要与 sel 的子命令缩写混淆;单字母 #s 在无歧义时等价于 #sel,具体以 Tab 补全与 #help 为准。

与 #click 配合:在 #click 模式下左键拖选可快速建立选区;具体组合仍以 #help sel 为准。

3.1.1 建立与撤销选区

子命令别名说明
pos1p1、1格式:#sel pos1 或 #sel pos1 <x> <y> <z>(<x> <y> <z> 为相对坐标,基准为当前脚下方块,与同命令中其它 RelativeBlockPos 一致)。将角点 1 设为当前视角脚下方块或指定相对坐标。示例:#sel pos1;#sel pos1 ~ ~-5 ~
pos2p2、2格式:#sel pos2 或 #sel pos2 <x> <y> <z>。将角点 2 设为当前位置或指定相对坐标;必须先执行过 pos1。执行后以 pos1、pos2 为对角加入一块长方体选区,并清除暂存的 pos1。示例:#sel pos2
clearc格式:#sel clear。清除暂存的 pos1,并删除全部已加入的选区
undou格式:#sel undo。若当前正在等待 pos2(已设 pos1 未确认),则取消 pos1;否则撤销最后一次「完成 pos2 所添加」的选区,并把该选区的 pos1 恢复为待确认状态(可继续用 pos2 重设)

可多次 pos1 → pos2 添加多块长方体选区;后续填充/替换等会对所有选区一起生效(源码里会合并为 CompositeSchematic)。

3.1.2 填充、几何体与替换(需至少一块选区)

以下子命令都会调用建造进程(BuilderProcess),把选区内的目标形状交给 Baritone 去放置/破坏方块。方块 ID 使用游戏内注册名(与 #set 等一致)。

子命令别名说明
setfill、s、f格式:#sel set <方块ID>。用指定方块实心填充所有选区。示例:#sel set minecraft:stone
wallsw格式:#sel walls <方块ID>。只填四面墙(外墙)
shellshl格式:#sel shell <方块ID>。墙 + 顶面 + 底面
spheresph格式:#sel sphere <方块ID>。在选区包围盒内填实心球
hspherehsph格式:#sel hsphere <方块ID>。空心球
cylindercyl格式:#sel cylinder <方块ID> [<axis>](<axis> 为 x / y / z,默认 y)。实心圆柱
hcylinderhcyl格式:#sel hcylinder <方块ID> [<axis>]。轴同上,默认 y。空心圆柱
clearareaca格式:#sel cleararea。等价于把所有选区填成空气(内部按 set air 处理)
replacer格式:#sel replace <旧方块1> [旧方块2] … <新方块>。第一个参数起为「要被换掉」的方块类型;只要后面至少还剩 2 个参数,前面的参数都视为旧类型;最后一个参数始终是替换成的方块类型(源码中 while (args.has(2)) 再读旧类型,最后读新类型)。示例:#sel replace minecraft:grass_block minecraft:dirt minecraft:coarse_dirt

示例(完整流程):

TEXT
#sel pos1
#sel pos2
#sel set minecraft:stone
#sel cleararea

3.1.3 复制与粘贴

子命令别名说明
copycp格式:#sel copy 或 #sel copy <x> <y> <z>(<x> <y> <z> 为参考点相对坐标,默认当前脚下方块)。把当前所有选区内的方块读入内存剪贴板;参考点用于计算粘贴时的偏移。示例:#sel copy;#sel copy ~ ~ ~
pastep格式:#sel paste 或 #sel paste <x> <y> <z>。将剪贴板内容在给定原点(默认当前脚下方块)加上复制时记录的偏移后建造;必须先执行 copy。示例:#sel paste

3.1.4 扩展、收缩与平移选区

三个子命令格式相同,且都需要恰好 3 个参数(在子命令名之后):

格式:#sel <expand|contract|shift> <目标> <方向> <格数>

子命令别名说明
expandex格式:上式中子命令填 expand。沿指定方向扩大选区。示例:#sel expand all up 5
contractct格式:上式中子命令填 contract。沿某方向收缩选区。示例:#sel contract all north 2
shiftsh格式:上式中子命令填 shift。整体平移选区(不改变尺寸)。示例:#sel shift newest east 3

<目标>(选哪些选区参与变换):

  • all / a:全部选区
  • newest / n:仅最新一块
  • oldest / o:仅最旧一块

<方向>:使用命令系统的方向解析(如 up、north 等,与 Tab 补全一致)。<格数>:整数。

3.1.5 渲染与设置

  • 全局选区线框、透明度等见 《设置百科》中的「选区渲染」。
  • 当 renderSelectionCorners 为 true 时,已设置但未配对的 pos1 会单独用 colorSelectionPos1 画出一个角点线框(见 SelCommand 内 onRenderPass)。

3.2 帮助与信息

命令说明
help格式:#help 或 #help <子主题>(如选区、路径点)。打开帮助(新版中可点击、可 Tab 补全)。示例:#help;#help sel
version格式:#version。查看当前 Baritone 版本
eta格式:#eta。查看预计到达下一段路径/目标的时间(到目标的整体 ETA 可能很不准)
proc格式:#proc。查看当前控制 Baritone 的进程相关信息
set(别名 setting / settings)格式:见 聊天中直接修改设置 与 #help set。查看或修改设置
damn格式:#damn。彩蛋(daniel)

3.3 目标与路径

命令说明
thisway <距离> → path格式:先 #thisway <距离>,再 #path。先朝当前面向方向走约指定格数,再规划路径。示例:#thisway 1000,然后 #path
goal <坐标>格式:#goal <x> <y> <z>、#goal <x> <z> 或 #goal <y>(具体组合以当前版本 #help 为准)。设置目标坐标后,再输入 #path 开始寻路。示例:#goal 100 64 -200
goto <坐标>格式:与 goal 的坐标形式相同。立即走路前往坐标点。示例:#goto 100 64 -200
goal格式:无参数的 #goal。将目标设为自己脚下位置(可配合类似灵魂出窍模组使用)
goal clear格式:#goal clear。清除目标
pause(p / paws)格式:#pause 等。暂停 Baritone(路径、建造、跟随等均暂停,直至 resume)
resume(r / unpause / unpaws)格式:#resume 等。从暂停恢复;同时会调用建造进程的 resume()
paused格式:#paused。查询当前是否处于暂停状态
cancel / c / stop格式:#cancel、#c 或 #stop。停止当前任务;若处于暂停会先清除暂停状态
forcecancel格式:#forcecancel。在 cancelEverything() 之外再调用 forceCancel(),比 cancel 更「硬」

3.4 前往方块与点击寻路

命令说明
goto <方块类型或 ID>格式:#goto <方块类型>(游戏内注册名或常用别名,以 Tab 补全与 #help 为准)。前往某类方块。示例:#goto portal;#goto ender_chest
click格式:#click。屏幕点击寻路:右键点到方块顶部走过去;左键点进方块(脚或眼高度);左键拖选可建立选区,再配合 #sel 做填充/清空等(详见 #help sel)

在 Impact 中,.goto 常作为 .b goto 的别名,行为与「前往方块」类命令类似。

3.5 挖掘

命令说明
mine <方块类型> [<方块类型> …]格式:#mine 后跟一个或多个方块类型(可多类型)。挖掘指定矿石或方块。示例:#mine diamond_ore iron_ore
mine <数量> <方块类型>格式:#mine <数量> <方块类型>。挖掘到指定数量为止。示例:#mine 64 diamond_ore
设置项 legitMine在设置中开启后,只挖「视野内真正看见」的矿;默认在 legitMineYLevel(1.19.4 为 -59)附近探索找矿

3.6 跟随、拾取与路径点

命令说明
follow player <玩家名>格式:#follow player <玩家名>。跟随指定玩家。示例:#follow player Steve
follow players格式:#follow players。跟随范围内任意玩家
follow entities格式:#follow entities。跟随任意实体
follow entity <实体类型>格式:#follow entity <类型>。跟随指定类型实体。示例:#follow entity pig
pickup格式:#pickup。捡起掉落物(全部)
pickup <物品ID> [<物品ID> …]格式:#pickup 后跟一个或多个物品 ID(与游戏注册名一致)。只捡指定类型的物品。示例:#pickup minecraft:diamond
wp(waypoints / waypoint)格式:见 #help wp。路径点系统。标签含义示例:home(右键床可自动生成)、death(死亡自动生成)、user(需手动保存)
sethome格式:#sethome。等价于 waypoints save home(保存家路径点)
home格式:#home。等价于 waypoints goto home(前往家路径点)
wp save user <名称>格式:#wp save user <名称>。保存用户路径点。示例:#wp save user coolbiome
wp goal <名称>(wp g <名称>)格式:#wp goal <名称>。仅将目标设为该路径点,再 #path 开始走。示例:#wp goal coolbiome;#wp g coolbiome
wp goto <名称>格式:#wp goto <名称>。设目标并立即开始寻路。示例:#wp goto coolbiome
wp goal death格式:#wp goal death。列出死亡路径点(新版中可点击选择)

3.7 建筑与隧道

命令说明
build <文件名.schematic>格式:#build <文件名>。从 schematics/ 下加载原理图,原点为玩家脚下方块。示例:#build blah.schematic
build <文件名.schematic> <x> <y> <z>格式:#build <文件名> <x> <y> <z>。指定原点坐标;可使用 ~ 相对坐标。示例:#build blah.schematic ~ 69 ~-420
litematica [<序号>]格式:#litematica 或 #litematica <序号>。建造 Litematica 中当前打开的原理图;序号为原理图编号(从 1 起,省略为第一个)
tunnel格式:#tunnel。挖 1×2 隧道;仅在必要时绕开熔岩等
tunnel <高> <宽> <深>格式:#tunnel <高> <宽> <深>。指定尺寸的「直条清空」,更接近简单 cleararea 行为。示例:#tunnel 3 2 100

3.8 农场、轴线、探索、鞘翅与其它移动

命令说明
farm格式:#farm。自动收割、补种、骨粉等
farm <范围>格式:#farm <范围>。限制离起始点的最大距离
farm <范围> <路径点>格式:#farm <范围> <路径点>。相对某路径点限制范围
axis格式:#axis。前往主世界/对角轴线(高度默认 Y=120,由 axisHeight 设置)
explore [<x> <z>]格式:#explore 或 #explore <x> <z>。从未探索过的区块中持续向「离原点最近」的区块寻路;省略坐标则默认以玩家脚下为原点。示例:#explore;#explore 0 0
explorefilter <过滤器.json>格式:#explorefilter <文件名>。可选过滤器,限制要加载的区块列表(可配合 invert)
invert格式:#invert。反转当前目标:尽量远离目标而非靠近。示例:先 #goal … 再 #invert,会从当前位置尽量跑远
come格式:#come。让 Baritone 朝你相机方向移动(自由视角下玩家实体不动时有用)
blacklist格式:#blacklist。将「最近的那类目标方块」拉黑,之后不再尝试前往
surface / top格式:#surface 或 #top。前往最近的「地表式」区域(地表或最高可用空气层)
elytra [子命令]格式:#elytra 及子命令(见 #help elytra)。
仅下界有效:在已设置目标(goal/goto 等)且通过条款后,自动鞘翅飞往当前目标;
示例:#elytra(立即开始飞向目标) #elytra supported(是否支持);#elytra reset(重置状态);#elytra repack(把视野内区块排队交给原生库)
使用种子预测地形、耐久过低时自动更换鞘翅等设置请参照这里

3.9 缓存、查找与渲染

命令说明
repack格式:#repack。重新缓存周围区块
reloadall格式:#reloadall。重载 Baritone 世界缓存
saveall格式:#saveall。保存 Baritone 世界缓存
find格式:#find(具体参数以 #help find 为准)。在 Baritone 缓存中搜索并尝试定位某方块位置
render格式:#render。尝试修复错误区块渲染(无需重载全部区块)
gc格式:#gc。调用 System.gc(),可能释放部分内存

3.10 简短示例

以下为上文「命令」的完整输入示例(实际使用时需加前缀 #,Impact 可用 .b 等价替换)

TEXT
#goto 100 64 -200        // 前往坐标 (100, 64, -200)
#mine diamond_ore        // 挖掘钻石矿(不限数量)
#mine 64 iron_ore        // 挖掘 64 个铁矿石
#follow player Steve     // 跟随名为 Steve 的玩家
#build 房子.schematic     // 按原理图自动建造
#tunnel                  // 开始挖隧道
#sel pos1                // 设置选区第一个角点
#sel pos2                // 设置选区第二个角点并完成框选
#sel cleararea           // 将当前选区清空为空气
#pause                   // 暂停当前 Baritone 任务
#resume                  // 恢复已暂停的任务
#cancel                  // 取消当前任务

更多子命令与别名以 #help 为准;选区详见同节 选区命令(sel)。


4. 聊天中直接修改设置

在聊天中可直接改设置(通常仍需 # 前缀,具体以客户端为准)。实现上,单独输入的设置名会被转成对 set 命令的调用。

  • 布尔开关:只输入设置名会执行 set toggle <设置名>,例如 #allowBreak。
  • 带一个参数:<设置名> <值> 会执行 set <设置名> <值>,例如 #primaryTimeoutMS 250。
  • 大小写不敏感(设置名匹配不区分大小写)。
  • set 命令(推荐显式使用,与 #help set 一致):
    • set 或 set list [页]:列出全部设置;
    • set modified [页]:仅列出已修改项(同别名 modified / mod 等);
    • set <设置名>:查看当前值;
    • set <设置名> <值>:写入值;
    • set toggle <设置名>:切换布尔;
    • set reset <设置名>:恢复单项默认;set reset all 恢复全部(需确认);
    • set save / set load [文件名]:保存或从 minecraft/baritone/ 下加载配置。
  • 单项恢复默认(简写):acceptableThrowawayItems reset 等形式仍可用。
  • 全部恢复默认:reset(实为 set reset 的别名)。
  • 仅 API 可改:logger、notifier、toaster 等标记为 Java-only 的项无法在聊天中修改,尝试设置会提示只能通过 API 使用。

各设置项含义与默认值见 《Baritone 插件设置百科》。

MinecraftBaritoneMinecraft

评论区加载中,请稍候...