Baritone 插件设置百科

发布日期：2026年3月25日最后更新于：2026年4月19日Minecraft

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

Baritone 的路径规划、挖掘、建筑等行为由大量可调选项控制。本文按类别列出各设置项的说明；聊天前缀、#help、选区命令与完整命令列表见《Baritone 聊天命令使用百科》。

1. 基础设置

1.1 聊天控制

设置项	类型	默认值	说明
`chatControl`	Boolean	`true`	允许通过聊天命令控制 Baritone
`chatControlAnyway`	Boolean	`false`	强制启用聊天控制（即使其他客户端尝试禁用）
`prefixControl`	Boolean	`true`	允许使用前缀运行 Baritone 命令
`prefix`	String	`"#"`	命令前缀（如 `#goto`）
`echoCommands`	Boolean	`true`	运行命令时是否在聊天中回显
`shortBaritonePrefix`	Boolean	`false`	使用短前缀 `[B]` 代替 `[Baritone]`
`useMessageTag`	Boolean	`false`	写入聊天时使用新版消息标签样式，而非文本前缀
`verboseCommandExceptions`	Boolean	`false`	是否把命令异常完整栈追踪打印到标准输出（含简单语法错误）

1.2 隐私设置

设置项	类型	默认值	说明
`censorCoordinates`	Boolean	`false`	在目标和方块位置中审查坐标
`censorRanCommands`	Boolean	`false`	审查运行命令的参数（如隐藏 `#goal` 的坐标）

1.3 日志与通知

设置项	类型	默认值	说明
`chatDebug`	Boolean	`false`	在聊天中打印所有调试信息
`logAsToast`	Boolean	`false`	在右上角显示弹窗通知（类似成就提示）
`toastTimer`	Long	`5000`	弹窗显示时间（毫秒），建议不低于 1000
`desktopNotifications`	Boolean	`false`	启用桌面通知
`notificationOnPathComplete`	Boolean	`true`	路径完成时发送桌面通知
`notificationOnBuildFinished`	Boolean	`true`	建筑完成时发送桌面通知
`notificationOnMineFail`	Boolean	`true`	挖掘失败时发送桌面通知
`notificationOnFarmFail`	Boolean	`true`	农场失败时发送桌面通知
`notificationOnExploreFinished`	Boolean	`true`	探索完成时发送桌面通知

2. 移动与路径规划

2.1 基础移动权限

设置项	类型	默认值	说明
`allowSprint`	Boolean	`true`	允许疾跑
`sprintInWater`	Boolean	`true`	在水中继续疾跑
`sprintAscends`	Boolean	`true`	在上升时提前疾跑跳跃
`allowInventory`	Boolean	`false`	允许移动物品到快捷栏
`ticksBetweenInventoryMoves`	Integer	`1`	物品移动间隔（刻）
`inventoryMoveOnlyIfStationary`	Boolean	`false`	仅在静止时移动物品（适用于 2b2t 等反作弊服务器）

2.2 跳跃与跑酷

设置项	类型	默认值	说明
`allowParkour`	Boolean	`false`	允许跑酷跳跃（不稳定，容易掉落）
`allowParkourPlace`	Boolean	`false`	允许跑酷时放置方块（较可靠）
`allowParkourAscend`	Boolean	`true`	允许跑酷式上升（需 `allowParkour` 为 true）
`allowJumpAtBuildLimit`	Boolean	`false`	允许在高度上限处跑酷起跳（脚位于 Y=256 等）；在 Constantiam 等服上常需保持关闭
`allowJumpAt256`	Boolean	`false`	已弃用，仅占位兼容 API；请使用 `allowJumpAtBuildLimit`
`jumpPenalty`	Double	`2.0`	跳跃惩罚值（消耗饥饿值）
`allowDiagonalDescend`	Boolean	`false`	允许对角下降（比跑酷安全，但在下界不安全）
`allowDiagonalAscend`	Boolean	`false`	允许对角上升（较安全）
`allowOvershootDiagonalDescend`	Boolean	`true`	允许在对角下降时过度冲刺
`assumeStep`	Boolean	`false`	假设有自动迈步功能（上升时不跳跃）

2.3 液体与特殊移动

设置项	类型	默认值	说明
`allowWaterBucketFall`	Boolean	`true`	允许高空水桶落地（可靠性存疑）
`assumeWalkOnWater`	Boolean	`false`	假设可以在水面上行走（需外部库支持）
`assumeWalkOnLava`	Boolean	`false`	假设可以在熔岩上行走（需抗火+Jesus）
`walkOnWaterOnePenalty`	Double	`3.0`	水上行走惩罚（消耗饥饿快）
`strictLiquidCheck`	Boolean	`false`	严格液体检查（启用后不允许破坏液体旁的方块）

2.4 路径算法设置

设置项	类型	默认值	说明
`costHeuristic`	Double	`3.563`	A* 启发式系数（重要）。低于约 3.56 且为低估时可保证最优；`≥3.57` 且开启疾跑、或仅行走时 `≥4.64`，计算更快但路径可能次优；再高会趋向「直奔目标」、几乎不搜旁路（与源码注释一致）
`avoidance`	Boolean	`false`	启用生物避让（有性能开销）
`mobAvoidanceCoefficient`	Double	`1.5`	生物避让系数（1.0 禁用）
`mobAvoidanceRadius`	Integer	`8`	生物避让半径（格）
`mobSpawnerAvoidanceCoefficient`	Double	`2.0`	刷怪笼避让系数
`mobSpawnerAvoidanceRadius`	Integer	`16`	刷怪笼避让半径（格）
`backtrackCostFavoringCoefficient`	Double	`0.5`	回溯成本偏好系数（1.0 禁用）

2.5 路径执行与优化

设置项	类型	默认值	说明
`movementTimeoutTicks`	Integer	`100`	移动超时时间（刻），超过则取消
`maxCostIncrease`	Double	`10.0`	路径成本增加上限，超过则重新计算
`costVerificationLookahead`	Integer	`5`	成本验证前瞻距离（防止走进岩浆等）
`pathCutoffFactor`	Double	`0.9`	静态截断因子（0.9 表示截断最后 10% 路径）
`pathCutoffMinimumLength`	Integer	`30`	最小应用截断的路径长度
`splicePath`	Boolean	`true`	拼接连续路径段
`maxPathHistoryLength`	Integer	`300`	最大路径历史长度
`pathHistoryCutoffAmount`	Integer	`50`	历史路径截断数量
`overshootTraverse`	Boolean	`true`	允许越过目标一格后标记为成功（适用于高速移动）
`walkWhileBreaking`	Boolean	`true`	破坏前方方块时不停止前进

2.6 超时设置

设置项	类型	默认值	说明
`primaryTimeoutMS`	Long	`500`	主超时时间（找到路径后）
`failureTimeoutMS`	Long	`2000`	失败超时时间（强制上限）
`planAheadPrimaryTimeoutMS`	Long	`4000`	提前规划主超时
`planAheadFailureTimeoutMS`	Long	`5000`	提前规划失败超时
`slowPath`	Boolean	`false`	调试模式（极慢路径计算）
`slowPathTimeDelayMS`	Long	`100`	慢速模式下每节点延迟
`slowPathTimeoutMS`	Long	`40000`	慢速模式超时

3. 挖掘与放置

3.1 基础权限

设置项	类型	默认值	说明
`allowBreak`	Boolean	`true`	允许破坏方块
`allowPlace`	Boolean	`true`	允许放置方块
`allowPlaceInFluidsSource`	Boolean	`true`	允许在静态液体（源）中放置方块
`allowPlaceInFluidsFlow`	Boolean	`true`	允许在流动液体中放置方块
`allowDownward`	Boolean	`true`	允许向下挖掘（脚下）；关闭后会更倾向修楼梯而非竖井
`blockPlacementPenalty`	Double	`20.0`	放置方块惩罚（值越高越节约方块）
`blockBreakAdditionalPenalty`	Double	`2.0`	破坏方块的额外惩罚（避免破坏火等）

3.2 方块列表设置

设置项	类型	默认值	说明
`blocksToDisallowBreaking`	`List<Block>`	`[]`	禁止破坏的方块列表
`blocksToAvoidBreaking`	`List<Block>`	`[工作台, 熔炉, 箱子, 陷阱箱]`	尽量避免破坏的方块（1.19.4 默认不含告示牌）
`avoidBreakingMultiplier`	Double	`0.1`	避免破坏系数（大于 1 则变相鼓励破坏）
`allowBreakAnyway`	`List<Block>`	`[]`	即使 `allowBreak` 为 false 也允许破坏的方块
`acceptableThrowawayItems`	`List<Item>`	`[泥土, 圆石, 地狱岩, 石头]`	可丢弃/放置的物品（垫脚用）
`blocksToAvoid`	`List<Block>`	`[绊线]`	路径避让用的方块列表（默认含 `tripwire`）

3.3 工具与效率

设置项	类型	默认值	说明
`autoTool`	Boolean	`true`	自动选择最佳工具
`assumeExternalAutoTool`	Boolean	`false`	假设外部提供自动选工具功能（Baritone 不执行但路径计算时考虑）
`considerPotionEffects`	Boolean	`true`	考虑药水效果（挖掘疲劳/急迫）调整破坏成本
`itemSaver`	Boolean	`false`	工具耐久保护（即将损坏时停止使用）
`itemSaverThreshold`	Integer	`10`	工具保护耐久阈值
`preferSilkTouch`	Boolean	`false`	优先使用精准采集工具（不牺牲速度）
`useSwordToMine`	Boolean	`true`	使用剑挖掘

3.4 破坏节奏与视角随机（1.19.4）

设置项	类型	默认值	说明
`blockBreakSpeed`	Integer	`6`	破坏一块与开始破坏下一块之间的间隔（tick）；游戏默认约 6；小于 1 会被钳制；仅对非 1 tick 挖完的有效
`randomLooking113`	Double	`2.0`	每 tick 随机偏转水平视角（度），`0` 关闭（另见视角设置中的 `randomLooking`）

3.5 安全设置

设置项	类型	默认值	说明
`avoidUpdatingFallingBlocks`	Boolean	`true`	避免触发连锁沙子/砾石下落
`pauseMiningForFallingBlocks`	Boolean	`true`	等待下落方块稳定后再继续
`maxFallHeightNoWater`	Integer	`3`	无水桶时最大安全跌落高度（3 = 无伤害）
`maxFallHeightBucket`	Integer	`20`	有水桶时最大跌落高度（默认低于致死高度 23）

4. 建筑系统

4.1 基础建筑设置

设置项	类型	默认值	说明
`buildInLayers`	Boolean	`false`	分层建造（完成当前层再建下一层）
`layerOrder`	Boolean	`false`	建造顺序（false=从下到上，true=从上到下）
`layerHeight`	Integer	`1`	每层高度
`startAtLayer`	Integer	`0`	从指定层开始建造
`skipFailedLayers`	Boolean	`false`	跳过无法建造的层
`buildOnlySelection`	Boolean	`false`	仅建造选区内的部分
`mapArtMode`	Boolean	`false`	地图艺术模式（只关心每列最上方的方块）

4.2 建筑重复与方向

设置项	类型	默认值	说明
`buildRepeat`	Vec3i	`(0, 0, 0)`	重复建造偏移（0 禁用某轴）
`buildRepeatCount`	Integer	`-1`	重复次数（-1 无限）
`buildRepeatSneaky`	Boolean	`true`	静默重复（不通知原理图移动）
`schematicOrientationX`	Boolean	`false`	以最高 X 为原点（非最低）
`schematicOrientationY`	Boolean	`false`	以最高 Y 为原点
`schematicOrientationZ`	Boolean	`false`	以最高 Z 为原点
`schematicFallbackExtension`	String	`"schematic"`	默认原理图扩展名

4.3 方块处理规则

设置项	类型	默认值	说明
`buildIgnoreBlocks`	`List<Block>`	`[]`	视为空气的方块（原理图要求空气时这些方块可存在）
`buildSkipBlocks`	`List<Block>`	`[]`	视为正确的方块（原理图要求这些方块时任意方块都通过）
`buildValidSubstitutes`	Map	`{}`	有效替代方块映射（接受列表中任意方块）
`buildSubstitutes`	Map	`{}`	建造替代映射（放置映射列表中第一个可放的方块）；语法示例：`stone->cobblestone,andesite,oak_planks->birch_planks`
`okIfAir`	`List<Block>`	`[]`	这些方块位置可以是空气
`okIfWater`	Boolean	`false`	允许当前为水的方块不修正
`buildIgnoreExisting`	Boolean	`false`	忽略已有非空气方块（只放置新方块）
`buildIgnoreDirection`	Boolean	`false`	忽略方块朝向（如带釉陶瓦）
`buildIgnoreProperties`	`List<String>`	`[]`	忽略特定方块属性

4.4 建筑性能与行为

设置项	类型	默认值	说明
`incorrectSize`	Integer	`100`	错误方块集合大小上限
`breakCorrectBlockPenaltyMultiplier`	Double	`10.0`	破坏「原理图认为正确」方块的惩罚倍数
`placeIncorrectBlockPenaltyMultiplier`	Double	`2.0`	放置「原理图认为错误」方块时的惩罚倍数
`buildSchematicRotation`	枚举	`NONE`	建造前旋转原理图：`NONE` / `CLOCKWISE_90` / `CLOCKWISE_180` / `COUNTERCLOCKWISE_90`
`buildSchematicMirror`	枚举	`NONE`	建造前镜像：`NONE` / `FRONT_BACK`（本地 X）/ `LEFT_RIGHT`（本地 Z）
`builderTickScanRadius`	Integer	`5`	每刻扫描更新半径（超大原理图可略高于交互距离）
`distanceTrim`	Boolean	`true`	修剪远处错误位置（提升性能但降低大原理图可靠性）
`cancelOnGoalInvalidation`	Boolean	`true`	目标失效时取消路径（如矿石被破坏后立即停止）
`breakFromAbove`	Boolean	`false`	允许从上方破坏方块（实验性）
`goalBreakFromAbove`	Boolean	`false`	同时设置目标在方块上方侧面（需配合 `breakFromAbove`）

5. 农场与采集

5.1 农场设置

设置项	类型	默认值	说明
`replantCrops`	Boolean	`true`	收割后重新种植作物（留下仙人掌/甘蔗再生）
`replantNetherWart`	Boolean	`false`	重新种植地狱疣（需 `replantCrops` 启用）
`farmMaxScanSize`	Integer	`256`	农场每轮最多扫描的方块数

5.2 挖掘设置

设置项	类型	默认值	说明
`mineGoalUpdateInterval`	Integer	`5`	挖掘目标更新间隔（刻，0 禁用）
`maxCachedWorldScanCount`	Integer	`10`	缓存中找到目标方块后停止向外扩展搜索的数量
`mineMaxOreLocationsCount`	Integer	`64`	挖掘过程记住的目标位置数量上限（另受 `maxCachedWorldScanCount` 约束）
`minYLevelWhileMining`	Integer	`0`	挖掘最低 Y；`0` 表示不限制；负高度世界需按「相对世界最低层」换算
`maxYLevelWhileMining`	Integer	`2031`	挖掘最高 Y（1.19.4 默认上界很大，实际由地形决定）
`allowOnlyExposedOres`	Boolean	`false`	仅挖掘暴露的矿石（防矿物追踪插件）
`allowOnlyExposedOresDistance`	Integer	`1`	暴露检测距离（建议保持较低，计算开销大）
`mineScanDroppedItems`	Boolean	`true`	将掉落物视为挖掘目标
`mineDropLoiterDurationMSThanksLouca`	Long	`250`	挖掘后等待掉落物时间（毫秒）
`legitMine`	Boolean	`false`	合法挖掘模式（仅挖掘可见矿石，不使用 X-Ray）
`legitMineYLevel`	Integer	`-59`	合法条带挖掘参考高度（1.19 深板岩层附近；旧版常见为 11）
`legitMineIncludeDiagonals`	Boolean	`false`	合法模式包含对角矿石（可能看穿岩浆）
`forceInternalMining`	Boolean	`true`	尝试一次挖掘两个相邻目标方块
`internalMiningAirException`	Boolean	`true`	仅当相邻方块非空气时应用内部挖掘

5.3 探索设置

设置项	类型	默认值	说明
`exploreForBlocks`	Boolean	`true`	找不到方块时随机探索（而非放弃）
`worldExploringChunkOffset`	Integer	`0`	探索时最近未加载区块偏移（设为渲染距离更高效）
`exploreChunkSetMinimumSize`	Integer	`10`	最小探索区块集合大小
`exploreMaintainY`	Integer	`64`	探索时保持的 Y 层级（-1 禁用）
`extendCacheOnThreshold`	Boolean	`false`	缓存结果低于阈值时也扫描主世界（需强力 CPU）
`blacklistClosestOnFailure`	Boolean	`true`	失败时将最近方块标记为不可达并寻找下一个

6. 渲染与视觉

6.1 路径渲染

设置项	类型	默认值	说明
`renderPath`	Boolean	`true`	渲染路径
`renderPathAsLine`	Boolean	`false`	以线条形式渲染路径（而非立体效果）
`renderPathIgnoreDepth`	Boolean	`true`	路径渲染忽略深度
`pathRenderLineWidthPixels`	Float	`5.0`	路径线条宽度（像素）
`fadePath`	Boolean	`false`	路径渐隐（20 格后开始淡出，30 格后隐藏，提升 FPS）
`colorCurrentPath`	Color	红色	当前路径颜色
`colorNextPath`	Color	品红色	下一段路径颜色
`colorBestPathSoFar`	Color	蓝色	当前最佳路径颜色
`colorMostRecentConsidered`	Color	青色	最近考虑节点路径颜色

6.2 目标渲染

设置项	类型	默认值	说明
`renderGoal`	Boolean	`true`	渲染目标
`renderGoalAnimated`	Boolean	`true`	目标动画效果（而非静态盒子）
`renderGoalIgnoreDepth`	Boolean	`true`	目标渲染忽略深度
`renderGoalXZBeacon`	Boolean	`false`	使用信标光束效果渲染 XZ 目标（与忽略深度同时启用会有裁剪问题）
`goalRenderLineWidthPixels`	Float	`3.0`	目标线条宽度
`colorGoalBox`	Color	绿色	目标盒子颜色
`colorInvertedGoalBox`	Color	红色	反转目标盒子颜色
`yLevelBoxSize`	Double	`15.0`	Y 层级目标盒子大小

6.3 选择框渲染

设置项	类型	默认值	说明
`renderSelectionBoxes`	Boolean	`true`	渲染选择框（破坏/放置/走入的方块）
`renderSelectionBoxesIgnoreDepth`	Boolean	`true`	选择框忽略深度
`colorBlocksToBreak`	Color	红色	待破坏方块颜色
`colorBlocksToPlace`	Color	绿色	待放置方块颜色
`colorBlocksToWalkInto`	Color	品红色	待走入方块颜色

6.4 选区渲染

设置项	类型	默认值	说明
`renderSelection`	Boolean	`true`	渲染选区
`renderSelectionIgnoreDepth`	Boolean	`true`	选区忽略深度
`renderSelectionCorners`	Boolean	`true`	渲染选区角落
`colorSelection`	Color	青色	选区颜色
`colorSelectionPos1`	Color	黑色	选区位置 1 颜色
`colorSelectionPos2`	Color	橙色	选区位置 2 颜色
`selectionOpacity`	Float	`0.5`	选区不透明度（0-1）
`selectionLineWidth`	Float	`2.0`	选区线条宽度

6.5 缓存区块渲染

设置项	类型	默认值	说明
`renderCachedChunks`	Boolean	`false`	渲染缓存区块（半透明）与 OptiFine 不兼容，可能崩溃
`cachedChunksOpacity`	Float	`0.5`	缓存区块不透明度（0 完全透明，1 完全不透明）

注意：启用后可能需要重新加载世界（重连、进出下界、死亡重生等）。流动水在缓存中显示为 AVOID（渲染为岩浆），靠近时会看到岩浆瀑布变成水瀑布。固体方块在主世界渲染为石头，下界为地狱岩，末地为末地石。

6.6 视角设置

设置项	类型	默认值	说明
`freeLook`	Boolean	`true`	自由视角（无需强制客户端旋转）
`blockFreeLook`	Boolean	`false`	破坏/放置时自由视角（需 `freeLook`）
`elytraFreeLook`	Boolean	`true`	鞘翅飞行时自由视角（1.19.4 默认开启）
`smoothLook`	Boolean	`false`	平滑视角（平均最近 tick 的旋转）
`elytraSmoothLook`	Boolean	`false`	鞘翅平滑视角（1.19.4 默认关闭）
`smoothLookTicks`	Integer	`5`	平滑视角平均 tick 数
`remainWithExistingLookDirection`	Boolean	`true`	尽可能保持现有视角方向
`randomLooking113`	Double	`2.0`	每 tick 随机偏转水平视角（度），`0` 关闭
`randomLooking`	Double	`0.01`	每 tick 随机扰动俯仰与偏航（度），`0` 关闭
`antiCheatCompatibility`	Boolean	`true`	反作弊兼容性（防止非前进方向疾跑被检测）

7. 鞘翅飞行

7.1 基础设置

设置项	类型	默认值	说明
`elytraTermsAccepted`	Boolean	`false`	是否接受鞘翅条款（使用前需确认）
`elytraAutoJump`	Boolean	`false`	自动寻路到悬崖边起跳启动鞘翅
`elytraAutoSwap`	Boolean	`true`	耐久过低时自动更换鞘翅
`elytraMinimumDurability`	Integer	`5`	鞘翅最低耐久阈值
`elytraAllowEmergencyLand`	Boolean	`true`	耐久/烟花耗尽时自动紧急着陆
`elytraMinFireworksBeforeLanding`	Integer	`5`	着陆前最少烟花数量

7.2 飞行参数

设置项	类型	默认值	说明
`elytraSimulationTicks`	Integer	`20`	无烟花助推时的模拟 tick 数（越高计算越慢）
`elytraPitchRange`	Integer	`25`	最大俯仰角偏离（直接朝向目标）
`elytraFireworkSpeed`	Double	`1.2`	自动使用烟花的最小速度（格/tick）
`elytraFireworkSetbackUseDelay`	Integer	`15`	服务器回传位置后使用烟花的延迟（tick）
`elytraMinimumAvoidance`	Double	`0.2`	碰撞箱避让最小填充值（过高会遗漏安全点，过低可能撞地）
`elytraConserveFireworks`	Boolean	`false`	下降时节省烟花

7.3 下界路径规划

设置项	类型	默认值	说明
`elytraNetherSeed`	Long	`146008555100680`	下界地形生成种子（默认 2b2t）
`elytraPredictTerrain`	Boolean	`false`	是否用 `elytraNetherSeed` 预测下界地形；默认关闭。未知种子时 `#elytra` 首次提示逻辑也会把其关掉；有正确种子可再手动设为 `true`
`elytraAllowLandOnNetherFortress`	Boolean	`false`	允许在下界要塞着陆
`elytraTimeBetweenCacheCullSecs`	Long	`180`	缓存清理间隔（秒）
`elytraCacheCullDistance`	Integer	`5000`	缓存清理最大距离（格）

7.4 渲染调试

设置项	类型	默认值	说明
`elytraRenderRaytraces`	Boolean	`false`	渲染飞行射线检测
`elytraRenderHitboxRaytraces`	Boolean	`false`	渲染碰撞箱射线检测（需 `elytraRenderRaytraces`）
`elytraRenderSimulation`	Boolean	`true`	渲染每刻模拟的最佳飞行路径
`elytraChatSpam`	Boolean	`false`	鞘翅模式下的啰嗦聊天日志

8. 高级功能

8.1 区块缓存

设置项	类型	默认值	说明
`chunkCaching`	Boolean	`true`	启用区块缓存（2-bit 简化格式，长距离路径规划）
`pruneRegionsFromRAM`	Boolean	`true`	保存时删除 1024 格外的缓存区域
`chunkPackerQueueMaxSize`	Integer	`2000`	区块打包队列最大大小
`repackOnAnyBlockChange`	Boolean	`true`	任何方块变化时重新打包整个区块
`cachedChunksExpirySeconds`	Long	`-1`	缓存过期时间（秒，-1 禁用）强烈建议保持 -1
`pathThroughCachedOnly`	Boolean	`false`	仅使用缓存区块路径规划（永远不要启用）
`cutoffAtLoadBoundary`	Boolean	`false`	在已加载区块边界截断路径（现在更安全可关闭）
`simplifyUnloadedYCoord`	Boolean	`true`	远距离目标简化 Y 坐标（先用 GoalXZ）

8.2 路径规划细节

设置项	类型	默认值	说明
`pathingMaxChunkBorderFetch`	Integer	`50`	路径规划最大区块边界获取次数
`minimumImprovementRepropagation`	Boolean	`true`	忽略小于 0.01 tick 的成本改进（浮点误差）
`planningTickLookahead`	Integer	`150`	提前规划触发阈值（剩余 tick 估计值）
`pathingMapDefaultSize`	Integer	`1024`	路径规划哈希表默认大小
`pathingMapLoadFactor`	Float	`0.75`	哈希表负载因子（降低加快速度但增加内存）

8.3 其他功能

设置项	类型	默认值	说明
`backfill`	Boolean	`false`	填充身后方块
`allowVines`	Boolean	`false`	高级藤蔓功能（ gimmick，几乎不需要，可能卡住）
`allowWalkOnBottomSlab`	Boolean	`true`	允许走在下半砖上（禁用提高可靠性）
`rightClickSpeed`	Integer	`4`	右键间隔（tick，游戏默认 4）
`blockReachDistance`	Float	`4.5`	方块交互距离
`assumeSafeWalk`	Boolean	`false`	假设有安全行走功能（后放时不潜行）警告：可能误开箱子
`rightClickContainerOnArrival`	Boolean	`true`	到达容器（箱子、熔炉等）时自动右键打开
`enterPortal`	Boolean	`true`	到达传送门时完全走入而非停在门前
`disconnectOnArrival`	Boolean	`false`	到达目标时断开服务器连接
`axisHeight`	Integer	`120`	`#axis` 命令的目标 Y 层级
`followOffsetDistance`	Double	`0.0`	跟随目标偏移距离
`followOffsetDirection`	Float	`0.0`	跟随目标偏移方向（角度）
`followRadius`	Integer	`3`	跟随到达半径
`followTargetMaxDistance`	Integer	`0`	与跟随目标的最大距离（格）；`0` 表示不启用该限制
`disableCompletionCheck`	Boolean	`false`	禁用完成检查（巨大探索过滤器时防止卡顿）
`allowWalkOnMagmaBlocks`	Boolean	`false`	脚下为岩浆块时是否潜行通过
`doBedWaypoints`	Boolean	`true`	与床交互时保存路径点
`doDeathWaypoints`	Boolean	`true`	死亡时保存路径点

9. 常用设置速览

上文各节已按类别列出大量选项。官方 USAGE 中常强调的日常实用项包括：

设置项	备注
`allowBreak`	是否允许破坏方块
`allowSprint`	是否允许疾跑
`allowPlace`	是否允许放置方块
`allowParkour` / `allowParkourPlace`	跑酷与跑酷放置
`blockPlacementPenalty`	放置惩罚（越高越省方块）
`renderCachedChunks` / `cachedChunksOpacity`	缓存区块可视化（好看但吃配置；与 OptiFine 等可能冲突）
`avoidance`	生物/刷怪笼避让
`legitMine`	合法挖矿（仅见得到的矿）
`followRadius`	跟随到达半径
`backfill`	隧道身后回填
`buildInLayers`	分层建造
`buildRepeat` / `buildRepeatCount`	重复建造偏移（`Vec3i`）与次数（`-1` 无限）；旧文档中的 distance/direction 已合并为此向量
`worldExploringChunkOffset`	探索时最近未访问区块偏移
`acceptableThrowawayItems`	可丢弃垫脚材料
`blocksToAvoidBreaking`	尽量别破坏的方块
`mineScanDroppedItems`	将掉落物视为挖掘相关目标
`allowDiagonalAscend`	对角上升

Baritone 插件设置百科

https://blog.mzyyun.com/posts/baritone-plugin-settings/

本文作者

墨染辉夜

发布于

2026-03-25

许可协议

CC BY-NC-SA 4.0

转载或引用本文时请遵守许可协议，注明出处、不得用于商业用途！

Minecraft Baritone Minecraft