SuperAPI AI 工具集

game-3d-assets

设计与创作

查看项目

更新于 10-16 03:42

技能介绍

用途:把 Three.js 浏览器游戏中的基础几何体(BoxGeometry/SphereGeometry 等)替换为可识别的 GLB/GLTF 3D 模型,涵盖角色与场景道具。

主要能力:按优先级选择资产来源——Tier 1 用 Meshy AI(需 MESHY_API_KEY)按文本或参考图生成定制模型并做骨骼绑定;Tier 2 直接复制 assets/3d-characters/ 中的预置动画角色(如 Soldier、Xbot、RobotExpressive、Fox,多为 MIT,含 Idle/Walk/Run 等动画);Tier 3 用 SKETCHFAB_TOKEN 从 Sketchfab 下载;Tier 4 使用 Poly Haven 的 CC0 环境道具;Tier 5 使用 poly.pizza;Tier 6 才回退到程序化几何体。还提供 find-3d-asset.mjs 搜索下载脚本、optimize-glb.mjs 压缩优化,以及 AssetLoader 工具(静态模型用 clone,动画模型必须用 SkeletonUtils.clone,并加载 MeshoptDecoder 支持压缩 GLB),并覆盖第三人称控制器、相机相对 WASD 移动与 fadeToAction 动画切换。

使用方式:技能会先检查 .env 中是否已有 MESHY_API_KEY,缺失时提示用户申请或选择跳过。命令示例:MESHY_API_KEY=<key> node scripts/meshy-generate.mjs --mode text-to-3d --prompt "..." --polycount 15000 --pbr --output public/assets/models/ --slug <slug>;绑定用 --mode rig;道具搜索用 node scripts/find-3d-asset.mjs --query "barrel" --source polyhaven,下载模型示例 curl -L -o public/assets/models/Soldier.glb "https://raw.githubusercontent.com/mrdoob/three.js/dev/examples/models/gltf/Soldier.glb"。

适用场景:需要真实模型替代方块/球体的 Three.js 3D 游戏,尤其是角色、道具、建筑与环境资产管线。

限制:Meshy、Sketchfab 下载需要各自 API 密钥;预置角色无走跑动画时需设计站桩类玩法或程序化位移;各模型动画剪辑名不统一,必须加载后打印并定义 clipMap;模型朝向与缩放需加载后校验,否则易出现 T-pose、朝向错误或溢出容器;相关收费与价格信息暂未提供。