一条命令建起整座办公室：AgentCraft程序化HQ建造与锚点系统详解

【免费下载链接】agentcraftManage your real AI agents, using Minecraft as your interface!项目地址https://gitcode.com/gh_mirrors/agen/agentcraft点击查看免费下载AgentCraft 是一款把「管理真实 AI 编程代理」搬进 Minecraft 的模组你在游戏里输入目标Claude 代理团队就会走进这座程序化生成的 HQ 办公室坐到各自的工位开始写代码。本文将完整拆解它的两大核心机制——一条命令建起整座办公室的程序化 HQ 建造流程以及让所有模块都能精准找到位置的锚点系统Anchors适合刚接触该项目的玩家和想了解其内部设计的开发者。️/agentcraft hq一条命令从草坡到工作室AgentCraft 启动后不会让你在标题画面停留客户端的 AutoWorld.java 会自动加载或按「超平坦草原」模板创建一个名为AgentCraft HQ的创意和平世界草皮固定在 y64。接着HqFeature.java 在服务端启动时发现这是一个「还没有存档布局」的全新世界就会自动执行默认建造器让你第一次进游戏就走进已经盖好的 HQ。如果没触发只需在聊天框输入/agentcraft hq /agentcraft hq force /agentcraft hq test命令作用/agentcraft hq用默认建造器studio重建 HQ/agentcraft hq force强制重建连你手动改过的方块也还原/agentcraft hq test切换到 25×25 的功能测试间建造器出于安全考虑该命令会重写大片地形并移动出生点因此只允许在 HQ 世界执行且永远拒绝在 Hardcore 世界运行想在自己的存档里搭建需要加参数-Dagentcraft.hq.anyworld1启动。命令成功后聊天栏会汇报Built HQ studio: N anchors—— 这里的 N 就是下文的主角锚点数量。 studio 建造器代码如何描述一栋楼默认的studio建造器定义在 StudioHqBuilder.java它描述的是一座「Warm Studio」带陡峭板岩屋顶的长木结构大厅前面是一个八角形 Goal Atrium 铜顶中庭入口门厅四周被林木丘陵环绕。它的布局思路很直观北墙6 个工位隔间屏幕朝南椅子在屏幕前西端图书室library东南会议区东端测试台、合并站和终端南门外八角中庭任务墙在西侧、决策讲台与用户位点在东侧。建造流程分为两层地形先行HqLandscape.java 先生成起伏的草丘、小径、池塘与花圃。所有「随机」选择都来自坐标哈希所以每次建出来一模一样建筑按图施工所有方块先写进一份内存中的「目标状态表」再整体应用到世界见下一节。两个世界内景对比外部是暮色中的红铜屋顶内部则是代理们头顶名牌、屏幕滚日志的长厅。 锚点系统给整栋楼做一份「命名坐标表」房子盖完只是开始。Agent 要走到自己的工位、相机要拍到任务墙、任务栏要绑定到具体的墙——所有模块都需要知道「某个东西在哪个坐标」。AgentCraft 的答案是 Anchors.java一套命名的世界坐标即锚点。一个锚点 Anchor.java 包含x, y, z, yaw, pitch但含义按类型而变锚点类型示例坐标含义站位点desk_kit、library、lounge代理双脚站立处 面朝方向屏幕/面板点monitor_kit、task_wall表面中心 正面朝向相机点cam_overview摄像机眼睛位置 视角方向关键位置entrance、spawn、goal_atrium特殊功能坐标锚点的命名契约集中在 AnchorNames.java每个角色按花名册得到desk_id/monitor_id共享站点支持多槽位library、library_2…library_N代理自动分散坐开相机点统一带cam_前缀。任何建造器必须写齐这些必需锚点这正是「换一个建造器游戏其他部分照常工作」的基础。构建完成后Anchors.publish()会把整份布局存成世界文件夹里的agentcraft-anchors.json并递增版本号每次 HQ 世界启动时自动读回重启游戏无需重建。想随时核对输入/agentcraft anchors注册于 AgentCraftCommands.java即可列出全部锚点坐标。⚙️ 确定性重建为什么盖两次结果永远相同程序化建造最难的不是「盖出来」而是「再盖一次不毁掉你手动加的东西」。这套保证来自 Plan.java 的「目标状态差量」设计全覆盖目标表HQ 占地盒site box内每个格子的期望状态都预先算好没设的格子就是草地剖面所以第二次重建几乎零改动盒子外的世界永远不碰只写差异与现状不同的格子才写入且跳过物理、掉落与流体更新重建速度极快连接块两遍写楼梯、栅栏、玻璃、面板等连接类方块先跳过连接属性写入全部就位后再按邻块重算连接避免重建时「闪烁」记住玩家的改动上次建造的计划存档为agentcraft-hq-plan.datPlanStore.java。若某格子既不符合旧计划也不符合新计划说明是你自己改的——默认保留只有force才强制还原保留运行时状态状态灯颜色、讲台开合、屏幕亮灭等由 Foreman 实时驱动的方块属性在重建时原样保留。切换建造器studio ↔ test会因重写同一片地基而作废旧计划保证记录始终可信。 锚点如何驱动整个游戏锚点发布后监听者被逐层唤醒形成完整的「建筑 → 行为」链条寻路GridPathfinder.java 的搜索范围被bounds限制在 HQ 占地盒内代理沿desk_id走到工位坐下开工状态上报协议里的Agent.station如library、mergestation直接映射到共享站点锚点槽位见 AnchorNames.java 的SHARED_STATIONS出生点spawn锚点会被转换成setworldspawn命令玩家出生即面向大厅QA 与截图cam_*锚点被测试脚本和相机路径CameraPath.java消费仓库中那组 1920×1080 的官方截图正是由此拍出。 关键文件导航文件职责HqFeature.java/agentcraft hq命令、自动建造与安全限制HqBuilder.java建造器接口与force选项契约StudioHqBuilder.java默认 HQ「Warm Studio」实现HqLandscape.java草地、丘陵、路径与灯光坐标哈希确定性Plan.java目标状态差量应用幂等重建核心Anchors.java锚点发布、JSON 持久化与监听HqWorld.javaHQ 世界的身份识别与游戏规则冻结时间/天气、禁刷怪等DEV.md开发者文档中的「Anchors and the test room」章节小结AgentCraft 用三个干净的分层回答了「程序化建筑怎么做」建造器代码描述建筑、计划差量幂等且尊重玩家改动、锚点命名坐标表被寻路、渲染、协议与相机共同消费。理解这条/agentcraft hq命令背后的链路后无论是想扩展自己的建造器还是为代理增加新的站点你都知道该往哪里下手了。赞分享【免费下载链接】agentcraftManage your real AI agents, using Minecraft as your interface!项目地址https://gitcode.com/gh_mirrors/agen/agentcraft点击查看免费下载相关推荐Two.js 锚点体系深度解析Two.Anchor 的构造、控制柄、命令与序列化Two.js 锚点体系深度解析Two.Anchor 的构造、控制柄、命令与序列化 本篇技术指南以 two.js 仓库内 wiki/docs/anchor/RE图形学前端Habblaud 快速上手教程Docker 一条命令部署5 分钟让 AI 代理走进像素办公室Habblaud 快速上手教程Docker 一条命令部署5 分钟让 AI 代理走进像素办公室 Habblaud 是一款把 AI 编程代理变成像素人物的可视化命令行不再只服务程序员Workspace CLI 把 AI 代理带进了办公室命令行不再只服务程序员Workspace CLI 把 AI 代理带进了办公室 先问一个特别真实的场景。 你正在写一份方案写着写着突然卡住上周开会时说的那个人工智能AI 应用AI Agent代码智能体工具调用MCP Clients交互助手CLI上一篇Spark-X2.5-4B-INT8快速上手5分钟用vLLM和SGLang部署1M长上下文AI助手下一篇35B总参、3B激活为什么说KAT-Coder-V2.5-Dev的MOE架构才是会干活AI程序员的答案创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考