参考手册Bedrock 工具

Bedrock 工具

需求

本页列出 Bedrock Adapter src/tools 目录当前可确认的模块。它运行于 BDS 的 Legacy Script Engine Node.js 环境;工具由目录模块加载并动态注册,不保证所有安装版本拥有同一集合。

架构

每个模块提供 input_schema,部分模块同时提供 output_schema。工具按能力领域组织:

领域工具关键参数风险
感知query_location以运行时 Schema 为准只读
移动move_to, ride, dismountride.entity_id 必填;可选假人名改变位置/骑乘
方块mine_block, place_block, use_block, collect_block, area_operation坐标、方块或区域参数以 Schema 为准修改世界;区域操作高风险
背包drop_item, take_from_container, put_to_container, equip_item物品、数量、容器或槽位修改/丢失物品
实体interact_entity, lead_entity实体标识与动作改变实体状态
战斗set_combat_mode, stop_combatmode 必填;可选目标与假人可能攻击实体
生存eat, sleep, use_itemsleep.action、use_item.item_name 必填消耗物品/改变状态

已由源码明确的返回示例:eat 返回食物及恢复量字段;sleep 返回床位置和是否跳过时间;ride 返回骑乘状态和载具类型;set_combat_mode 返回当前模式和目标。所有结果仍以当前模块的 output_schema 与执行结果为准。

执行

  1. 确认 BDS 已加载插件且 Agent Core 中实例在线。
  2. 在当前工作区读取注册 Schema,不从 Java 同名工具推断 Bedrock 参数;两端命名风格也可能不同。
  3. config.json 可声明限制,但当前入口实际连接目标仍需按 兼容矩阵 和 已知限制 判断。
  4. 执行区域、容器和战斗工具前先在测试世界验证并备份。