SuperAPI AI 工具集

composites

通用与其它

查看项目

更新于 10-16 05:05

技能介绍

用途:本技能提供 Decentraland 场景 assets/scene/main.composite 的 .composite JSON 格式参考,被 create-scene、add-3d-models、sdk-scenes 等技能共享,用于声明场景初始实体。

主要能力:说明 JSON 结构与 jsonSchema 规则、实体 ID 分配、按组件格式目录(core::Transform、core::GltfContainer 等)、组件分组模式、编辑模式规则(inspector::Nodes)、运行时生成,以及从 TypeScript 获取 composite 实体的模式。

使用方式(强制流程):第一步先检查 Creator Hub MCP 是否可用。若 MCP 工具在会话中(Claude Code 的 mcp__creator-hub__,或 Creator Hub AI 助手中的裸 scene_state / create_entity),不要手改 main.composite、main.crdt 或 scene.json,改用工具实时修改场景;若 Creator Hub 在运行但工具未连接,先告知用户连接方式再决定。无 Creator Hub 时才走文件编辑流程。第二步读取 scene.json,按 scene.parcels 与 scene.base 计算边界:parcelsWide、parcelsDeep,maxX = parcelsWide16、maxZ = parcelsDeep*16,实体 X 须在 [0,maxX]、Z 须在 [0,maxZ],越界不渲染。GLB 模型还需解析其包围盒(不能只看 accessor 的 min/max,要叠加节点缩放与位移),树木等植被未知时按离边缘 12 米缓冲放置。

写完运行 npx sdk-commands build 校验,必须零错误。作者编辑模式需注意:已有 inspector::* 时不得删除其节点,新实体要追加到 inspector::Nodes 对应数组,且场景不能在 Creator Hub 中打开,否则自动保存会整体覆盖。限制:不得擅自更改 scene.json 地块数量;核心组件不得带 jsonSchema,非核心组件必须带。定价、平台等未提供。