SuperAPI AI 工具集

sdk-scenes

智能体与模型

查看项目

更新于 10-16 05:05

技能介绍

这是 Decentraland SDK7 场景开发的入口技能,用于构建、扩展和部署场景,并汇总各主题子技能供按需加载。

用途与运行约束:场景运行于 QuickJS 沙箱,不能使用 fs、http、path、process 等 Node.js API;异步操作需使用 executeTask() 与 fetch()。

行为准则:执行重大操作前须用非技术、面向场景效果的语言向用户确认,包括修改 scene.json 中的场景地块数量或布局、从外部来源下载资源(.glb、图片、音频、视频)、添加多人服务器(需切换到 @dcl/sdk@auth-server 分支)、从 Blender MCP 回退到无头 Blender,以及在绕过 SDK 缺陷前先用 report-sdk-issue 报告。这些是需先沟通而非拒绝的操作。

核心规则:所有静态实体(模型、灯光、出生点)必须定义在 assets/scene/main.composite,不得用 engine.addEntity() 在 TypeScript 中创建;TypeScript(src/index.ts)仅负责动态行为,并通过 getEntityOrNullByName('name') 或 getEntitiesByTag('tag') 引用 composite 实体。编辑已有 composite 时优先使用 Creator Hub MCP(工具含 scene_state、create_entity、set_component、remove_entity、place_smart_item、attach_script、set_scene_settings 等),可实时编辑、自动保存与撤销;仅在 MCP 不可用时才直接编辑该文件,且场景须未在 Creator Hub 中打开,并注意 inspector::Nodes 的注册要求。

子技能覆盖:场景搭建与配置、3D 模型、动画与补间、材质与渲染、灯光与环境、粒子系统、点击与接近交互、高级输入与移动控制、玩家与化身、化身动画、NPC、玩家物理、相机、屏幕空间 UI、音视频、音频分析、区块链与 NFT、多人同步(CRDT 无服务器)、权威服务器、脚本组件、Creator Hub MCP、Explorer 测试、异步/HTTP/WebSocket/定时器、场景优化、游戏设计、部署(dcl deploy、个人世界)、报告 SDK 问题、SDK6 迁移 SDK7。

使用方式:从用户请求识别主题,加载对应技能获取完整 API 与代码模式;跨主题请求加载多个相关技能;资源发现先加载目录并建议具体资源。可用 --skill '*' 安装全部子技能。

限制:部分能力有前提,如权威服务器需 @dcl/sdk@auth-server,音频分析仅限 Unity-explorer。已弃用名称(Web Editor、Decentraland Editor、SDK6、dclcontext 文件夹)不应再向用户提供。