docs: add humanoid animation import plan

2026-07-27 19:39:14 +08:00
parent 669f9fb470
commit 09c89aadf0
2 changed files with 163 additions and 0 deletions
@@ -0,0 +1,32 @@
+# Unity Humanoid Animation Import Design
+
+## Goal
+
+Automatically apply the project's shared humanoid animation import settings when FBX animation assets are imported under `Assets/Game/Art/Actor/`.
+
+## Scope
+
+- Applies to `.fbx` assets inside `Assets/Game/Art/Actor/`.
+- Excludes `Assets/Game/Art/Actor/cityboy/cityboy_sk.fbx`, because it provides the source avatar.
+- Applies only when the FBX import has animation clips.
+- Does not modify existing FBX, prefab, or controller assets directly.
+
+## Import Behavior
+
+When an in-scope FBX with animation clips is imported:
+
+- Set Rig `Animation Type` to `Humanoid`.
+- Set Avatar to `Copy From Other`.
+- Use `Cityboy_sk Avatar` from `Assets/Game/Art/Actor/cityboy/cityboy_sk.fbx`.
+- For every imported animation clip:
+  - Enable Root Transform Rotation `Bake Into Pose`.
+  - Set Root Transform Rotation `Based Upon` to `Original`.
+  - Enable Root Transform Position (Y) `Bake Into Pose`.
+
+## Error Handling
+
+If the Cityboy avatar cannot be loaded, the importer logs a warning and leaves the asset unchanged. This avoids blocking Unity's asset import pipeline.
+
+## Testing
+
+Editor tests cover the path filter, avatar exclusion, and clip-setting mutation logic without importing real FBX files.