带动画3D角色生成
使用 Meshy AI 从文字生成带骨骼动画的人形（Humanoid）3D 角 色。输出最多 4 个 FBX 文件（角色 + 动画）+ 自动配置的 Animator + AnimatorController（Idle / Walk / Run / Action）。
仅支持人形角色（Humanoid）。 通用 3D 物体（武器、家具、车辆等）请用 3D 模型生成；要给已有模型绑骨/加动作请用 模型绑骨与动作生成；2D 帧动画请用 2D 序列帧动画。
开始
从GUI开始
参考 生成3D模型 的开始部分（生成 3D 模型流程一致，通过对话指定带动画的人形角色）。
从CLI开始
使用 generate_animated_character 工具生成带骨骼动画的人形 3D 角色。生成完成后，角色自动保存为 Prefab 并自动配置 Animator + AnimatorController。
输入模式：
| 模式 | 参数 | 说明 |
|---|---|---|
| 文生角色 | prompt | 纯文字描述（≤600 字符） |
模型
Meshy AI（唯一模型）
- 适用场景： 人形角色 + 动画生成（NPC、玩家角色、敌人等）
- 输出： 最多 4 个 FBX 文件（角色 + 动画）+ 自动配置 AnimatorController（Idle / Walk / Run / Action）
- 动画选择： 676 种动画动作（
action_id），默认 Backflip（ID: 452） - 关键参数：
| 参数 | 类型 | 默认 | 说明 |
|---|---|---|---|
prompt | string | 必填 | 角色外观描述（≤600 字符） |
prefab_output_path | string | Assets/TJGenerators/History/ | 输出 prefab 路径，路径冲突自动去重 |
action_id | int | 452（Backflip） | 动画动作 ID（见下表） |
target_polycount | int | 30000 | 目标面数（100–300000）。仅 should_remesh=true 时有效 |
pose_mode | string | "t-pose" | "t-pose" / "a-pose" / "" |
height_meters | float | 1.7 | 角色高度（米） |
enable_pbr | bool | true | 是否生成 PBR 纹理 |
should_remesh | bool | true | 是否启用重网格化；false 时直接返回最高精度三角网格 |
topology | string | "triangle" | "quad" / "triangle"，仅 should_remesh=true 时有效 |
symmetry_mode | string | "auto" | "off" / "auto" / "on" |
seed | int | 0（随机） | 随机种子 |
force_overwrite | bool | false | 删除同路径已有 prefab 并重新生成 |
常用动画动作 ID（action_id）
| ID | 名称 | 类别 |
|---|---|---|
| 0 | Idle | 日常 |
| 42 | Casual_Walk | 行走 |
| 26 | Run_02 | 跑步 |
| 4 | Attack | 战斗 |
| 75 | Arm_Circle_Shuffle | 舞蹈 |
| 452 | Backflip（默认） | 特技 |
完整 676 项动作见包内
animations.json。
AnimatorController 自动配置
| 状态 | 动画片段 | 过渡条件 |
|---|---|---|
| Idle | 复用 Walk 片段（无片段时用 T-pose） | 默认回退 |
| Walk | 行走循环片段 | Speed > 0.1 |
| Run | 跑步循环片段 | Speed > 0.5 |
| Action | 自定义动作片段（action_id） | Action Trigger |
参数：Speed（Float）、Action（Trigger）。默认状态按可用片段优先级决定：Action（有动作片段时进入 Play Mode 立即播放）→ Walk → Idle（T-pose 回退）。
优化
提示词优化
- 描述角色装备和服饰细节：
"a medieval knight in full plate armor with a red cape and horned helmet">"a knight" - 指定风格：
"low-poly cartoony warrior"/"hyper-realistic sci-fi soldier"
面数优化
- 移动端/背景 NPC：
target_polycount: 5000–10000 - 桌面端主角：
target_polycount: 15000–30000 - 高精度 Hero：
target_polycount: 50000+
动画选择
- NPC/待机：
action_id: 0（Idle）；移动角色：action_id: 42（Walk）；战斗角色：action_id: 4（Attack）；默认展示：action_id: 452（Backflip）
拓扑选择
topology: "triangle"（默认）：面数更少，性能更好topology: "quad"：四边面主导，适合后续手动编辑
并行生成
- 最大 3 个并发任务（比其他工具更少）
注意事项
- ⚠️ 仅限人形角色，不支持动物、怪物等非人形骨骼
- ⚠️ 生成耗时 3–10 分钟
- ⚠️ 100% 进度 ≠ 完成：模型文件可能仍在下载导入中，请等待生成完全结束
- ⚠️ 最大 3 个并发任务，比其他工具（5 个）更少
- ⚠️ 默认动作是 Backflip（ID: 452），如果不指定
action_id，进入 Play Mode 会播放后空翻 - ⚠️ 默认拓扑是
triangle（不是 quad） - ⚠️
should_remesh: false会返回 最高精度三角网格，面数不受target_polycount控制 - ⚠️ 中断恢复：生成中断时用
force_overwrite=true重新生成 - ⚠️ AnimatorController 控制方式：进入 Play Mode 自动播放 Action 动画无需写代码；WASD 移动控制需写 MonoBehaviour（用
execute_csharp_script，不要写.cs文件到磁盘）- ⚠️ 输出路径：默认Assets/TJGenerators/History/