Configuration

配置 · Configuration

首次运行时,Mod 会在 Fabric 配置目录写出 aibot.json(开发环境通常是 run/config/aibot.json)。所有字段都有合理默认值,缺失字段会按默认补齐。

🔑 API Key 推荐用环境变量 DEEPSEEK_API_KEY 提供,优先级高于配置文件里的 apiKey。

配置分为以下段落:

deepseek —— 大模型接口

字段	说明
apiKey	API 密钥(留空则读环境变量 DEEPSEEK_API_KEY)
baseUrl	接口地址,默认 https://api.deepseek.com(任意 OpenAI 兼容端点均可)
model	模型名,默认 deepseek-chat
maxTokens	单次回复最大 token,默认 2048
temperature	采样温度,默认 0.3(越低越稳)
timeoutSeconds	请求超时秒数
retryCount	失败重试次数
retryBackoffMs	重试退避毫秒

brain —— 大脑行为

字段	说明
maxHistoryMessages	对话历史保留条数
maxToolCallsPerTurn	单轮最多并行工具调用数
maxTurnsPerRequest	单次请求最多工具调用轮数(防止无限循环耗 token)
exposeLowLevelTools	是否暴露低层工具(move_block/place_block 等)
enableMemoryTools	是否启用记忆类工具
enableCoordinationTools	是否启用多 bot 协调工具

perception —— 感知范围

字段	说明
radius	水平感知半径
maxBlocks / maxEntities / maxItems	喂给大模型的方块 / 实体 / 掉落物数量上限(控制 token)
includeRawLists	是否包含原始列表

goal —— 目标引擎

字段	说明
maxPlanDepth	倒推规划最大深度(防止依赖链爆炸)
replanOnFailure	步骤失败时是否自动重规划
autoToolFill	是否自动补齐缺失的工具(如挖矿前先做镐)

mining —— 挖矿

字段	说明
returnWhenFreeSlots	背包剩余空位低于此值时回程
toolDurabilityFloor	工具耐久低于此比例时停用 / 更换
placeTorches	挖矿时是否自动放火把

combat —— 战斗

字段	说明
retreatHp	血量低于此值时撤退
maxEnemiesToFight	同时迎战的最大敌人数,超过则逃

survival —— 生存

字段	说明
hungerEatThreshold	饥饿值低于此值时进食
hungerCriticalThreshold	饥饿危急阈值

night —— 夜晚

字段	说明
autoSleep	夜晚是否自动睡觉
torchLightThreshold	光照低于此值时放火把

nav —— 寻路 / 移动

字段	说明
jumpReach	跳跃前探距离
sidleAfter / sidleLimit	卡住后开始侧移规避的延迟 / 上限
hardLimit	硬卡死判定阈值
lookahead / nodeRetry	路径前瞻 / 节点重试
sprintMinDist	触发疾跑的最小距离

pickup —— 拾取

字段	说明
forceRadiusH / forceRadiusV	强制拾取的水平 / 垂直半径
sweepRadius	清扫拾取半径

watchdog —— 看门狗

字段	说明
stuckWindowTicks	卡死监测窗口(此窗口内位置/进度/背包无变化即判卡死)

logging —— 日志

字段	说明
enabled	是否启用结构化日志
directory	日志目录
perBotFile	是否每个 bot 单独文件
rotation / maxFileSizeMb / maxBackups	滚动策略 / 单文件上限 / 保留份数

---

改完配置后重启服务端(或重载)生效。各阈值的实际默认值以你本地生成的 aibot.json 为准。