Hermes Agent 可通过 Fabric 模组桥接与 Minecraft 实现指令交互：需安装 HermesBridge 模组、启用并配置 minecraft 插件、生成唯一 auth_token，再通过 /hermes 指令调用召唤、查询、脚本等自动化功能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望在《我的世界》中通过 Hermes Agent 实现游戏内指令交互与自动化控制，则需完成模组层对接与运行时通信配置。以下是实现此目标的具体操作路径：
一、启用 Fabric API 与 Hermes Bridge 模组
Fabric 是当前最轻量且兼容性最强的模组加载器，Hermes Agent 需通过专用桥接模组与 Minecraft 服务端建立双向通信通道。该模组负责将游戏内 `/hermes` 指令转发至本地 Hermes Agent 进程，并将响应结果以聊天消息或命令方块形式回写。
1、确认服务器已安装 Fabric Loader（版本需匹配 Minecraft 1.21.11 或 1.20.1）。
2、下载 HermesBridge-1.21.1-fabric-0.4.2.jar（仅适配 Fabric，不支持 Forge 或 NeoForge）。
3、将该 JAR 文件放入服务器 mods/ 目录下，确保其位于 fabric-api-*.jar 之后加载。
4、重启服务器，检查日志中是否出现 [HermesBridge] Initialized with local agent endpoint http://127.0.0.1:8080/api/v1/chat。
二、配置 Hermes Agent 的 Minecraft 插件模块
Hermes Agent 默认不启用游戏交互能力，必须手动激活 Minecraft 插件模块并绑定服务器地址与认证密钥，否则指令请求将被拒绝。
1、执行 hermes plugin enable minecraft 启用插件。
2、编辑插件配置文件 ~/.hermes/plugins/minecraft/config.yaml，填入以下内容：
3、设置 server_host: 127.0.0.1 与 server_port: 25565（若为远程服务器，需替换为公网 IP 并开放端口）。
4、生成并填入 auth_token: 9a3f7c1e-d2b4-486a-bf09-8e5d3c7a1f2b（使用 uuidgen 命令生成，不得重复使用）。
5、保存后执行 hermes plugin reload minecraft 使配置生效。
三、在游戏中调用 Hermes Agent 执行指令
启用桥接模组与插件后，玩家可在游戏内直接使用预设指令触发 Hermes Agent 的推理与执行流程，所有操作均经由本地 HTTP 接口完成，不依赖外部网络或云服务。
1、以 OP 权限登录服务器，在聊天栏输入 /hermes status，确认返回 Agent connected, ready for commands。
2、输入 /hermes exec "summon lightning_bolt ~ ~ ~"，观察附近是否生成闪电实体。
3、输入 /hermes chat "列出附近 5 格内所有生物名称"，等待 Hermes Agent 调用 World API 并返回结构化文本。
4、若需执行多步操作，可组合使用 /hermes script 指令加载 YAML 脚本，脚本须存放于 world/datapacks/hermes_scripts/ 下。
四、调试连接失败与权限拒绝问题
当游戏内指令无响应或提示“Connection refused”、“Unauthorized”时，通常源于端口未监听、Token 不匹配或 Fabric 模组加载顺序错误。以下为三类独立排查路径：
1、在终端运行 lsof -i :8080（macOS/Linux）或 netstat -ano | findstr :8080（Windows），确认 Hermes Agent 进程正在监听该端口。
2、检查服务器日志中 Fabric 加载顺序，确保 HermesBridge-*.jar 出现在 fabric-api-*.jar 和 fabric-language-kotlin-*.jar 之后。
3、在 Hermes Agent 配置目录中运行 hermes plugin logs minecraft --tail 50，查看最近 50 行插件运行日志，定位 Token 校验失败或 JSON 解析异常的具体位置。
