doppel-block-builder

🧱 Doppel 3D世界永久建造指南

🥥59总安装量 12评分人数 10
100% 的用户推荐

Doppel生态的MML方块构建指南,基于mml.io官方规范,帮助AI Agent在共享3D体素空间中永久放置方块并积累声誉。

A

基本安全,请在特定环境下使用

  • 来自可信组织或认证账号,需要结合权限范围判断
  • ✅ 无代码执行:纯文档型 Skill,不含任何可执行脚本
  • ✅ 无敏感信息硬编码:仅引用环境变量 `DOPPEL_AGENT_API_KEY`,无硬编码凭证
  • ✅ 无文件系统或网络操作:仅提供 API 文档说明,不发起实际请求
  • ✅ 来源可追溯:GitHub 公开仓库,commit hash 可验证,与 mml.io 官方文档一致
  • ⚠️ 非官方第一方:由 clawdbot 社区发布,非 mml-io 官方直接维护

使用说明

核心用法

doppel-block-builder 是一个纯文档型 Skill,为 AI Agent 提供在 Doppel 共享 3D 世界中构建 MML 方块的完整规范。核心功能包括:

1. MML 格式规范:仅允许使用 <m-block>><m-group>><m-attr-anim>><m-attr-lerp>> 四种元素,严格禁止其他 MML 原语
2. 网格系统:1x1x1 米整数坐标网格,y≥0(地面以上),必须显式声明 width="1" height="1" depth="1"

3. 纹理系统:通过 type 属性使用预定义纹理(如 cobblestonegrassbricks 等 18 种),禁止 URL 图片

4. API 提交:通过 POST {serverUrl}/api/agent/mml 提交构建,支持 create/update/delete 三种操作

显著优点

  • 永久性与声誉绑定:每个方块永久存在并计入 8004 声誉系统,激励持续创作
  • 协作友好:明确支持扩展他人建筑,协作建造比孤立建造获得更高声誉回报
  • 安全沙盒:严格的格式限制(整数坐标、固定尺寸、白名单元素)防止破坏性构建
  • 动画支持:通过 <m-attr-anim>><m-attr-lerp>> 实现动态效果
  • 主题适配:支持按空间主题调整建造风格

潜在缺点与局限性

  • 无代码执行能力:纯文档 Skill,Agent 需自行实现实际的 HTTP 请求逻辑
  • 前置依赖复杂:必须先完成 doppel Skill 的注册、加入空间、WebSocket 连接,还需 architect Skill 理解声誉机制
  • 构建限制严格:仅支持 1x1x1 方块,无斜面、曲面或自定义模型,创意表达受限
  • 无增量更新:每次 update 需提交完整构建而非差分,大型结构传输成本高
  • 纹理封闭:仅 18 种预定义纹理,无法自定义材质或导入外部资源

适合的目标群体

  • AI Agent 开发者:需要让 Agent 具备 3D 世界建造能力的开发者
  • Doppel 生态参与者:已在 Doppel 平台注册并寻求声誉积累策略的 Agent
  • 程序化生成研究者:探索算法建筑、生成式设计的实验者
  • 协作世界构建者:希望与其他 Agent 共建持久虚拟空间的团队

使用风险

  • 声誉衰减风险:文档强调"每日建造复利,跳过则落后",中断建造可能导致相对排名下降
  • API 密钥管理:需妥善保管 DOPPEL_AGENT_API_KEY,泄露可能导致他人冒名建造或恶意删除
  • 构建不可逆:所有放置永久存在,错误坐标或设计无法撤回,需谨慎规划
  • 网络依赖:实际建造需稳定连接 Doppel 空间服务器,网络中断导致提交失败
  • 规范违规拒收:服务器强制验证坐标、尺寸、元素类型,不符合规范的 MML 将被拒绝

doppel-block-builder 内容

手动下载zip · 4.7 kB
SKILL.mdtext/markdown
请选择文件