48 lines
7.3 KiB
Markdown
48 lines
7.3 KiB
Markdown
# 资源说明 · Animation
|
||
|
||
动画与动作资源。每条包含：路径、简要说明。
|
||
|
||
| 资源路径 | 简要说明 |
|
||
| --- | --- |
|
||
| `Tools/output/mixamo/Male/*.fbx` | Mixamo 男骨架（Y Bot）基础动作中间件，FBX for Unity / Without Skin / 30fps。含 Idle、Walking、Running、Punching、Kick(Kicking)、SwordSlash(Stable Sword Outward Slash)、HitReaction、FallingFlatImpact。脚本：`Tools/download_mixamo_anims.py`。未入库 Bundles。 |
|
||
| `Tools/output/mixamo/Female/*.fbx` | Mixamo 女骨架（X Bot）同套动作，导出设置同上。未入库 Bundles。 |
|
||
| `Tools/output/mixamo/manifest.json` | 上述 16 个 FBX 的下载清单。 |
|
||
| `Tools/dgx3d_animal_pipeline.py` | 非人：已验收 FBX/GLB → TokenRig + UniMate Idle/Walk/Attack（不重做 DGX 模）；`--caps-only` 门禁 |
|
||
| `Tools/install_animal_rigged.py` | 将 pipeline 产物拷入 `Characters/Animal/{Name}/Rigged` 与 `Anims` |
|
||
| `AIClient/AgentScripts/SetupAnimalAnimator.cs` | Generic Animator；Motion Int 0=Idle/1=Walk，Attack Trigger单次攻击；样例 `SetupRockBall`，正式敌方由配方入口调用 |
|
||
| `Tools/output/{name}_dgx/` | DGX 非人中间件（rigged_fbx / anims，不进 Bundle） |
|
||
| `Tools/output/rockball_dgx/` | 岩团团中间件；旧 `3cead72a` 19骨代理与验收低模空间不一致，已停用；当前采用同角色 `high_rig/rigged.glb` 12骨和 `walk_verified/` 单Walk验证 |
|
||
| `…/RockBall_Rigged.fbx` | TokenRig 绑骨 FBX（减面约 2k） |
|
||
| `…/anims/RockBall_{Idle,Walk,Attack}.fbx` | UniMate 三动作；入库后见 Bundles |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/RockBall/Anims/RockBall_Idle.fbx` | 2026-10-20：同角色12骨专用UniMate Idle原始源动作，已替换旧19骨来源；任务 `aigame_idle_54f85e5750484ecca7d8eaf439a02f77` |
|
||
| `…/RockBall_Walk.fbx` | 2026-10-20：同角色12骨重新生成的双足直立Walk原始剪辑；未做脚底与循环修正的源数据 |
|
||
| `…/RockBall_Attack.fbx` | 2026-10-20：同角色12骨专用UniMate Attack原始源动作，已替换旧19骨；任务 `aigame_attack_40bc28cae3d24ad0bd737fae1eb6aafc` |
|
||
| `…/RockBall_Animator.controller` | 三动作Generic，默认Idle；Motion=0/1、Attack Trigger，支持Idle/Walk进入Attack并恢复请求状态，Root Motion关闭；正式入口 `Tools/enemy_character_pipeline.py` |
|
||
| `…/Clips/Walk.anim` | 2026-10-20：UniMate原始Walk＋离线根骨绑定姿态校准、脚底贴地、周期接缝与短腿交替步幅编辑；1.1秒循环，步幅0.06m、抬脚0.018m；最终播放资产 |
|
||
| `…/Clips/Idle.anim` | 新12骨源动作＋离线呼吸/参考姿态/贴地收尾；1.6秒循环，首尾一致 |
|
||
| `…/Clips/Attack.anim` | 新12骨源动作＋离线蓄力/冲撞/恢复编辑；1秒单次，0.45秒OnEnemyAttackImpact事件，首尾恢复Idle参考 |
|
||
| `Tools/output/rockball_dgx/walk_verified/motion/` | 本次UniMate原始GLB/FBX、带高模预览、motion.npy、请求记录及日志；明确双足英文提示词，face-right=bone_8、face-left=bone_10；任务 `aigame_walk_89299832de714470b6ed70e5cc837880` |
|
||
| `Tools/generate_animal_walk.py` | 复用既有骨架生成单Walk；保留英文提示词与明确左右骨，独立远程辅助脚本，不改外部LLM3DGraphics源码 |
|
||
| `AIClient/AgentScripts/FinalizeAnimalWalk.cs` | 离线烘焙入口；可调strideMeters/liftMeters/cycleSeconds，最终保存.anim，无运行时反向旋转或程序拼动画 |
|
||
| `AIClient/AgentScripts/VerifyAnimalWalk.cs` | 核验静态形状、61帧蒙皮顶点、根骨倾角、左右脚步幅、循环接缝和Animator连续播放；报告 `Tools/output/rockball_walk_audit/verification.txt` |
|
||
| `Tools/run_rockball_walk.ps1` | 单Walk可复现入口：默认使用缓存骨架/源动作，重做权重→Pipeline导入→Setup→Finalize→Verify并更新manifest；`-Generate`重新生成源动作，`-BuildReview`重建并排验收场景 |
|
||
| `Tools/enemy_character_pipeline.py` / `Config/Art/EnemyCharacters/RockBall.json` | 敌方三动作标准入口与样例配方；同rig来源哈希、蒙皮、Pipeline导入、离线收尾、整段QA、Enemy视觉Variant与并排场景 |
|
||
| `Tools/generate_enemy_motions.py` | 按配方顺序生成指定Idle/Walk/Attack，生成成功后封存源FBX哈希与回执；失败保留旧有效产物 |
|
||
| `AIClient/AgentScripts/FinalizeEnemyMotions.cs` | 根据配方将Idle与Attack源动作离线编辑为可交付.anim，保存循环、命中事件与恢复参考姿态 |
|
||
| `AIClient/AgentScripts/VerifyEnemyMotions.cs` | 三动作各121帧实际蒙皮、根姿态、脚底、步幅、接缝、事件、控制器和Play轮播验证 |
|
||
| `Tools/output/enemy_characters/RockBall/motions/{Idle,Attack}/` | 新UniMate源GLB/FBX、带高模预览GLB、motion.npy、任务日志/回执；同rig哈希62f41bc5…6ca6c0f，与Walk一致 |
|
||
| `Tools/output/enemy_characters/RockBall/{production_manifest.json,verification.txt,motion_processing.txt,walk_processing.txt}` | 三动作来源、哈希、配方、事件时刻、生产状态与验收报告；生成源＋离线编辑，不含运行时骨骼补丁 |
|
||
|
||
## 火喵 FireCat T1 伙伴三动作（2026-10-20）
|
||
|
||
| 资源路径 | 用途与生成方式 |
|
||
| --- | --- |
|
||
| `Tools/output/companions/FireCat/motions/{Idle,Walk,Attack}/` | DGXA UniMate同角色22骨源GLB/FBX、高模预览、npy、回执与日志；rig哈希62a50970…3bea一致。Idle/Walk使用CUDA，Attack首次CUDA内存不足后独立CPU任务成功，未中断其他模型服务。 |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/FireCat/Anims/FireCat_{Idle,Walk,Attack}.fbx` | Pipeline导入上述三段同rig原始动画；Generic、共享Avatar，保留来源，不直接作最终播放。 |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Idle.anim` | 1.6秒循环，源动作8%＋离线轻呼吸/贴地/端点绑定姿态；最大形变约0.01596m，根倾角约1.85°。 |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Walk.anim` | 1.1秒循环，全骨骼源首帧相对绑定校准、保留35%运动＋交替短步/贴地/周期闭合；解决源69.5°根倾斜和坐姿腿偏移，左右步幅约0.06248/0.04547m，根倾角约4.35°。 |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/FireCat/Clips/Attack.anim` | 1.1秒非循环，源动作12%＋双爪75°抬起/小幅前伸的离线施法，0.55秒OnCompanionAttackImpact事件，恢复Idle绑定参考；根倾角约11.31°，视觉根位移<0.005m。火球/伤害未接入。 |
|
||
| `AIClient/Assets/Bundles/Characters/Animal/FireCat/FireCat_Animator.controller` | 默认Idle，Motion Int 0/1切换Idle/Walk，Attack Trigger单次施法后恢复请求状态；Root Motion关闭。实际Play三状态与根位置固定通过。事件接收器应位于Animator所在Model或由该处转发。 |
|
||
| `Tools/output/companions/FireCat/{production_manifest.json,verification.txt,play_verification.txt,walk_verification.txt,motion_processing.txt,walk_processing.txt}` | 完整来源与哈希、配方、出手时刻、三段各121帧蒙皮及状态切换、单Walk门禁和实际Play报告；完整入口已成功复现，status=validated。 |
|
||
| `Tools/character_animation_pipeline.py`、`Config/Art/Companions/FireCat.json` | 伙伴/敌方共享三动作入口与火喵正式配方，包含自身骨名、全骨骼Walk校准、尾部蒙皮修正、源动作幅度与施法参数；默认缓存，--generate显式推理，--generation-device cpu可选。 |
|