SuperAPI AI 工具集

add-3d-models

通用与其它

查看项目

更新于 10-16 08:35

技能介绍

用途:在 Decentraland 场景中放置 3D 模型(.glb/.gltf),处理加载、定位、缩放、碰撞体与父子层级。

主要能力:静态模型声明在 main-entities.ts 中(编译为 main.crdt,引擎在 main() 前预加载,编辑器可交互拖拽/旋转);仅动态生成模型(循环放置、事件掉落、NFT 门控等)才用 src/index.ts 的 engine.addEntity()。可用 GltfContainer 的 visibleMeshesCollisionMask / invisibleMeshesCollisionMask 设置碰撞层(CL_PHYSICS=1、CL_POINTER=2,两者为 3),或用 MeshCollider 添加 box、sphere、plane、cylinder 等简单碰撞体。支持缩放、旋转(欧拉角在编写时转四元数)、按名称设置 parent 父子关系。

使用方式:模型文件放项目根目录 models/,用 curl -o models/slug.glb "URL" 从项目根下载(不要 cd models)。GltfContainer 的 src 只接受本地文件,禁止外部 URL。运行时可切换动画(Animator)并轮询 GltfContainerLoadingState 检查加载状态。

模型目录:{baseDir}/references/model-catalog.md,含 5,700+ 免费模型,每行为 slug | dims | tris | size | 分类 | 描述与动画 | curl 命令 | 预览图。用 grep -i "关键词" 搜索,一次一个关键词,可换同义词;grep "^##" 浏览分类。

限制与注意:Transform 的 position/rotation/scale 字段不可为 undefined,应整体省略该键。场景使用 Y-up,Blender 导出需勾选 Y Up。模型建议单文件小于 50MB,小道具建议低于 1,500 三角面,使用 .glb 与 PBR 材质。点击无反应通常是缺少 CL_POINTER 碰撞体。更新费用、官方支持范围等资料暂未提供。