配置参考
需求
本页区分 Agent Core、Java、Bedrock 和 QQ 的真实配置入口,避免使用已经无效的 llm.yaml、settings.yaml 或旧 Java 路径。
架构
Agent Core
模型、智能体、工作区和 QQ 配置通过 Alice 界面及其持久化层管理,不提供手工 YAML 主路径。TCP 服务源码默认监听 0.0.0.0:27541,最大连接 10,心跳间隔 10 秒、超时 30 秒。不要因此推断 Adapter 已支持跨主机配置。
Java Adapter
运行数据位于游戏根目录或存档下的 Alice/。可确认的文件包括 Alice/mcagent_instance.json、Alice/world_identity.json、Alice/agents/*.json、世界数据库与日志目录。命令:
/alice status
/alice config get <key>
/alice config set <key> <value> # 需 OP
/alice config list
/alice reload # 需 OP
/alice helpBedrock Adapter config.json
| 键 | 类型/默认 | 说明 |
|---|---|---|
host | string / 127.0.0.1 | 声明的 Agent Core 主机;当前入口限制见已知限制 |
port | number / 27541 | 声明端口 |
debug | boolean / false | 调试输出 |
survival.eat.max_search_radius | number / 0 | 食物搜索半径 |
survival.sleep.max_bed_search_radius | number / 32 | 床搜索半径 |
survival.sleep.max_wait_ms | number / 60000 | 最大等待毫秒数 |
block.max_area_operation_blocks | number / 256 | 区域操作上限 |
block.tool_durability_threshold | number / 5 | 工具耐久阈值 |
block.allow_alternative_materials | boolean / true | 是否允许替代材料 |
gui_test.require_op | boolean / true | GUI 测试是否要求 OP |
模式为 desktop、docker 或 external,默认 desktop。external 配置 wsHost、wsPort(1–65535)、wsProtocol、accessToken;默认端口 3001。授权配置包含 owner、admins、whitelist、默认权限和冷却秒数。
执行
优先通过 UI 和游戏命令修改配置;修改前备份。不要公开 auth_token、模型 API Key 或 OneBot access token。Bedrock host/port 即使存在,也不能据此宣称跨主机连接已生效;参见 已知限制。