# 添加 3D 资源用真实的 3D 模型替换基本几何形状（BoxGeometry、SphereGeometry）。角色获得自定义 Meshy AI 生成的模型，并带有绑定和动画。世界对象是从免费库生成或来源的。 ## 说明在“$ARGUMENTS”（如果没有给出路径，则分析当前目录）中的游戏。首先，加载完整模型管道、AssetLoader 模式、Mesy 生成和集成模式的 game-3d-assets 技能和 meshyai 技能。 ### 第 1 步：获取 Meshy API 密钥检查是否设置了“MESHY_API_KEY”。如果没有，请询问用户： > 我将使用 Meshy AI 生成自定义 3D 模型以获得最佳结果。您可以在 30 秒内获得免费的 API 密钥： > > 1. 注册 > 2. 前往设置 → API 密钥 > 3.创建新的API密钥 > > > 您的 Meshy API 密钥是什么？（或输入“skip”以使用免费模型库） ### 第 2 步：审核 * 阅读 `package.json` 以确认这是一个 Three.js 游戏（不是 Phaser — 对于 2D 游戏使用 `/add-assets`） * 阅读 `src/core/Constants.js` 了解实体类型、大小、颜色 * 读取实体文件（`src/gameplay/*.js`、`src/entities/*.js`）——查找`BoxGeometry`、`SphereGeometry`等。 * 阅读 `src/level/LevelBuilder.js` 了解环境原语 * 使用几何形状列出每个实体 * 识别哪个实体是**玩家角色**（需要动画模型） ### 第 3 步：计划将实体分为两类： **动画角色**（玩家、具有 AI 的敌人）- 使用 Meshy AI 生成：实体|网状提示|注释 ---|---|--- 玩家| “英雄骑士，低多边形游戏角色，全身，T 姿势”|生成→装备→动画敌人| “拿着棍棒的妖精战士，低多边形游戏角色”|生成→装备→动画如果 Meshy 不可用，则返回到 `3d-character-library/`： * **士兵** — 真实的军队（闲置、行走、奔跑） — 最佳默认值 * **Xbot** — 风格化人体模型（闲置、行走、跑步 + 附加姿势） * **RobotExpressive** — 卡通机器人（闲置、行走、跑步、跳舞、跳跃 + 8 个以上） * **狐狸** — 低多边形动物（调查、行走、奔跑） — 比例 0.02 **世界对象**（建筑物、道具、风景、收藏品）- 使用 Meshy 生成或搜索免费库：实体|网状提示|备用源 ---|---|--- 树| “低聚风格化树，游戏资产” |保利避风港房子| “中世纪的房子，低多边形游戏资产”|保利避风港桶 | “一个木桶，低聚游戏资产”|保利避风港硬币| “一枚金币，游戏收藏品”|素描工厂 ### 第 4 步：生成/下载 **使用 Meshy（首选）：** # 生成字符 MESHY_API_KEY= 节点 /scripts/meshy-generate.mjs \ --模式文本转3D \ --提示“英雄骑士，低多边形游戏角色，全身”\ --polycount 15000 --pbr \ --output public/assets/models/ --slug 播放器 # 为动画装备角色 MESHY_API_KEY= 节点 /scripts/meshy-generate.mjs \ --mode rig --task-id --height 1.7 \ --output public/assets/models/ --slug 玩家操纵 # 生成静态道具 MESHY_API_KEY= 节点 /scripts/meshy-generate.mjs \ --模式文本转3D \ --提示“一个木桶，低多边形游戏资产”\ --polycount 5000 \ --output public/assets/models/ --slug 桶 **没有 Meshy（后备）：** # 字符 — 从库中复制 cp <插件根>/3d-character-library/models/Soldier.glb public/assets/models/ # 世界对象 — 搜索和下载节点 /scripts/find-3d-asset.mjs --query "barrel" --source polyhaven \ --output public/assets/models/ --slug 桶 ### 步骤 5：整合 1. 创建`src/level/AssetLoader.js` — **使用`SkeletonUtils.clone()`用于动画模型**（从` Three/addons/utils/SkeletonUtils.js`导入）。常规的`.clone()`会破坏骨架→T-pose。 2. 将“CHARACTER”添加到 Constants.js 中，其中包含“path”、“scale”、“faceOffset”、“clipMap” 3.为静态模型添加`ASSET_PATHS`和`MODEL_CONFIG` 4.更新`Player.js`： * `THREE.Group` 作为位置锚 * `loadAnimatedModel()` \+ `AnimationMixer` * `fadeToAction()` 用于空闲/行走/跑步交叉淡入淡出 * 通过 `applyAxisAngle(_up,cameraAzimuth)` 实现与相机相关的 WASD * 模型朝向：`atan2(v.x, v.z) + CHARACTER.faceOffset` * `model.quaternion.rotateTowards(targetQuat, TurnSpeed * delta)` 5.更新`Game.js`： * 添加“OrbitControls”——第三人称摄像机绕轨道运行的玩家 * 相机跟随：按玩家增量移动 `orbitControls.target` \+ `camera.position` * 将 `orbitControls.getAzimuthalAngle()` 传递给 Player 以进行相对于相机的移动 6. 使用 `loadModel()` 调用 + `.catch()` 后备替换环境原语 7. 添加`THREE.GridHelper`以提供可见的移动参考 8. 在启动时使用“preloadAll()”预加载所有模型以实现即时加载 ### 第 6 步：调整和验证 * 运行 `npm run dev` — 使用 WASD 四处走动，用鼠标绕行相机 *确认角色动画（停止时空闲，移动时行走，Shift时运行） * 调整每个模型的“MODEL_CONFIG”值（scale、rotationY、offsetY） * 运行“npm run build”以确认没有错误 * 从`.meta.json`文件生成`ATTRIBUTION.md` ## 下一步告诉用户： > 您的 3D 游戏现在有自定义模型！角色是使用 Meshy AI（或来自模型库）生成、装配和动画的。世界对象是从 GLB 文件加载的。 > > **创建的文件：** > > * `src/level/AssetLoader.js` — 使用 SkeletonUtils 的模型加载器 > * `public/assets/models/` — 生成并下载的 GLB 模型 > * OrbitControls 第三人称相机 > > > **控制：** WASD 移动，Shift 运行，鼠标拖动绕摄像机旋转，滚动缩放。运行游戏来查看一切的运行情况。调整 Constants.js 中的“MODEL_CONFIG”以微调比例和方向。

添加 3d 资源

包含技能