test/Assets/PerfectWorld/Scripts/_Doc/AnimationSceneSkillTest.md

Animation Test Scene — Skill Animation Workflow

Scene: Assets/PerfectWorld/Scene/AnimationTest.unity

Use AnimatedModifier, LogPanel, and SkillPanel to load a character, pick a skill, and verify cast + attack animations and GFX path coverage without a server.

See also: AnimationSceneSetup.md (runtime APIs), AnimationSceneEditor.md (bootstrap inspector tools).

---

Scene objects

Hierarchy name	Component	Script
AnimatedModifier	AnimScenePlayerBootstrap	Assets/PerfectWorld/Scripts/AnimTestScene/AnimScenePlayerBootstrap.cs
LogPanel	LogPanelAnimeScene	Assets/PerfectWorld/Scripts/AnimTestScene/LogPanelAnimeScene.cs
SkillPanel	SkillTriggerPanel	Assets/PerfectWorld/Scripts/Debug/SkillTriggerPanel.cs

---

Prerequisites

The scene must include the managers from AnimationSceneSetup.md (§9–11):

• AutoInitializer / ElementDataManProvider
• NPCManager, CECAttacksMan, EC_ManMessageMono
• CECHostPlayer (referenced by AnimatedModifier and SkillPanel)
• UI init so CECUIManager / CECGameUIMan is ready (skill icons)

AnimatedModifier must not be on the same GameObject as CECHostPlayer if Replace host on role switch is enabled.

---

Inspector wiring

AnimatedModifier (AnimScenePlayerBootstrap)

Field	Assign
Player	Scene CECHostPlayer
Camera Object	Main camera
Camera Poses	Preset transforms for orbit views
Initial Role	Default profession + gender on Play
Weapon By Action Type	15 slots (index = action_type / m_uAttackType)
Active Weapon Action Type Index	Slot applied after each load
Anim Scene Avoid Fashion Weapon Config Path	On (recommended)
Bind Player Visual After Model Load	On (required for PlayActionEvent / Animancer)
Is Evil Skill Path	God vs evil catalog (same as CDlgSkillSubList)
Skill Catalog Level	Level for CECHostSkillModel injection (default 1)

Scene UI (camera):

Button	Typical OnClick() target
NextView	AnimatedModifier → AnimScenePlayerBootstrap.ChangeNextCamera()
PreviosView	AnimatedModifier → AnimScenePlayerBootstrap.ChangePreviosCamera()

These cycle Camera Poses and reparent Camera Object (wraps at ends of the list).

Play Mode inspector (select AnimatedModifier): Switch model, Play action, Re-apply active weapon slot.

SkillPanel (SkillTriggerPanel)

Field	Assign
Player	Same CECHostPlayer as AnimatedModifier
Target Marker	CECMonsterTest in front of the player
Skill Grid Container	RectTransform + GridLayoutGroup
Skill Button Prefab	Button + Image (icon) + Text
Filter By Restrictions	Off = full catalog; On = weapon/form/env filter
Is Evil Skill Path	Align with AnimatedModifier
Skill Catalog Level	Align with AnimatedModifier
Log Panel Anime Scene	LogPanel component

LogPanel (LogPanelAnimeScene)

Field	Assign
Copy Text Button Prefab	CopyTextButton row
Copy Text Buttons Parent	Layout parent for rows

Filled automatically when you click a skill on SkillPanel.

---

How to test a skill animation

1. Enter Play Mode

1. Open Assets/PerfectWorld/Scene/AnimationTest.unity.
2. Press Play.
3. Filter Console: [AnimSceneBootstrap].

Expected logs: element data ready → SetPlayerModel done → CECHostSkillModel initialized → [SkillTriggerPanel] Refreshed: N buttons added.

2. Character, weapon, camera

• Role: AnimatedModifier Initial Role, or Play Mode Switch model on AnimatedModifier.
• Weapon: set Active Weapon Action Type Index and prefabs in Weapon By Action Type; Re-apply active weapon slot in Play Mode if you change the index.
• Camera: NextView / PreviosView to step through Camera Poses.

Skill clip names depend on weapon suffix ({prefix}_{weapon_suffix}_吟唱_, _施放起_, _施放落_).

3. Skill list filter (optional)

On SkillPanel, Filter By Restrictions:

• Off — full profession catalog (bootstrap default after load).
• On — only skills passing weapon/form/move-env (MP/AP faked unlimited).

Context menu: Debug: Refresh From Skill Model, Debug: Inject All Config Skills.

4. Target marker

Place Target Marker (CECMonsterTest) ~5 units in front of the player for non-self skills. Self-target skills use the host id.

5. Click a skill (SkillPanel)

LocalCastSkill does the following:

1. LogPanel — Reset(), skill ID, then GFX rows:
   • Cast — from cast combined action
   • Attack — rise/fall combined actions
   • Fly / Hit / HitGrnd — composer or ElementSkill.GetAllGFX
2. Cast animation — PlaySkillCastAction(skillId) immediately.
3. Attack animation — after ~1 s, CECAttacksMan.AddSkillAttack + PlaySkillAttackAction.

Click a LogPanel row to copy the GFX basename (green = Addressables key exists, red = missing).

6. Raw actions (optional)

AnimatedModifier Play Mode inspector: Stand (0), Run (3), or custom action index + Play action (not full skill chains).

---

VFX note (commented composer path)

In SkillTriggerPanel.LocalCastSkill, the direct composerMan.Play(...) block is commented out. VFX in this scene is driven mainly by:

• Combined-action GFX events logged on LogPanel
• The delayed AddSkillAttack / PlaySkillAttackAction path (attack event + CECAttacksMan tick)

You may see animations without all fly/hit GFX playing until those events run. Re-enabling composerMan.Play would be a separate local-VFX experiment; the current workflow matches “animation-first” debugging.

---

Data flow

sequenceDiagram
    participant User
    participant SkillPanel
    participant LogPanel
    participant Host as CECHostPlayer
    participant Attacks as CECAttacksMan

    User->>SkillPanel: Click skill button
    SkillPanel->>LogPanel: Reset + cast/attack/fly/hit GFX rows
    SkillPanel->>Host: PlaySkillCastAction(skillId)
    Note over SkillPanel: Wait ~1s
    SkillPanel->>Attacks: AddSkillAttack(...)
    SkillPanel->>Host: PlaySkillAttackAction(skillId, ...)

---

Troubleshooting

Symptom	Check
No model	NPCManager, Addressables, [AnimSceneBootstrap]; Player on AnimatedModifier
No skill motion	Bind Player Visual After Model Load; Animancer + CombinedActionSO on .ecm
PlaySkillCastAction returned false	Skill not in action map; wrong weapon suffix
Empty skill grid	Wait for bootstrap; Inject All Config Skills; evil/god path vs profession
GFX at origin	Target Marker assigned and positioned
LogPanel all red	Register GFX in Addressables (gfx/...)
Camera buttons dead	NextView / PreviosView wired to ChangeNextCamera / ChangePreviosCamera on AnimatedModifier

Console: [AnimSceneBootstrap], [SkillTriggerPanel]

---

Script references

• Assets/PerfectWorld/Scripts/AnimTestScene/AnimScenePlayerBootstrap.cs
• Assets/PerfectWorld/Scripts/AnimTestScene/LogPanelAnimeScene.cs
• Assets/PerfectWorld/Scripts/Debug/SkillTriggerPanel.cs
• Assets/PerfectWorld/Scripts/Editor/AnimScenePlayerBootstrapEditor.cs