AgentCraft的Minecraft Mod是如何造出来的：把AI日志变成实时办公室场景全解析

【免费下载链接】agentcraftManage your real AI agents, using Minecraft as your interface!项目地址https://gitcode.com/gh_mirrors/agen/agentcraft点击查看免费下载AgentCraft 是一个开源 Minecraft Mod配合 Foreman 编排器它让一组真实的 AI AgentClaude、Codex在你的代码仓库上干活并把终端里枯燥的 AI 日志变成一间可以走进去的像素办公室Agent 坐在工位上敲代码、桌上显示器实时滚动每一条工具调用和 diff、任务墙像看板一样流转需要你做决策时它会摇铃走到你面前。这篇文章完整拆解这套 Mod 是怎么造出来的从用代码盖一栋 HQ到把 AI 日志逐帧画进游戏里。整体架构游戏只是显示器真正的 AI 在窗外理解这个 Mod 的第一步是接受它最核心的设计决策Minecraft 里没有跑任何 AI。项目拆成两个进程中间用一条只允许本机访问的 WebSocket 连接默认ws://127.0.0.1:7878串起来Foremanforeman/Node 22 TypeScript 编写的大脑负责跑 Agent 会话、维护任务图、消息、共享记忆、决策队列和 git worktree是所有状态的唯一事实来源source of truth并且持续落盘游戏关不关都在工作Modmod/Fabric 加载的 Minecraft 模组角色只有一个——把 Foreman 的状态渲染成场景把你的决定发回去。两边之间跑的是一套带版本号v:1的 JSON 协议用 zod 定义、Java 侧镜像实现字段级参考文档由脚本从 schema 自动生成防止两边跑偏Minecraft mod (Java) —— WebSocket —— Foreman (Node/TS) hello → snapshot → upserts AgentManager / TaskGraph / goal.submit / decision.answer / ... MessageBus / Memory / RepoManager协议定义在 protocol.ts一个 Agent 有 10 种状态idle | thinking | editing | running | testing | waiting_user | error | done …和 8 个可去的工位desk | library | testbench | mergestation | user …这正是后面办公室场景能自动演出来的原因。服务端代码见 server.ts它对浏览器 Origin 一律拒绝防止网页驱动你的 Agent。第一层HQ 不是玩家搭的是用代码盖出来的进入世界时你看到的那栋铜顶工作室不是地图文件而是一个确定性建筑算法。入口契约是 HqBuilder.java任何 Builder 必须在build()里发布一组命名锚点desk_id、task_wall、decision_podium……并标记可行走区域默认实现 StudioHqBuilder.java 用坐标常量规划整座大厅6 个工位隔间DESK_ORDER tove, juniper, marlow, wren, rowan, kit、八边形目标中庭、图书馆、测试台、合并台、休息区建筑以 diff 方式应用只写变化的格子玩家自己改过的方块会被保留重建两次结果完全一致幂等。执行/agentcraft hq命令即可重建整栋楼。锚点系统layout/把图书馆在第几格这类空间知识固化成数据这样 Agent 寻路、摄像头取景、屏幕绑定全都读同一份坐标表——这是场景可自动演绎的地基。第二层一支有名字有皮肤的角色团队办公室里走动的 Agent 是自定义实体但它们的形象完全来自一条程序化美术流水线assets-src/ 目录里的 Python 脚本逐像素生成全部 6 个 Agent 皮肤gen/chars/id.py里每一张脸都是一张字面像素网格、16 种方块贴图、全部 GUI 九宫格精灵共 282 个资源文件字节级确定、可重复生成cast.json 是角色表id、名字、职位、身份色、模型宽臂/细臂一应俱全Mod 运行时直接读取身份色刻意避开状态色域蓝紫品红 vs 黄/青/陶土/红保证围巾颜色永远不会被误读成状态。渲染侧AgentRenderer.java复用原版玩家模型画皮肤再叠加一堆生活细节坐姿打字、手托下巴思考、错误时耳朵冒红蒸汽、完成时撒彩带、说话气泡、头顶名牌自动避让。这些姿态全部由协议里的state station推导不需要任何额外字段。第三层核心魔法——AI 日志变成桌上的实时显示器标题里那句把 AI 日志变成实时办公室场景落到代码上就是一条清晰的数据链Foreman 侧Claude Agent SDK 的流式消息被映射成统一的日志条目kind: text | tool | result | error | diff约 30ms 批量一次发出agent.log消息见 stream.ts 与 foreman.ts协议侧agent.log { agentId, entries[] }是追加式消息Mod 只保留有界尾部每 Agent 最近 200 行Mod 侧每个 3x2 显示器方块通过 block entity 的 binding 绑到一个 Agent idMonitorRenderer.java 从面板原点方块一次绘制整块屏幕——状态点 名字的页头、逐行滚入的日志新行 260ms 滑入、顶行淡出、打字光标闪烁、等待你的脉冲提示外加离线时最后一帧日志变暗的降级处理。于是AI 正在读src/olts.ts、Editsrc/olts.ts、测试失败红行→ 通过绿行这些原本只存在于终端流里的信息直接变成了桌面上发光的屏幕。多块同朝向显示器会自动拼成一整块大屏PanelBlock的 up/down/left/right 连接属性。第四层任务墙、决策讲台与游戏内合并审查办公室的信息层级是逐层放大的远处看灯近处看名牌贴上去看屏幕。支撑这套视觉的是四个世界元素Task Walltask_board面板上由 Foreman 推送的task.upsert驱动的看板卡片随状态变化会飞到新列并闪光右键一张卡片可以重派、取消、调优先级Decision Podium当 Agent 调用ask_user或触发权限审查时Foreman 发出decision.upsert讲台亮起、铃响、Agent 头顶冒出陶土色!桌面同时弹系统通知Merge Station Diff 屏右键合并台发出diff.requestForeman 返回结构化 diff文件、hunk、逐行add/del/ctx 行号游戏里渲染成带语法着色的真·代码审查界面Merge / Request changes / Reject三个按钮一按决定经协议回传给 Foreman——只有你的这一击会真正合并分支共享图书馆计划、约定、决策记录以 markdown 存进 Memory绑在书架方块上任何人都能翻开读。容错设计游戏关了办公室黑屏但工作不停这套架构还带来一个副产品级的体验。Foreman 挂掉或游戏重连时Mod 不会崩、不会丢状态顶部横幅显示 Reconnecting to the Foreman (N) · showing last known state屏幕保留最后一帧日志并变暗重新连上后先收一份完整snapshot再逐条同步。所有状态存在~/.agentcraft/Claude 会话按 id 恢复重启 Foreman 团队接着干。动手体验一条命令启动你的 AI 办公室git clone https://gitcode.com/gh_mirrors/agen/agentcraft cd agentcraft tools\launch.ps1 -Backend sim # 先用脚本团队试玩不花 API 钱 tools\launch.ps1 -Repo C:\path\to\your\repo # 真实 Claude 团队跑你的仓库 tools\stop.ps1macOS/Linux 对应node tools/unix.mjs launch --backend sim。启动器会自动装依赖、下载 Minecraft、拉起 Foreman 和游戏真实 Agent 需要ANTHROPIC_API_KEY或 Bedrock/Vertex 等云凭证。小结这套 Mod 造了哪些机关机关位置一句话原理确定性建筑 锚点hq/StudioHqBuilder.java代码盖楼空间知识变成数据程序化美术assets-src/像素网格脚本生成全部皮肤/贴图/精灵流式日志上屏client/monitor/agent.log追加帧 → 块实体屏幕逐行滑入状态驱动的场景表演client/agents/state station推导姿态、粒子、工位移动协议即契约docs/protocol.mdzod schema 自动生成文档两端永不失同步DevBridge 开发桥client/dev/DevBridge.java本机 WS 控制摄像头/截图支撑自动化截图 QAAgentCraft 真正有借鉴价值的地方不是用 Minecraft 当 UI这个噱头而是它把AI Agent 的流式日志、任务状态和人工决策点三种信息分别映射成了屏幕、看板和人走到你面前这三类空间语言——把异步、看不见的多 Agent 工作变成了一件可以围观、可以介入、随时可离开的具象过程。赞分享【免费下载链接】agentcraftManage your real AI agents, using Minecraft as your interface!项目地址https://gitcode.com/gh_mirrors/agen/agentcraft点击查看免费下载相关推荐Hermes3D 3D场景实现原理运行时事件如何变成办公室里走动的 AI AgentHermes3D 3D场景实现原理运行时事件如何变成办公室里走动的 AI Agent Hermes3D 是一个基于 Hermes Agents 的开源 3D5大实战场景揭秘Chatbox如何成为你的AI办公全能助手5大实战场景揭秘Chatbox如何成为你的AI办公全能助手 想要在AI时代提升工作效率却苦于找不到合适的工具Chatbox这款开源AI桌面客户端或许正是你需AI 应用交互助手桌面应用Agent Office 全解析把 Claude Code 请进 3D 卡通办公室的 AI 协作神器Agent Office 全解析把 Claude Code 请进 3D 卡通办公室的 AI 协作神器 Agent Office 是一个 3D 卡通风格的多人上一篇cuML DBSCAN C 示例全解析从零构建、命令行运行到 GPU 底层实现原理下一篇OpenCloud 中的 go-jose Safe JSONJOSE 消息解析为何要严格解码创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考