用途:为 Decentraland SDK7 创建新场景项目,生成并定制 scene.json、package.json、tsconfig.json 和 src/index.ts。
主要能力:先询问场景类型、地块数量与功能需求;用 /init(官方 @dcl/sdk-commands init)生成配置并自动安装依赖,不手写这些文件;在模型目录(5700+ 免费 3D 模型)和音频目录(50 个免费音效)中检索匹配资源,下载到 models/ 目录;定制 scene.json 的 display 字段、parcels、base 与 spawnPoints;采用 main-entities.ts(声明式实体与数据组件)加 src/index.ts(行为)的双文件模型。
使用方式:运行 /init 后编辑生成文件;数据类组件(Transform、GltfContainer、MeshRenderer、Material、AudioSource 等)放 main-entities.ts,行为(指针回调、系统、补间)放 src/;用 engine.getEntityOrNullByName 按名称引用实体;预览可运行 npx @dcl/sdk-commands start --bevy-web,浏览器访问 http://localhost:8000。
限制:Decentraland 运行于 QuickJS 沙箱,无 Node.js API(fs、http、path、process),异步用 executeTask() 与 fetch();GltfContainer 仅支持本地文件,不可用外部 URL;scene.json 的 main 必须为 bin/index.js;Transform 字段不可传 undefined;场景字面量须 JSON 兼容,不能含函数调用、展开或注释;每地块 16m×16m×20m。部署、优化与游戏设计见对应技能。