Player Locomotion Animation Guide

1. เป้าหมายและขอบเขต

สร้างฐาน locomotion ที่ลื่นและขยายต่อได้สำหรับผู้เล่น Lambeer โดยใช้คลิปจริงใต้ UE package root /Game/MaleLocomotionSet/Animations/Mannequin/InPlace การเคลื่อนที่จริงยังขับด้วย UCharacterMovementComponent; animation มีหน้าที่แสดง pose ให้ตรงกับ velocity, input, stance, gait และจังหวะเท้า

รวมอยู่ในคู่มือ

• Blend Space 2D สำหรับ Standing Walk/Jog/Run Loop
• State Machine สำหรับ Idle → Start → Moving → Stop
• Turn, Pivot, Spin และ Turn in Place
• Crouch, Prone, Jump/Fall/Land
• Sync Markers, Notifies, Inertialization, Distance/Stride matching roadmap
• ข้อควรระวังสำหรับ multiplayer และ MetaHuman

ไม่รวม

• การแก้ Blueprint/C++ หรือ Animation Assets จริง
• การอนุมัติค่าความเร็วหรือ transition threshold ขั้นสุดท้าย
• ระบบ vault/mantle, combat montage และ weapon-specific locomotion

2. สิ่งที่มีอยู่แล้ว กับสิ่งที่จะสร้าง

3. ชุด Animation ที่ตรวจพบ

4. สถาปัตยกรรมที่แนะนำ

ABP_Player
└─ AnimGraph
   ├─ SM_Posture
   │  ├─ Standing → SM_Standing
   │  ├─ StandToCrouch
   │  ├─ Crouching → SM_Crouch
   │  ├─ CrouchToProne
   │  ├─ Prone → SM_Prone
   │  └─ Airborne → SM_Airborne
   ├─ Inertialization
   ├─ Foot placement / Leg IK        [ภายหลัง]
   ├─ Layered Blend per Bone (Aim)
   └─ Output Pose

หลักสำคัญ: Blend Space 2D รับผิดชอบเฉพาะ pose ที่วนต่อเนื่อง ส่วนคลิปที่มีจังหวะและปลายทางชัดเจน เช่น Start, Stop, Pivot และ Spin อยู่ใน State แยก

5. เตรียม Asset ก่อนสร้างกราฟ

1. Duplicate หรือสำรอง ABP_Player และ Blend Space เดิมก่อนทดลอง
2. เปิด A_INP_Idle แล้วบันทึก Skeleton ที่ใช้งาน
3. เปิด ABP_Player แล้วเปรียบเทียบ Target Skeleton
4. ถ้า Skeleton ต่างกัน ให้ retarget ด้วย IK Rig/IK Retargeter ก่อนสร้าง Blend Space
5. เปิดตัวอย่างคลิปตรงหน้า ซ้าย ขวา หลัง และเปิด Show Bones เพื่อยืนยันแกนจริง
6. ตรวจ Loop Animation เฉพาะไฟล์ลงท้าย _Loop; Start/Stop/Pivot ห้าม loop
7. ตรวจ Root Motion setting ว่าชุด In-Place ไม่ได้ขยับ capsule โดยไม่ตั้งใจ

6. ตัวแปรที่ต้องใช้ใน ABP_Player

ลำดับคำนวณขั้นต่ำ

Try Get Pawn Owner
→ Character Movement → Velocity
→ Vector Length XY → GroundSpeed

Velocity + Actor Rotation
→ Unrotate Vector → LocalVelocity
→ Calculate Direction → Direction

Character Movement
→ Current Acceleration
→ Vector Length XY > small dead zone
→ bHasMovementInput

Character Movement → Is Falling → bIsFalling

ระยะยาวให้ย้ายข้อมูล gameplay-relevant ไป C++/component แล้วให้ ABP อ่านผ่าน Property Access หรือ thread-safe update; อย่า cast และค้น component ซ้ำหลายครั้งต่อเฟรม

7. สร้าง Standing Blend Space 2D

สร้าง asset ชื่อเสนอ BS_Standing_Locomotion_2D โดยเลือก Skeleton เดียวกับ ABP_Player

แถว Walk — Speed ตั้งต้น 165

แถว Jog — Speed ตั้งต้น 265

วางโครงแบบเดียวกับ Walk โดยใช้ A_INP_JogFwd_Loop, A_INP_JogFwdLt_45_Loop, A_INP_JogFwdRt_45_Loop, A_INP_JogFwdLt_90_Loop, A_INP_JogFwdRt_90_Loop, A_INP_JogBwdLt_45_Loop, A_INP_JogBwdRt_45_Loop และ A_INP_JogBwd_Loop

แถว Run — Speed ตั้งต้น 600

ชุด Run มีเฉพาะ forward hemisphere: A_INP_RunFwd_Loop, A_INP_RunFwdLt_45_Loop, A_INP_RunFwdRt_45_Loop, A_INP_RunFwdLt_90_Loop, A_INP_RunFwdRt_90_Loop

คลิปด้านข้างซ้ำที่ต้องตัดสินใจ

แพ็กมีทั้ง A_INP_WalkFwdLt_90_Loop กับ A_INP_WalkBwdLt_90_Loop และรูปแบบเดียวกันฝั่งขวา/Jog/Crouch ทั้งสองคลิปอาจเดินไปด้านข้างเท่ากันแต่ให้น้ำหนักลำตัวคนละแบบ Blend Space จุดเดียววางสอง sample ทับกันไม่ได้ จึงให้ใช้ forward-side เป็นค่าตั้งต้น แล้วเก็บ backward-side สำหรับการทดสอบเปรียบเทียบหรือแยก Blend Space ในอนาคต

8. Sync Markers และจังหวะเท้า

1. เปิด A_INP_WalkFwd_Loop
2. หาจังหวะเท้าซ้ายรับน้ำหนักเต็ม แล้วเพิ่ม Sync Marker ชื่อ LeftPlant
3. หาจังหวะเท้าขวารับน้ำหนักเต็ม แล้วเพิ่ม RightPlant
4. ทำซ้ำกับ directional Walk/Jog/Run loops ที่ใส่ใน Blend Space
5. ตั้ง sample players ให้อยู่ Sync Group เสนอชื่อ GroundedLocomotion
6. Preview การเลื่อน Speed ระหว่าง 165 → 265 → 600 และดูว่าเท้าข้างเดียวกันยังอยู่ phase เดียวกัน

Sync Marker ใช้จับ phase; Footstep Notify ใช้ยิงเสียง/เอฟเฟกต์ ทั้งสองอย่างไม่ใช่สิ่งเดียวกัน Start/Stop ที่ใช้ marker syncing ควรเป็น transition leader ตามพฤติกรรมที่ตรวจแล้ว

9. สร้าง SM_Standing

Entry → Idle
Idle → Start
Start → Moving
Moving → Stop
Stop → Idle
Moving → Turn → Moving
Moving → Pivot → Moving
Moving → Spin → Moving
Any State → Airborne (ผ่าน SM_Posture)

Idle

ใช้ A_INP_Idle และเปิด loop; อย่าใส่ Idle ไว้ใน BS_Standing_Locomotion_2D เพราะโปรเจกต์มี start, stop, turn in place และ idle break เฉพาะทาง

Idle → Start

bHasMovementInput
AND NOT bIsFalling
AND Stance == Standing

Start → Moving

ใช้ Notify เสนอชื่อ StartComplete ที่จุดซึ่งน้ำหนักตัวพร้อมเข้า loop หรือใช้ Time Remaining ชั่วคราวระหว่าง prototype

Moving

วาง BS_Standing_Locomotion_2D แล้วต่อ Direction และ GroundSpeed เข้าสองแกน

Moving → Stop

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed ยังมากกว่า dead zone

ต้องเข้า Stop ตอนเริ่มเบรก ไม่ใช่รอ capsule หยุดแล้วจึงเล่น Stop

10. เลือก Directional Start

Start ไม่อยู่ใน 2D Blend Space ให้ใช้ Blend Poses/Select ตาม Gait, RotationMode, DesiredDirection และเท้า

VelocityDirection: เริ่มพร้อมหมุนร่าง

LookingDirection: เริ่มแบบ strafe

เลือกชื่อทิศตรง ๆ เช่น A_INP_JogFwdLt_45_Start, A_INP_JogFwdRt_90_Start, A_INP_JogBwd_Start, A_INP_JogBwdLt_45_Start และ A_INP_JogBwdRt_90_Start เพื่อรักษาหน้าตัวละครเข้าหากล้อง/เป้า

11. Stop, Pivot, Turn และ Spin

Stop

• ตรงหน้า: A_INP_WalkFwd_Stop_LU/RU, A_INP_JogFwd_Stop_LU/RU, A_INP_RunFwd_Stop_LU/RU
• ตรงหลัง: A_INP_WalkBwd_Stop_LU/RU, A_INP_JogBwd_Stop_LU/RU
• ทิศเฉียง: เลือกตรงทิศ เช่น A_INP_JogFwdLt_45_Stop หรือ A_INP_WalkBwdRt_90_Stop
• เบรกแรง: A_INP_WalkFwd_Stop_Fast, A_INP_JogFwd_Stop_Fast, A_INP_RunFwd_Stop_Fast

Pivot

เข้า Pivot เมื่อมี input ใหม่และ desired direction สวนกับ velocity เดิม ใช้ dot product ของ vector ที่ normalize แล้วเป็นตัวช่วยจำแนก แต่ threshold ขั้นสุดท้ายเป็น TBD

• หน้า → หลัง: A_INP_JogFwd2JogBwd_Pivot_L/R
• หลัง → หน้า: A_INP_JogBwd2JogFwd_Pivot_L/R
• หน้า → หลังเฉียง: A_INP_JogFwd2JogBwdLt_45_Pivot_L/R
• รูปแบบ Walk และ Crouch ใช้ชื่อ family เดียวกันตาม gait/stance

Moving Turn

เมื่อยังเคลื่อนไปข้างหน้าและเปลี่ยน heading ให้เลือก A_INP_WalkFwd_45_Turn_L/R, _90_, _135_, _180_ หรือ family Jog/Run ที่ตรง gait

Spin

สำรองไว้สำหรับ reversal รุนแรง เช่น A_INP_JogFwd_Spin_Bwd_180_L/R หรือ A_INP_RunFwdLt_Spin_JogBwdRt_45 ให้ระบบตัดสิน TransitionType เพียงค่าเดียวต่อครั้ง เพื่อไม่ให้ Pivot กับ Spin แข่งขันกันทุกเฟรม

12. Turn in Place และ Idle Break

เมื่อ GroundSpeed อยู่ใน dead zone แต่ mesh yaw ต่างจากทิศที่ต้องมอง ให้เลือกคลิปตามมุม:

A_INP_IdleLt_45_Turn, A_INP_IdleLt_90_Turn, A_INP_IdleLt_135_Turn, A_INP_IdleLt_180_Turn และฝั่ง IdleRt ที่ตรงกัน Crouch มี A_INP_Crouch_IdleLt_*/IdleRt_*

Idle Break ใช้ A_INP_Idle_Break_01 ถึง 03 เป็น state แยกและยกเลิกเมื่อมี input, aim, attack หรือ stance change; ห้ามใส่เป็น sample ปกติใน locomotion blend space

13. Crouch และ Prone

Crouch

สร้าง BS_Crouch_Locomotion_2D แกน Direction × GroundSpeed โดยใช้แถวเดียวใกล้ CrouchSpeed ตั้งต้น 110 และ loop family A_INP_CrouchFwd_Loop, CrouchFwdLt/Rt_45_Loop, CrouchFwdLt/Rt_90_Loop, CrouchBwd_Loop, CrouchBwdLt/Rt_45_Loop เลือก side 90 family หลัง Preview

เปลี่ยน stance ด้วย A_INP_Idle2CrouchIdle และ A_INP_CrouchIdle2Idle แล้วใช้โครง Idle → Start → Moving2D → Stop เหมือน Standing

Prone

สร้าง BS_Prone_Locomotion_2D แต่ authored speed เป็น TBD ใช้ loop จริง: A_INP_ProneFwd_Loop, A_INP_ProneFwdLt45_Loop, A_INP_ProneFwdRt45_Loop, A_INP_ProneFwdLt90_Loop, A_INP_ProneFwdRt90_Loop, A_INP_ProneBwd_Loop, A_INP_ProneBwdLt135_Loop, A_INP_ProneBwdRt135_Loop

ใช้ A_INP_Idle2ProneIdle, A_INP_CrouchIdle2ProneIdle, A_INP_ProneIdle2Idle, A_INP_ProneIdle2CrouchIdle สำหรับ transition ระหว่าง posture

14. Jump, Falling และ Landing

Grounded → JumpStart → Rising → Apex/Falling → Land → Recovery → Grounded

ชุดง่ายสำหรับ milestone แรก

A_INP_JumpIdle_Start → A_INP_JumpIdle_inAir → A_INP_JumpIdle_Land; ใช้ A_INP_Falling_Loop เมื่อตกโดยไม่ได้เริ่มจาก jump sequence ปกติ

กระโดดตาม gait และเท้า

• Walk: A_INP_JumpWalkFwd_Start_LU/RU → inAir_LU/RU → Land_LU/RU
• Jog: A_INP_JumpJog_Start_LU/RU → inAir_LU/RU → Land_LU/RU
• Run: A_INP_JumpRun_Start_LU/RU → inAir_LU/RU → Land_LU/RU

Directional multi-stage family

ตัวอย่างทิศหน้า: A_INP_JumpFwd_Start → A_INP_JumpFwd_Start_Loop → A_INP_JumpFwd_Apex → A_INP_JumpFwd_Land_Fall_Loop → A_INP_JumpFwd_Land → A_INP_JumpFwd_Recovery ทิศ Bwd/Lt/Rt ใช้ชื่อรูปแบบเดียวกัน

15. ลำดับการเพิ่มความลื่น

1. Sync Markers: ทำให้ Walk/Jog/Run ไม่สลับเท้าขณะ blend
2. Inertialization: วางหลัง State Machine และใช้กับ transition ที่ interrupt บ่อย
3. Footstep/Plant Notifies: เลือก Start/Stop/Pivot ให้ตรงเท้า
4. Distance Matching: เพิ่ม curve และ predicted stop/ground distance หลัง base state machine ทำงานถูก
5. Stride Warping: ชดเชยความต่างระหว่าง authored stride กับ capsule speed/encumbrance
6. Orientation Warping: เติมช่องว่างมุมเล็ก ๆ ไม่ใช้แทน Pivot 180°
7. Foot Placement IK: ทำหลัง animation phase ถูก มิฉะนั้น IK จะเพียงซ่อนปัญหา

Plugins ที่จำเป็นต่อ Distance/Pose Warping ยังไม่ได้ยืนยันว่าเปิดอยู่ใน Lambeer.uproject; การเปิด plugin และค่ากระดูก IK เป็น TBD จนถึงขั้น implementation

16. Multiplayer และ Persistence

• ตำแหน่งจริงและ movement mode ยังคง authoritative ผ่าน replicated UCharacterMovementComponent
• Loop pose, direction และ local transition selection ควรคำนวณจาก replicated velocity/acceleration/state บนแต่ละ proxy
• อย่า replicate animation time ทุกเฟรม
• replicate เฉพาะ gameplay state ที่อนุมานไม่ได้อย่างเสถียร เช่น stance, aim mode หรือ transition intent ที่มีผลสำคัญ
• locomotion pose ไม่มีข้อมูลที่ต้อง persist ลง save game
• ทดสอบ Listen Server, Dedicated Server, simulated latency และ remote proxy ก่อนอนุมัติ

17. แผนลงมือทีละระยะ

1. Skeleton gate: Retarget test A_INP_Idle และ A_INP_WalkFwd_Loop
2. 2D core: สร้าง BS_Standing_Locomotion_2D ด้วย Walk/Jog/Run loops
3. Basic states: Idle → Start → Moving → Stop
4. Foot phase: LeftPlant/RightPlant และ Sync Group
5. Directional transitions: Start/Stop ตามทิศ
6. Reversal: Pivot ก่อน แล้วจึง Turn/Spin
7. Postures: Crouch แล้ว Prone
8. Airborne: Jump/Fall/Land/Recovery
9. Aim overlay: Layered Blend per Bone และ turn in place
10. Polish: Distance Matching, Stride/Orientation Warping, Foot IK
11. Network QA: ทดสอบ proxy และ packet simulation

18. Checklist ทดสอบ

19. Technical Decisions และ TBD

• [PROPOSED] ใช้ Blend Space 2D เดียวรวม Standing Walk/Jog/Run Loop
• [PROPOSED] Idle, Start, Stop, Pivot, Turn และ Spin เป็น State แยก
• [PROPOSED] ไม่อนุญาต Run ใน backward hemisphere เมื่อไม่มี animation coverage
• [TBD] Skeleton source/target และ retarget chain ที่อนุมัติ
• [TBD] ความหมายจริงของ _L/_R/_LU/_RU จาก visual inspection
• [TBD] authored speed และ sample positions หลังวัด foot sliding
• [TBD] signed Direction mapping และ side-loop family ที่เลือก
• [TBD] Pivot/Turn/Spin thresholds และ plugin/IK configuration

20. ภาคผนวก: รายชื่อ In-Place Animation จริงทั้งหมด

ตารางนี้สร้างจากไฟล์ .uasset ที่พบจริงใต้ Content/MaleLocomotionSet/Animations/Mannequin/InPlace เมื่อวันที่ 2026-08-29 ชื่อในตารางตัดนามสกุล .uasset เพื่อให้ตรงกับชื่อ UE asset

438 assets

ไม่พบ animation ที่ตรงกับตัวกรอง

21. Relationships และแหล่งอ้างอิง

• FEAT-PLAYER-CHARACTER · Player Character
• PIPE-CPP-BP-GUIDELINES · C++ & Blueprint Guidelines
• TECH-STACK-ENGINE · Tech Stack & Engine
• Epic · Blend Spaces
• Epic · State Machines
• Epic · Animation Sync Groups
• Epic · Distance Matching
• Epic · Pose Warping