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

6.1 สร้างตัวแปรขั้นต่ำสำหรับการทดสอบข้อ 9

1. เปิด ABP_Player แล้วไปที่ My Blueprint → Variables ตรวจหรือสร้าง Velocity (Vector), GroundSpeed (Float), Direction (Float), Acceleration (Vector), bHasMovementInput (Boolean), bIsFalling (Boolean) และ MovementSpeedDeadZone (Float) ให้ชื่อและชนิดตรงกัน จากนั้น Compile โดย MovementSpeedDeadZone จะกำหนด Default Value หลังวัดตามข้อ 9.4 ไม่ต้องมี Set node ใน Event Graph
2. สำหรับ milestone Standing ในข้อ 9 ให้ตรวจว่า Stance ใช้ Enum ที่มีค่า Standing และตั้ง Default Value เป็น Standing ก่อน ส่วนการอัปเดตเป็น Crouched/Prone จะทำเมื่อสร้าง posture เหล่านั้นในข้อ 13
3. LocalVelocity, DesiredDirection, DirectionDelta และ FootPhase ยังไม่จำเป็นต่อ flow เดินหน้ารอบแรก จึงยังไม่ต้องต่อกราฟของตัวแปรเหล่านี้ก่อนทดสอบข้อ 9

6.2 เขียนค่าทุกเฟรมใน Event Blueprint Update Animation

ทำขั้นตอนนี้ใน Event Graph ของ ABP_Player ไม่ใช่ใน AnimGraph หรือ Transition Rule Graph สำหรับรอบแรกให้ใช้ Blueprint update ที่เห็นและ debug ได้ง่ายก่อน แล้วค่อยย้ายไป C++/Property Access หลัง flow ทำงานถูกต้อง

1. หา event Event Blueprint Update Animation หากไม่มี ให้คลิกขวาพื้นที่ว่างแล้วเพิ่ม event นี้
2. จาก execution pin ของ event ต่อเข้า Cast To Character โดยเสียบ Try Get Pawn Owner เข้าที่ Object หากโปรเจกต์มี cast ไปคลาสผู้เล่นที่ยืนยันแล้วอยู่เดิม ให้ใช้ของเดิมและไม่ต้องสร้าง cast ซ้ำ
3. จากผล Cast ดึง Get Character Movement เก็บสายอ้างอิงนี้ไว้ใช้กับ Get Current Acceleration และ Is Falling
4. จาก Character ดึง Get Velocity แล้วต่อค่าเข้า Set Velocity
5. นำค่า Velocity เดียวกันเข้า Vector Length XY หรือ VSizeXY แล้วต่อผลเข้า Set GroundSpeed
6. นำ Velocity กับ Get Actor Rotation ของ Character เข้า Calculate Direction แล้วต่อผลเข้า Set Direction
7. จาก Character Movement เรียก Get Current Acceleration แล้วต่อค่าเข้า Set Acceleration
8. นำ Current Acceleration เข้า Vector Length XY แล้วเปรียบเทียบ Float > 0.0 ต่อผล Boolean เข้า Set bHasMovementInput สูตรนี้ใช้เป็นเกณฑ์ “Acceleration 2D ไม่เป็นศูนย์” สำหรับ milestone แรก; หาก analog input มี noise ให้ทดสอบ threshold ใหม่และบันทึกเป็นค่าที่อนุมัติภายหลัง
9. จาก Character Movement เรียก Is Falling แล้วต่อผลเข้า Set bIsFalling
10. ต่อสาย execution สีขาวให้ผ่าน Set nodes ทุกตัวตามลำดับ ห้ามวาง Set node ลอยไว้ เพราะ pure nodes อาจมีค่าถูกต้องแต่ตัวแปรจะไม่ถูกเขียน
11. Compile และ Save หาก Cast Failed ให้ปล่อยโดยไม่เขียนค่าในรอบแรก แล้วใช้ข้อ 6.3 ตรวจว่า ABP กำลัง debug pawn instance ที่ถูกต้อง

ภาพรวมสายกราฟขั้นต่ำ

Event Blueprint Update Animation
→ Cast To Character (Object = Try Get Pawn Owner)
→ Set Velocity              = Character.GetVelocity
→ Set GroundSpeed           = VectorLengthXY(Velocity)
→ Set Direction             = CalculateDirection(Velocity, Character.ActorRotation)
→ Set Acceleration          = CharacterMovement.GetCurrentAcceleration
→ Set bHasMovementInput     = VectorLengthXY(Acceleration) > 0.0
→ Set bIsFalling            = CharacterMovement.IsFalling

MovementSpeedDeadZone ไม่อยู่ในสายข้างต้นโดยตั้งใจ เพราะเป็น threshold คงที่ที่ Transition Rules อ่านแบบ Get ไม่ใช่ข้อมูลสถานะที่ต้องสร้างใหม่ทุกเฟรม

6.3 จุดหยุดตรวจ: ยืนยันค่าจริงก่อนสร้าง State Machine

1. เริ่ม PIE เปิด ABP_Player และเลือก instance ผู้เล่นที่กำลังควบคุมอยู่ใน Debug Filter ห้ามดูค่า Default ของ class
2. ตอนยืนนิ่ง: GroundSpeed ต้องอยู่ใกล้ศูนย์, bHasMovementInput=false และ bIsFalling=false
3. ขณะกดเดิน: Acceleration ต้องไม่เป็นศูนย์, bHasMovementInput=true, GroundSpeed ต้องเพิ่ม และ Direction ต้องเปลี่ยนตามทิศเคลื่อนที่
4. เมื่อปล่อย input แต่ capsule ยังไหล: bHasMovementInput ต้องกลับเป็น false ก่อน GroundSpeed ลงถึงศูนย์ พฤติกรรมนี้คือสิ่งที่กฎ Moving → Stop ในข้อ 9.4 ต้องใช้
5. ถ้า Character เคลื่อนที่แต่ค่าทั้งหมดยังคงศูนย์ ให้ตรวจ Anim Class บน Skeletal Mesh, Debug Filter, Cast Failed และสาย execution ก่อนทำข้อ 7–9 ต่อ

6.4 ตัวแปรระยะถัดไป: ต้อง set เมื่อใดและจากอะไร

ตัวแปรทุกตัวต้องมี source of truth แต่ไม่จำเป็นต้องเขียนทุกตัวทุกเฟรม บางตัวเป็นค่าคงที่ของ milestone ปัจจุบัน บางตัวเปลี่ยนตาม event และบางตัวยังต้องเพิ่ม runtime contract ก่อนใช้งาน ตารางนี้เป็น gate ว่าต้องต่อให้เสร็จก่อนเริ่มหัวข้อใด

ต่อ LocalVelocity, DesiredDirection และ DirectionDelta

1. เพิ่ม Set LocalVelocity ต่อท้ายการคำนวณ Velocity ในข้อ 6.2 โดยใช้ node Unrotate Vector รับ Vector = Velocity และ Rotation = Actor Rotation
2. หลังคำนวณ bHasMovementInput ใช้ Branch: ทาง True นำ Acceleration กับ Actor Rotation เข้า Calculate Direction แล้ว Set DesiredDirection; ทาง False ไม่ต้องเขียนทับ เพื่อเก็บทิศ input ล่าสุดไว้ให้ Stop/Pivot
3. บนทาง True หลัง Set DesiredDirection ใช้ Float - คำนวณ DesiredDirection - Direction แล้วส่งเข้า Normalize Axis เพื่อบีบผลให้อยู่ในช่วง -180° ถึง 180° ก่อน Set DirectionDelta
4. PIE และตรวจ input หน้า/หลัง/ซ้าย/ขวา ค่า DesiredDirection ต้องเปลี่ยนทันทีเมื่อกด แม้ Velocity ยังไม่ทันเปลี่ยน ส่วน DirectionDelta ต้องมีขนาดใหญ่เมื่อ input สวนกับทิศที่กำลังไหล

ต่อ Stance และกำหนด RotationMode ให้ตรง runtime

1. นำ native Stance จาก ULambeerAnimInstance ไปใช้ใน SM_Posture โดยตรง; ห้ามสร้าง Boolean bIsCrouched/IsCrouching ซ้ำใน AnimInstance และห้าม map Character Movement → Is Crouching ทับค่า Prone
2. ก่อน runtime contract ใหม่เสร็จ ให้ตั้ง Default Value ของ RotationMode เป็น VelocityDirection และตรวจใน PIE ว่าค่ายังคงตรงกับ Character ซึ่งหันตาม movement
3. เมื่อ implement ข้อ 10.7 ให้ derive RotationMode จาก AimMode หลังฝั่ง Character สลับ rotation behavior สำเร็จแล้ว ห้ามให้ ABP สลับ mode ก่อน gameplay

Contract ของ Gait และ FootPhase

• Gait: native อ่าน CurrentGait และ latch StartGait ตอน JustPressed แล้ว; Moving Blend Space ยังเลือกแถวด้วย GroundSpeed ตามข้อ 9
• FootPhase: native ประมาณ LeftUp/RightUp จากความสูง foot_l/foot_r; ก่อนใช้เลือก Stop/Jump _LU/_RU แบบ production ให้ตรวจภาพแล้วใส่ Notify/curve ทับค่านี้ได้ ส่วน suffix เปล่า _L/_R ยังเลือกจาก direction เท่านั้น

ระยะยาวให้ย้ายข้อมูล 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 442 จาก Root Motion Forward Loop

วางโครงแบบเดียวกับ 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 และจังหวะเท้า

เป้าหมายของขั้นตอนนี้คือให้ Walk, Jog และ Run ใช้ชื่อ marker และลำดับก้าวชุดเดียวกัน เพื่อให้การ blend ข้ามความเร็วหรือข้ามทิศไม่สลับเท้าที่รับน้ำหนักกะทันหัน เริ่มจากคลิปเดียวให้ถูกก่อน แล้วจึงทำซ้ำกับคลิปที่ใช้งานจริงทั้งหมด

8.1 วาง marker ต้นแบบในคลิปเดินหน้า

1. ใน Content Browser เปิด A_INP_WalkFwd_Loop ด้วย Animation Sequence Editor แล้วเปิดการเล่นแบบวนซ้ำใน Preview
2. เปิดการแสดง Skeleton/Bones หรือ Bone Names ใน viewport จากนั้นลดความเร็ว Preview และลาก playhead ทีละเฟรมบริเวณที่เท้าซ้ายแตะพื้น
3. เลือกเฟรมที่เท้าซ้าย เริ่มรับน้ำหนักและกำลังจะนิ่งกับพื้น ไม่ใช่เลือกจากตำแหน่งเท้าต่ำที่สุดเพียงอย่างเดียว ให้ดูทั้งส้น ปลายเท้า และการถ่ายน้ำหนักของสะโพกประกอบกัน
4. ที่แถบ Notifies/Markers คลิกขวาตรงเวลานั้น เลือกเพิ่ม Sync Marker แล้วสร้างหรือเลือกชื่อ LeftPlant ชื่อนี้ต้องสะกดและใช้ตัวพิมพ์เหมือนกันทุกคลิป
5. เลื่อนไปยังเฟรมที่เท้าขวาเริ่มรับน้ำหนัก แล้วเพิ่ม RightPlant ด้วยหลักเดียวกัน
6. เล่นคลิปวนผ่านรอยต่อท้ายคลิปกลับไปต้นคลิป ตรวจว่าลำดับ marker สลับ LeftPlant → RightPlant → LeftPlant อย่างต่อเนื่อง หากช่วงก้าวคร่อมปลายคลิป ให้ตรวจทั้งสองด้านของรอยต่อก่อนขยับ marker
7. บันทึก asset แล้วปิด–เปิดใหม่หนึ่งครั้งเพื่อยืนยันว่า marker ถูกเก็บใน Animation Sequence แล้ว

8.2 ทำซ้ำกับ sample ที่อยู่ใน Blend Space

1. เปิด BS_Standing_Locomotion_2D และจดรายชื่อ Animation Sequence ที่เป็น sample จริง เพื่อไม่เสียเวลาใส่ marker ให้ asset ที่ยังไม่ได้ใช้
2. ทำ Walk ให้ครบทุกทิศก่อน จากนั้นทำ Jog และ Run โดยใช้ marker เพียงสองชื่อเดิม ห้ามสร้างชื่อแยกตาม gait เช่น WalkLeftPlant หรือ RunLeftPlant
3. สำหรับคลิปด้านข้างและด้านหลัง ให้ยึด เท้าซ้าย/ขวาตามร่างกายตัวละคร ไม่ใช่ซ้าย/ขวาตามกล้องหรือทิศการเคลื่อนที่
4. หลังแก้แต่ละ family ให้ Preview เปรียบเทียบคลิปหน้า ซ้าย ขวา และหลังที่ความเร็วเดียวกัน ถ้า blend แล้วเข่างอผิดจังหวะหรือเท้าสลับ ให้กลับไปตรวจ marker ของ sample คู่นั้นก่อนแก้ Blend Space

8.3 ตรวจ marker ใน Blend Space ก่อนสร้าง State Machine

1. เปิด BS_Standing_Locomotion_2D และตรวจอีกครั้งว่า sample ทุกตัวอ้างถึง Animation Sequence ที่ใส่ LeftPlant/RightPlant แล้ว
2. Preview ทีละจุด sample เพื่อยืนยันว่าคลิปวนและลำดับเท้าถูกต้อง ก่อนทดสอบการ blend ระหว่างจุด
3. ลากตำแหน่ง Preview ข้าม sample ที่อยู่ติดกัน ถ้าขากระตุกหรือเท้าสลับ ให้เปิด Animation Sequence คู่นั้นกลับไปเทียบตำแหน่ง marker
4. บันทึก Blend Space เมื่อรายชื่อ sample และ marker ครบ การผูก Blend Space Player เข้ากับ Sync Group จะทำในข้อ 9.3 หลังสร้าง State Moving แล้ว

ขอบเขตของสองระบบ: Sync Marker ใช้จับ phase ระหว่าง animation players แต่ไม่ยิง event เพื่อเขียน FootPhase ส่วน Anim Notify หรือ curve ใช้อัปเดต LeftUp/RightUp ที่เฟรมซึ่งตรวจแล้ว และ Anim Notify แยกสำหรับ foot contact ยังใช้เรียกเสียง ฝุ่น หรือรอยเท้าได้ ห้ามใช้ Notify แทน marker สำหรับการ sync และห้ามถือ foot contact ว่าเป็นข้อมูลเดียวกับ foot-up phase

8.4 ทดสอบก่อนผ่านขั้นตอนนี้

• ใน Blend Space Preview ลากจาก Walk 165 → Jog 442 → Run 600 ช้า ๆ แล้วลากกลับ โดยเฝ้าดูว่าเท้าข้างที่รับน้ำหนักไม่เปลี่ยนกลางจังหวะ
• ตรึง Speed ไว้ทีละแถว แล้วลาก Direction ผ่านหน้า → เฉียง → ข้าง → หลัง เพื่อตรวจ sample แต่ละคู่
• ทดสอบรอยต่อ -180/180 แยกต่างหาก เพราะเป็นจุดที่ sample ด้านหลังอาจกระโดด phase
• เมื่อ Preview ผ่านแล้วจึงไปสร้าง SM_Standing ในข้อ 9 ส่วนการตรวจ Sync Group ใน PIE อยู่ในข้อ 9.6

9. สร้าง SM_Standing

ขั้นตอนนี้เริ่มจาก AnimGraph ที่ยังไม่มีโครง State Machine ตามข้อ 4 โดยจะสร้าง SM_Posture, State Standing และ SM_Standing ตามลำดับ แล้วทำโครงพื้นฐาน Idle → Start → Moving → Stop → Idle ให้เดินได้ก่อน

AnimGraph
└─ SM_Posture
   └─ Standing
      └─ SM_Standing
         ├─ Entry → Idle
         ├─ Idle → Start
         ├─ Start → Moving
         ├─ Moving → Stop
         └─ Stop → Idle

เพิ่มภายหลัง:
Moving → Turn/Pivot/Spin → Moving   [ข้อ 11]
Standing ↔ Crouching/Prone         [ข้อ 13]
Standing ↔ Airborne                [ข้อ 14]

9.1 สร้าง SM_Posture, Standing และ SM_Standing

1. เปิด ABP_Player แล้ว Compile ให้ผ่านก่อนเริ่ม เพื่อแยก error เดิมออกจาก error ที่เกิดในขั้นตอนนี้
2. ไปที่ AnimGraph ตรวจว่ามี State Machine ชื่อ SM_Posture อยู่แล้วหรือไม่ หากมีให้เปิดของเดิมและห้ามสร้างชื่อซ้ำ หากยังไม่มี ให้คลิกขวาพื้นที่ว่าง เลือกเพิ่ม State Machine แล้วตั้งชื่อเสนอ SM_Posture
3. ต่อ output pose ของ node SM_Posture เข้าสาย animation หลัก หากกราฟมี Inertialization หรือ Layered Blend per Bone อยู่แล้ว ให้แทรก SM_Posture ไว้ก่อน node เหล่านั้นตามโครงข้อ 4; ถ้ายังไม่มี ให้ต่อเข้ากับ Output Pose ชั่วคราว
4. ดับเบิลคลิก SM_Posture สร้าง State ชื่อ Standing แล้วลากเส้นจาก Entry ไป Standing ขั้นตอนนี้ยังไม่ต้องสร้าง Crouching, Prone หรือ Airborne เพราะจะเพิ่มในข้อ 13–14
5. ดับเบิลคลิก State Standing เพื่อเปิด State Graph จากนั้นคลิกขวาพื้นที่ว่าง เพิ่ม State Machine แล้วตั้งชื่อเสนอ SM_Standing ต่อ output ของมันเข้า State Result
6. ดับเบิลคลิก node SM_Standing แล้วสร้าง States ชื่อ Idle, Start, Moving และ Stop
7. ลากเส้นจาก Entry ไป Idle จากนั้นสร้าง transition ตามลำดับ flow: Idle → Start → Moving → Stop → Idle
8. Compile เพื่อตรวจโครง parent/child ก่อนใส่ animation ถ้า compiler แจ้งว่า State ใดไม่มี pose ถือว่าเป็นอาการปกติในจุดนี้และต้องหายไปหลังทำข้อ 9.2
9. ยังไม่ต้องสร้าง transition ไป Turn/Pivot/Spin จนกว่า state หลักทั้งสี่จะ Compile และทดสอบผ่าน

9.2 ใส่ Pose ภายในแต่ละ State

Idle — ใส่คลิปยืนรอ

1. ใน SM_Standing ดับเบิลคลิก State Idle เพื่อเปิด State Graph
2. ลาก A_INP_Idle จาก Content Browser มาวางในกราฟ จะได้ Sequence Player ของคลิปนี้
3. ต่อ output pose ของ Sequence Player เข้า State Result
4. เลือก Sequence Player แล้วเปิด Loop Animation ใน Details เพราะ Idle ต้องเล่นวนต่อเนื่อง

Start — ใส่คลิปเริ่มเดินหน้าชั่วคราว

1. กลับไป SM_Standing แล้วดับเบิลคลิก State Start
2. ลาก A_INP_WalkFwd_Start มาวางและต่อเข้า State Result
3. เลือก Sequence Player แล้วปิด Loop Animation คลิป Start ต้องเล่นจากต้นไปปลายเพียงครั้งเดียว
4. กลับไปเลือก State Start ในหน้า State Machine แล้วเปิด Always Reset on Entry หากตัวเลือกนี้แสดงใน Details เพื่อให้การเข้า Start ครั้งใหม่เริ่มคลิปจากต้น
5. ขั้นตอนนี้รองรับเฉพาะการทดสอบเริ่มเดินหน้าแบบ Walk ไม่ต้องเพิ่ม Blend Poses, Select หรือคลิปทิศอื่นในตอนนี้

Moving — ใส่ Standing Blend Space

1. กลับไป SM_Standing แล้วดับเบิลคลิก State Moving
2. ลาก BS_Standing_Locomotion_2D มาวางในกราฟให้เป็น Blend Space Player แล้วต่อ output เข้า State Result
3. ต่อ getter ของตัวแปร Direction เข้ากับ input แกนนอน Direction ของ node
4. ต่อ getter ของตัวแปร GroundSpeed เข้ากับ input แกนตั้ง GroundSpeed ของ node
5. ยังไม่ต้องเปลี่ยนรายละเอียด Sync ของ node ในขั้นนี้ การตั้ง Sync Group ทำต่อทันทีในข้อ 9.3

Stop — ใส่คลิปหยุดเดินหน้าชั่วคราว

1. กลับไป SM_Standing แล้วดับเบิลคลิก State Stop
2. ลาก A_INP_WalkFwd_Stop_LU มาวางและต่อเข้า State Result
3. เลือก Sequence Player แล้วปิด Loop Animation จากนั้นเปิด Always Reset on Entry ที่ State Stop หากตัวเลือกนี้แสดงใน Details
4. LU ถูกใช้เพื่อให้กราฟต้นแบบมีคลิป Stop ที่แน่นอนเท่านั้น ความหมาย suffix และการเลือก LU/RU ตามเท้ายังเป็น TBD จึงห้ามถือการเลือกนี้เป็นค่าผลิตจริง

ตรวจ Pose ทั้งสี่ State

1. เปิด State ทั้งสี่กลับไปตรวจว่าทุกกราฟมี animation node ต่อเข้า State Result และไม่มี Result ที่ปล่อยว่าง
2. Compile ABP_Player หากพบ error ให้แก้ State Result หรือ Skeleton mismatch ก่อนสร้าง Transition Rules
3. Save เมื่อ Compile ผ่าน ณ จุดนี้กราฟมี pose ครบแล้ว แต่ยังเปลี่ยน State ไม่ได้จนกว่าจะทำ Transition Rules ในข้อ 9.4

9.3 ผูก Moving เข้ากับ Sync Group

1. เปิด State Moving แล้วเลือก Blend Space Player ที่เล่น BS_Standing_Locomotion_2D
2. ใน Details เปิดหมวด Sync แล้วเปลี่ยน Method จาก Do Not Sync เป็น Sync Group ก่อน หากยังเป็น Do Not Sync node จะไม่ยอมใช้ Group Name ที่กำหนด
3. ตั้ง Group Name เป็นชื่อเสนอ GroundedLocomotion
4. ตั้ง Group Role เป็น Can Be Leader สำหรับ Blend Space Player ตัวนี้ จากนั้น Compile และ Save
5. ถ้า Start หรือ Stop ถูกนำเข้ากลุ่มเดียวกันภายหลัง ให้เลือก leader/follower ตามช่วง transition ที่ทดสอบแล้ว อย่าตั้งทุก node เป็น leader พร้อมกัน เพราะ node ที่แย่งความเป็นผู้นำอาจทำให้ phase กระโดด

9.4 สร้าง Transition Rules ทีละเส้น

Transition ใน State Machine เป็นทางเดียว ลูกศรไปและกลับจึงต้องสร้างแยกกันทุกเส้น เมื่อดับเบิลคลิกวงกลมบนลูกศรจะเปิด Transition Rule Graph ซึ่งต้องส่งค่า Boolean เข้า Can Enter Transition เป็น true จึงจะเปลี่ยน State

เตรียม MovementSpeedDeadZone ก่อนต่อเงื่อนไข

1. ใน My Blueprint สร้างตัวแปร Float ชื่อเสนอ MovementSpeedDeadZone หากยังไม่มี แล้ว Compile เพื่อให้ตัวแปรปรากฏใน Transition Rule Graph
2. เลือกตัวแปรนี้ใน My Blueprint แล้วกำหนดค่าที่ช่อง Default Value หลัง Compile หรือกำหนดผ่าน Class Defaults ของ ABP_Player ไม่ต้องสร้าง Set MovementSpeedDeadZone ใน Event Blueprint Update Animation
3. ระหว่าง PIE เลือก player instance ใน Debug Filter แล้วดู GroundSpeed หลังปล่อย input จน capsule หยุดสนิท ทดสอบซ้ำหลายครั้งและจดค่าสูงสุดที่ยังเกิดขณะถือว่าหยุดเป็น MaxIdleNoise
4. ทดสอบ analog input ต่ำสุดที่ยังตั้งใจให้แสดง locomotion และจดค่าต่ำสุดเป็น MinIntentionalMoveSpeed
5. เลือกค่าทดสอบให้เป็นไปตาม MaxIdleNoise < MovementSpeedDeadZone < MinIntentionalMoveSpeed หากไม่มีช่วงว่างระหว่างสองค่านี้ ให้แก้แหล่ง noise หรือ movement settings ก่อน ไม่ควรฝืนเพิ่ม threshold จนกลืนการเดินช้า
6. ค่าขั้นสุดท้ายต้องทดสอบร่วมกับ braking/deceleration, ทางลาด, network smoothing และ remote proxy จึงยังเป็น TBD เอกสารไม่กำหนดตัวเลขตายตัวก่อนมีผลวัด

Idle → Start — เริ่มเมื่อมี input

bHasMovementInput
AND NOT bIsFalling
AND Stance == Standing

1. ดับเบิลคลิกวงกลมบนลูกศร Idle → Start
2. ลาก bHasMovementInput แบบ Get ลงกราฟและต่อเข้า Boolean AND
3. ลาก bIsFalling แบบ Get ต่อผ่าน Boolean NOT แล้วต่อผลเข้า AND
4. ลาก Stance แบบ Get ต่อเข้า node เปรียบเทียบ Enum และเลือกค่า Standing จากนั้นต่อผลเข้า AND
5. ต่อผล AND เข้า Can Enter Transition แล้ว Compile การใช้ input แทน GroundSpeed ทำให้ Start เริ่มทันทีเมื่อกด ไม่ต้องรอ capsule เร่งความเร็วก่อน

Start → Moving — ออกเมื่อคลิป Start ใกล้จบ

1. กลับไปหน้า SM_Standing แล้วคลิกวงกลมบนลูกศร Start → Moving เพียงครั้งเดียวเพื่อให้ Details แสดงค่าของ transition
2. เปิด Automatic Rule Based on Sequence Player in State ระบบจะอ่านเวลาคงเหลือจาก Sequence Player ที่ relevant ที่สุดใน State Start
3. คง Automatic Rule Trigger Time เป็นค่าติดลบ/default ในรอบแรก เพื่อให้เวลาเริ่ม transition อิง Crossfade Duration โดยยังไม่กำหนด timing ใหม่เอง
4. Compile แล้ว Preview: ลูกศรต้องเกิดหนึ่งครั้งใกล้ท้าย A_INP_WalkFwd_Start และเข้าสู่ Moving
5. วิธีอัตโนมัตินี้ใช้กับ Sequence Player เดี่ยวจากข้อ 9.2 ก่อน เมื่อข้อ 10 เปลี่ยน Start เป็นหลายคลิป ให้ตรวจ relevant player ใหม่ หรือเปลี่ยนเป็น Notify StartComplete ที่ผ่านการตรวจเฟรมแล้ว

Moving → Stop — ปล่อย input ขณะ capsule ยังไหล

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone

1. ดับเบิลคลิกวงกลมบนลูกศร Moving → Stop
2. ต่อ bHasMovementInput ผ่าน Boolean NOT และต่อ bIsFalling ผ่าน Boolean NOT แยกกัน
3. ลาก GroundSpeed กับ MovementSpeedDeadZone แบบ Get แล้วต่อเข้า Float >
4. รวมผลทั้งสามด้วย Boolean AND แล้วต่อเข้า Can Enter Transition
5. เหตุผลที่ใช้ > คือเข้า Stop ตอนผู้เล่นปล่อยปุ่มแต่ capsule ยังมีความเร็ว ไม่รอให้หยุดสนิทแล้วค่อยเล่น animation

Stop → Idle — ออกเมื่อคลิป Stop ใกล้จบ

1. คลิกวงกลมบนลูกศร Stop → Idle แล้วเปิด Automatic Rule Based on Sequence Player in State
2. คง Automatic Rule Trigger Time เป็นค่าติดลบ/default ในรอบแรก เพื่อให้อิง Crossfade Duration เช่นเดียวกับ Start → Moving
3. Compile แล้วตรวจว่า A_INP_WalkFwd_Stop_LU เล่นเพียงครั้งเดียวและกลับ Idle ใกล้ท้ายคลิป ไม่ค้างที่เฟรมสุดท้าย

Moving → Idle — ทางหนีเมื่อหยุดอยู่ใน dead zone แล้ว

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed <= MovementSpeedDeadZone

1. ถ้ายังไม่มีลูกศรนี้ ให้ลากจากขอบ State Moving ไป State Idle ลูกศรต้องชี้ไป Idle
2. เปิด Rule Graph แล้วสร้าง NOT ของ bHasMovementInput, NOT ของ bIsFalling และ Float <= ระหว่าง GroundSpeed กับ MovementSpeedDeadZone
3. รวมทั้งสามด้วย AND แล้วต่อเข้า Result เส้นนี้จะป้องกันไม่ให้ค้างใน Moving เมื่อความเร็วตกถึง dead zone ก่อนที่กฎ Moving → Stop จะเป็นจริง

Start → Stop — ปล่อย input ระหว่าง Start แต่ยังมีความเร็ว

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone

1. ลาก transition จาก Start ไป Stop แล้วสร้างกราฟแบบเดียวกับ Moving → Stop
2. เลือกวงกลมของ Start → Stop และตั้ง Priority Order ให้มีลำดับก่อน Start → Moving เพราะเมื่อผู้เล่นปล่อย input ระหว่าง Start ต้องยกเลิกการไป Moving

Start → Idle — ปล่อย input ระหว่าง Start และหยุดแล้ว

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed <= MovementSpeedDeadZone

1. ลาก transition จาก Start ไป Idle แล้วสร้างกราฟแบบเดียวกับ Moving → Idle
2. ตั้ง Priority Order ให้มีลำดับก่อน Start → Moving เช่นเดียวกับ Start → Stop สองเส้นนี้ไม่ชนกันเพราะเส้นหนึ่งใช้ > และอีกเส้นใช้ <=

Stop → Start — กดเคลื่อนที่ใหม่ระหว่าง Stop

bHasMovementInput
AND NOT bIsFalling
AND Stance == Standing

1. ลาก transition จาก Stop กลับไป Start
2. สร้าง Rule Graph แบบเดียวกับ Idle → Start แล้วต่อผลเข้า Can Enter Transition
3. ตั้ง Priority Order ให้มีลำดับก่อน Stop → Idle เพื่อให้ input ใหม่ขัดจังหวะ Stop ได้ทันทีโดยไม่ต้องรอคลิปจบ
4. ตรวจว่า State Start เปิด Always Reset on Entry ตามข้อ 9.2 มิฉะนั้น Start อาจกลับมาเล่นต่อจากเวลาก่อนหน้า

ตรวจ Priority และ Compile

• ถ้ามี transition ออกจาก State เดียวกันหลายเส้น ค่า Priority Order ที่เป็นเลขน้อยกว่าจะถูกพิจารณาก่อน จัดให้เส้นยกเลิก/ตอบสนอง input มาก่อนเส้นอัตโนมัติที่รอคลิปจบ
• อย่าเปิด Bidirectional เพื่อทดแทนลูกศรขากลับ ให้สร้าง transition แยกแต่ละทิศตามรายการด้านบนเพื่อให้ Rule ชัดเจน
• Compile และ Save จากนั้น hover วงกลมแต่ละลูกศร ตรวจ preview expression ว่าตรงกับสูตรของเส้นนั้นและไม่มี Result ที่ไม่ได้ต่อ
• ค่า Crossfade Duration, Blend Logic และค่า dead zone ขั้นสุดท้ายยังเป็น TBD ให้ปรับหลัง flow ถูกต้องและทดสอบกับ animation จริงแล้ว

9.5 ตรวจเส้นทาง Pose ถึง Output Pose

1. กลับไป State Graph ของ Standing ตรวจว่า output จาก SM_Standing ต่อเข้า State Result
2. กลับไป SM_Posture ตรวจว่า Entry ต่อเข้า Standing และ State นี้แสดงว่า pose ถูกประเมินอยู่
3. กลับไป AnimGraph ตรวจว่า output จาก SM_Posture เดินทางต่อถึง Output Pose โดยไม่มีสายขาด
4. วาง Inertialization ตามสถาปัตยกรรมในข้อ 4 หลัง pose จาก posture state machine หาก node นี้ยังไม่มีในกราฟ
5. Compile และ Save จากนั้นตรวจ Compiler Results ต้องไม่มี error หรือ warning ใหม่จาก state/transition ที่เพิ่ม
6. ยังไม่ต้องสร้าง Airborne หรือ transition ที่อ่าน bIsFalling ในขั้นตอนนี้ ให้เพิ่มพร้อม jump/fall/land ตามข้อ 14 เพื่อไม่ให้มี State ว่างค้างอยู่ในกราฟ

9.6 ทดสอบใน PIE แบบทีละกรณี

1. เริ่ม PIE แล้วเลือก instance ผู้เล่นใน Debug Filter ของ ABP_Player เปิดหน้าต่าง State Machine ค้างไว้เพื่อดู state ที่ active
2. ไม่กด input: ต้องอยู่ Idle และคลิปวนโดยไม่กระโดด
3. กดเดินหน้าจากหยุด: ต้องเห็น Idle → Start → Moving เพียงหนึ่งรอบ ไม่สลับ Start/Moving ทุกเฟรม
4. ปล่อย input ขณะยังเคลื่อนที่: ต้องเห็น Moving → Stop → Idle และ Stop เริ่มก่อน GroundSpeed เป็นศูนย์
5. กดใหม่ระหว่าง Stop: ต้องออกจาก Stop ได้โดยไม่รอคลิปจบ และไม่ค้างใน pose สุดท้าย
6. สลับ Walk/Jog/Run ซ้ำ ๆ แล้วดูว่าเท้าข้างที่รับน้ำหนักไม่เปลี่ยนกลางจังหวะ ถ้ายังมี foot sliding ให้แยกสาเหตุระหว่าง marker ผิด phase กับ authored speed ไม่ตรง movement speed
7. ยังไม่ทดสอบ Jump/Airborne ในขั้นตอนนี้ เพราะ State และ transition ดังกล่าวจะสร้างในข้อ 14
8. ทดสอบ client เพิ่มเมื่อโครง local ผ่านแล้ว โดยดูว่า remote proxy ไม่สั่นระหว่าง Idle/Moving; รายละเอียด replication อยู่ในข้อ 16

10. เลือก Directional Start

เป้าหมายคือเลือกคลิป Start ให้ตรงกับทิศที่ผู้เล่นเพิ่งกด แล้วเล่นคลิปนั้นเพียงครั้งเดียวก่อนเข้า Moving อย่าเริ่มด้วย Walk/Jog/Run, สอง Rotation Modes และทุกทิศพร้อมกัน ให้ทำ Walk + VelocityDirection ทีละทิศก่อน

กด movement ครั้งใหม่
→ อ่าน DesiredDirection
→ แปลงมุมเป็น Direction Bucket
→ จำ Bucket ไว้ตลอด State Start
→ เลือก Walk Start clip ที่ตรง Bucket
→ เล่นครั้งเดียว → Moving

10.1 ขอบเขตที่ทำได้ตอนนี้

10.2 ตรวจ DesiredDirection ก่อนสร้างตัวเลือกคลิป

1. เปิด ABP_Player แล้ว Compile ให้ไม่มี error จากนั้นเริ่ม PIE
2. กลับมาที่หน้าต่าง Animation Blueprint เลือกตัวละครผู้เล่นที่กำลังควบคุมจาก Debug Filter ห้ามปล่อยเป็น No debug object selected เพราะค่าบนสายกราฟจะไม่วิ่ง
3. เปิด Event Graph คลิกขวาที่ getter ของ DesiredDirection แล้วใช้ Watch this value หรือดูค่าจากแผงตัวแปรระหว่าง debug
4. หันตัวละครไปทิศหนึ่งแล้วกดเดินหน้า ค่าเป้าหมายควรอยู่ใกล้ 0°
5. กดเฉียง, ด้านข้าง และด้านหลังทีละทิศ ตรวจว่าขนาดมุมเข้าใกล้ 45°, 90°, 135° และ 180°
6. ยืนยันว่าค่าที่เห็นเป็นไปตาม contract TBD-LOCO-004: ค่าบวก = ขวา และค่าลบ = ซ้าย หากผลใน Preview กลับด้าน ให้แก้ตำแหน่ง sample/asset mapping ที่ผิด ห้าม negate Direction เป็นจุด ๆ
7. ถ้ากดทิศต่างกันแต่ค่าค้างที่ 0 ให้กลับไปแก้สาย Acceleration → Calculate Direction → Set DesiredDirection ในข้อ 6.4 ก่อน ห้ามสร้างระบบเลือกคลิปต่อจนกว่าค่านี้จะเปลี่ยนตาม input

10.3 แปลงมุมเป็น Direction Bucket

ขั้น A — สร้าง Enum asset

1. ใน Content Browser ไปยังโฟลเดอร์ Animation ที่เก็บ asset ของระบบ locomotion คลิกขวาพื้นที่ว่างแล้วเลือก Blueprints → Enumeration
2. ตั้งชื่อเสนอ E_StartDirectionBucket แล้วเปิด asset
3. เพิ่มค่าเรียงตามนี้: Forward, Positive45, Negative45, Positive90, Negative90, Positive135, Negative135, Positive180, Negative180
4. ใช้คำว่า Positive/Negative ไปก่อน อย่าใช้ Left/Right จนกว่าจะผ่านการตรวจ signed direction ในข้อ 10.2 แล้ว Save enum

ขั้น B — สร้างตัวแปรใน ABP_Player

1. เปิด ABP_Player ใน My Blueprint กด + ที่ Variables แล้วสร้าง StartDirectionBucket
2. เปลี่ยน Variable Type เป็น E_StartDirectionBucket, Compile แล้วตั้ง Default Value เป็น Forward
3. สร้าง Boolean bHadMovementInput, Compile แล้วตั้ง Default Value เป็น false ตัวแปรนี้คือค่าจากเฟรมก่อน ไม่ใช่สำเนาที่ตั้งพร้อม bHasMovementInput

ขั้น C — สร้าง ResolveStartDirectionBucket

1. ใน My Blueprint กด + ที่ Functions ตั้งชื่อเสนอ ResolveStartDirectionBucket
2. เลือก Function Entry แล้วเพิ่ม Input ชื่อ Angle ชนิด Float
3. เลือก Return Node แล้วเพิ่ม Output ชื่อ Bucket ชนิด E_StartDirectionBucket
4. ลาก Angle เข้า node Abs (Float) แล้วใช้ผลเดียวกันเข้าชุดเปรียบเทียบ < ตามตารางด้านล่าง
5. สร้าง Branch ไล่จากมุมน้อยไปมาก: < 22.5 ก่อน จากนั้น < 67.5, < 112.5 และ < 157.5 เฉพาะสาย False ของข้อก่อนหน้า
6. สาย True ของ < 22.5 คืน Forward ส่วนช่วงอื่นให้เปรียบเทียบ Angle >= 0.0 แล้วคืนค่า Positive ทาง True และ Negative ทาง False
7. ช่วงสุดท้ายที่ไม่ผ่าน < 157.5 ไม่ต้องเปรียบเทียบขนาดอีก ให้ใช้เครื่องหมาย Angle เลือก Positive180/Negative180
8. ถ้าต้องการแยกปลายทางให้อ่านง่าย ให้เพิ่ม Return Node สำหรับแต่ละผลลัพธ์และกำหนดค่า Bucket ที่ node นั้น แล้ว Compile และ Save

ค่า 22.5/67.5/112.5/157.5 เป็นจุดกึ่งกลางระหว่างมุม animation 0/45/90/135/180 ใช้เพื่อเลือก sample ที่ใกล้ที่สุด ไม่ใช่ gameplay threshold ใหม่

AbsAngle < 22.5  → Forward
else AbsAngle < 67.5  → Angle >= 0 ? Positive45  : Negative45
else AbsAngle < 112.5 → Angle >= 0 ? Positive90  : Negative90
else AbsAngle < 157.5 → Angle >= 0 ? Positive135 : Negative135
else                  → Angle >= 0 ? Positive180 : Negative180

10.4 จำ Bucket เฉพาะตอนเริ่มกด

ห้าม Set StartDirectionBucket จาก DesiredDirection ทุกเฟรมระหว่างอยู่ใน Start เพราะถ้าผู้เล่นขยับ stick คลิปอาจสลับกลางทาง ให้จับค่าที่ขอบ false → true ของ movement input และต้องเรียง execution ตามขั้นต่อไปนี้:

1. หา Set bHasMovementInput ใน Event Blueprint Update Animation จากข้อ 6.2 แล้วต่อ exec ออกจาก node นี้เข้า Sequence เพิ่ม pin ให้มี Then 0, Then 1 และ Then 2
2. Then 0 ใช้อัปเดตทิศของเฟรมปัจจุบัน: ต่อเข้า Branch ที่ Condition = bHasMovementInput ทาง True ต่อ Calculate Direction โดยใช้ Acceleration และ Actor Rotation แล้ว Set DesiredDirection จากนั้นค่อยอัปเดต DirectionDelta ตามข้อ 6.4 ทาง False ปล่อยให้ DesiredDirection เก็บค่าล่าสุด
3. สร้าง NOT Boolean จาก getter bHadMovementInput แล้วนำผลไป AND กับ getter bHasMovementInput ตั้งชื่อความหมายของสายนี้ว่า JustPressed; ไม่จำเป็นต้องสร้างเป็นตัวแปรใหม่
4. Then 1 ต่อเข้า Branch ที่ Condition = JustPressed ทาง True เรียก ResolveStartDirectionBucket โดยต่อ getter DesiredDirection เข้า Angle แล้วต่อ output Bucket เข้า Set StartDirectionBucket; ทาง False ไม่ต้อง Set
5. Then 2 ต่อเข้า Set bHadMovementInput และต่อ getter bHasMovementInput เข้าค่าใหม่ ขั้นนี้ต้องอยู่ท้ายสุดเพื่อให้ Then 1 ยังอ่านค่า previous frame ได้
6. Compile และ Save จากนั้น PIE แล้ว Watch bHasMovementInput, bHadMovementInput, DesiredDirection และ StartDirectionBucket พร้อมกัน
7. ทดสอบ กด → ถือ → ปล่อย → กดทิศใหม่: bucket ต้องเปลี่ยนเฉพาะเฟรมแรกของการกดแต่ละครั้ง, คงเดิมระหว่างถือ และพร้อมเปลี่ยนใหม่หลังมีอย่างน้อยหนึ่งเฟรมที่ input เป็น false

หลัง Set bHasMovementInput

Sequence
├─ Then 0 → Branch(bHasMovementInput)
│            └─ True → CalculateDirection(Acceleration, ActorRotation)
│                     → Set DesiredDirection → Set DirectionDelta
├─ Then 1 → Branch(bHasMovementInput AND NOT bHadMovementInput)
│            └─ True → ResolveStartDirectionBucket(DesiredDirection)
│                     → Set StartDirectionBucket
└─ Then 2 → Set bHadMovementInput = bHasMovementInput

10.5 ต่อ Walk clips ใน State Start

ขั้น A — baseline เดิมสำหรับสร้างตัวเลือก pose

1. เปิด SM_Standing → Start เก็บ Sequence Player เดิมที่ต่อกับ State Result ไว้เป็น fallback จนกว่ากราฟใหม่ Compile ผ่าน
2. คลิกขวาพื้นที่ว่าง ค้นหา Blend Poses by E_StartDirectionBucket แล้ววาง node; ถ้าค้นไม่พบ ให้ Compile/Save enum และ ABP ก่อน แล้วเปิดเมนูค้นหาใหม่
3. node เริ่มต้นอาจยังไม่แสดง pose ของทุก enum ให้คลิกขวาที่ node แล้วเลือกคำสั่งเพิ่ม pose/pin สำหรับ Forward, Positive45, Negative45, Positive90, Negative90, Positive135, Negative135, Positive180 และ Negative180 ชื่อคำสั่งย่อยอาจแสดงเป็น Add Pose Pin หรือชื่อ enum entry ตาม UI ของ editor
4. ลาก getter StartDirectionBucket จาก My Blueprint มาต่อเข้า Active Enum Value
5. ลาก A_INP_WalkFwd_Start มาวางให้เป็น Sequence Player ปิด Loop Animation แล้วต่อเข้า pose Forward
6. สร้าง Sequence Player ของ A_INP_WalkFwd_Start เพิ่มเป็น fallback สำหรับ Default Pose และทุก bucket ที่ยังไม่ได้ยืนยัน L/R อย่าปล่อย pose ที่อาจถูกเลือกว่าง
7. ต่อ output ของ Blend Poses by E_StartDirectionBucket เข้า State Result แล้ว Compile หากผ่านจึงถอดสายของ Sequence Player เดิมออกจาก Result

ขั้น B — แทน fallback ด้วยคลิปจริงทีละคู่

1. เริ่มจากคู่ 45° ก่อน เปิด animation _45_L และ _45_R ใน Animation Editor ดูการหมุนของ root/สะโพกและก้าวแรก
2. ใช้ mapping ที่ยืนยันจาก PIE แล้วว่า DesiredDirection เครื่องหมายบวกใช้คลิป suffix _R และเครื่องหมายลบใช้ _L: ต่อ _45_R เข้า Positive45 และ _45_L เข้า Negative45
3. Compile และ PIE ทดสอบทั้งสองฝั่งก่อนทำคู่ถัดไป ถ้าถูกจึงทำ 90°, 135° และ 180° ด้วยวิธีเดียวกัน
4. Sequence Player ทุกตัวต้องตั้ง Loop Animation=false และไม่เปิดตัวเลือกที่ตัด node ออกจาก relevancy test เพราะ transition อัตโนมัติจำเป็นต้องรู้เวลาคงเหลือของ clip ที่ active
5. เลือก State Start ที่หน้า State Machine แล้วตรวจใน Details ว่า Always Reset on Entry เปิดอยู่ เพื่อให้กดครั้งใหม่แล้วคลิปเริ่มจากต้น
6. ยังไม่ต้องกำหนด Blend Time ใหม่ในรอบแรก ใช้ค่าเดิมเพื่อพิสูจน์การเลือก clip ก่อน แล้วค่อย tune จากผล visual test โดยไม่เดาตัวเลขล่วงหน้า

Native StartGait + RotationMode + StartDirectionBucket
                         └─→ SelectedStartAnimation
SelectedStartAnimation ──→ Sequence Player (Loop=false) ──→ State Result

ขั้น C — ตรวจทางออก Start → Moving

1. กลับหน้า SM_Standing คลิกลูกศร Start → Moving แล้วตรวจว่า Automatic Rule Based on Sequence Player in State ยังเปิดอยู่
2. PIE ทีละ bucket แล้วดูว่า transition เกิดใกล้ท้ายคลิปที่กำลังเล่นจริง ไม่ใช่อ้างเวลาจาก fallback หรือ player ที่ inactive
3. ถ้าบาง bucket ออกทันทีหรือค้าง ให้ตรวจ relevancy ของ Sequence Player และสาย pose ก่อน
4. ถ้าการใช้ relevant player ยังไม่เสถียร ให้เพิ่ม Anim Notify ชื่อเสนอ StartComplete ในทุก Start clip ณ เฟรมที่ตรวจภาพแล้ว และเปลี่ยน transition ให้ใช้ event/flag จาก notify เดียวกัน ห้ามวาง notify ด้วยเลขเฟรมที่เดา

10.6 รายชื่อคลิป VelocityDirection

family นี้ใช้เมื่อ Character หันตามทิศ movement คลิป angled Start มีหน้าที่เริ่มก้าวพร้อมหมุนร่าง:

ผล PIE ของโปรเจกต์ยืนยัน signed-direction mapping สำหรับ Start แล้วว่า Positive → _R และ Negative → _L โดย _L/_R ใน family นี้หมายถึงทิศหมุนซ้าย/ขวา ไม่ใช่เท้า ส่วน gait-phase suffix _LU/_RU ใช้ contract แยกตามข้อ 10.7

10.7 Contract ที่อนุมัติ: LookingDirection, Gait และ suffix

LookingDirection rotation contract

• AimMode == HipRelaxed ใช้ RotationMode = VelocityDirection: Character เปิด bOrientRotationToMovement และไม่ใช้ controller yaw หมุน actor
• AimMode == ShoulderAim หรือ ADS ใช้ RotationMode = LookingDirection: Character ปิด bOrientRotationToMovement และ gameplay rotation system ต้องหัน actor ตาม aim/control yaw ก่อนที่ ABP จะเลือก strafe pose
• AimMode ที่ replicate อยู่แล้วเป็น input ของ contract แต่ ABP เป็นผู้บริโภคเท่านั้น ห้าม ABP เขียนค่า rotation behavior กลับไปยัง Character
• คลิปอย่าง A_INP_JogFwdLt_45_Start, A_INP_JogFwdRt_90_Start และ A_INP_JogBwd_Start ใช้เฉพาะ LookingDirection เพื่อรักษาหน้าเข้าหากล้อง/เป้า ส่วน VelocityDirection ใช้ angled start ที่หมุนร่างตาม movement
• การสลับ HipRelaxed ↔ ShoulderAim/ADS ต้องทดสอบทั้ง local player และ remote proxy ว่า actor yaw, movement direction และ pose เปลี่ยนในเฟรมที่สอดคล้องกันโดยไม่เกิด state flapping

TBD-LOCO-006 — authoritative Gait contract [CONFIRMED]

• สร้าง enum กลาง ELambeerGait { Walk, Jog, Run } และให้ ULambeerLocomotionComponent เป็น source of truth ของ replicated CurrentGait
• ลำดับตัดสิน gait คือ Crouched → Walk; sprint intent ที่ผ่านเงื่อนไข gameplay → Run; analog input ที่มากกว่า 0 แต่ต่ำกว่า WalkInputThreshold → Walk; กรณีเคลื่อนที่ปกติ → Jog
• Encumbrance ปรับ movement speed ผ่าน multiplier แต่ไม่เปลี่ยนชื่อ gait โดยตัวมันเอง ถ้าอนาคตต้องบังคับลด gait ต้องทำเป็น gameplay rule ที่เปลี่ยน CurrentGait อย่างชัดเจน
• Autonomous proxy อัปเดตแบบ predicted เพื่อความตอบสนอง แล้ว server ยืนยันค่าเดียวกัน; simulated proxy อ่านค่าที่ replicate ห้าม derive จาก GroundSpeed หรือ MaxWalkSpeed
• AnimInstance อ่าน CurrentGait เป็น Gait และใช้เงื่อนไข Gait == Run แทน bIsSprinting ทุกจุด เมื่อ migrate Blueprint/C++ references ครบแล้วให้ลบ bIsSprinting เพื่อไม่ให้มีสอง source of truth
• ในเฟรม JustPressed ให้จับ StartGait = Gait พร้อม StartDirectionBucket แล้วใช้สองค่าที่ latch ไว้เลือก Walk/Jog/Run Start; ห้ามเลือก gait ใหม่ทุกเฟรมกลางคลิป Start

LocomotionComponent.CurrentGait (replicated)
→ AnimInstance.Gait
→ JustPressed: latch StartGait + StartDirectionBucket
→ Select RotationMode
→ Select StartGait
→ Select StartDirectionBucket
→ Play Start once

TBD-LOCO-002 — suffix contract [CONFIRMED]

• _L/_R เป็น direction suffix และห้ามเลือกจาก foot state; _LU/_RU เป็น gait-phase suffix และห้ามเลือกจาก signed direction
• ใช้ FootPhase แบบ LeftUp/RightUp เป็นตัวเลือกตรงสำหรับ _LU/_RU ถ้ายังคงตัวแปรเดิม LastPlantedFoot ชั่วคราว ให้ map แบบตรงข้ามในช่วง single support: LastPlantedFoot = Right → LeftUp และ LastPlantedFoot = Left → RightUp
• ความหมาย suffix มาจาก asset-description reference ที่ผู้ใช้ยืนยันเมื่อ 2026-08-31 แต่ตำแหน่งเฟรมของ Notify/curve ต้องตรวจ Animation Editor รายคลิป ห้ามคัดลอกเลขเฟรมข้ามคลิปโดยเดา

ลำดับ migration ที่ไม่ทำให้ Blueprint แตก

1. เพิ่ม ELambeerGait, replicated CurrentGait และ getter ใน Locomotion Component ก่อน
2. เพิ่ม Gait, StartGait, RotationMode และ FootPhase ให้ AnimInstance/ABP แล้ว migrate graph ให้ใช้ค่าใหม่
3. ค้น reference ของ bIsSprinting ทั้ง C++ และ Blueprint assets แทนด้วย Gait == Run และ Compile/PIE/Network test ให้ผ่าน
4. ลบ bIsSprinting หลังไม่มี reference เหลือเท่านั้น เพื่อหลีกเลี่ยง broken pins ใน Blueprint

10.8 ทดสอบทีละทิศ [VERIFIED 2026-09-01]

หลักการของการทดสอบคือ เลือกหนึ่งทิศ กดหนึ่งครั้ง แล้วตรวจผลให้ครบก่อนเปลี่ยนทิศ เริ่มจาก Forward ซึ่งตรวจง่ายที่สุด จากนั้นค่อยเพิ่มทิศเฉียง ด้านข้าง และด้านหลัง หากทิศใดไม่ผ่าน ให้หยุดแก้ทิศนั้นก่อนเพื่อไม่ให้หลายปัญหาปนกัน

ขั้นที่ 1 — เตรียมหน้าจอ Debug

1. เริ่ม PIE แล้วเลือกตัวละครที่กำลังควบคุมใน Debug Filter
2. เปิด SM_Standing ให้มองเห็นว่า State ใดกำลังทำงานอยู่
3. Watch ค่าต่อไปนี้: DesiredDirection, bHasMovementInput, bHadMovementInput และ StartDirectionBucket
4. ก่อนกดรอบใหม่ ให้ปล่อย movement input อย่างน้อยหนึ่งเฟรม และยืนยันว่า bHadMovementInput = false

ขั้นที่ 2 — ทดสอบหนึ่งทิศตามลำดับนี้

1. เริ่มจาก Idle แล้วกดทิศที่ต้องการทดสอบหนึ่งครั้ง
2. ดู DesiredDirection ว่าได้มุมตามทิศที่กด
3. ดู StartDirectionBucket ว่าเปลี่ยนเป็น bucket ที่ตรงกับมุมนั้น
4. ดูภาพ animation ว่าเลือกคลิป Start ตรงทิศ และหากชื่อคลิปมี _L/_R ต้องหมุนไปด้านที่ถูกต้อง
5. ดู State Machine ว่าเดินตามลำดับ Idle → Start → Moving เพียงหนึ่งรอบ คลิป Start ต้องไม่ Loop, ไม่ถูกข้ามทันที และไม่ค้างอยู่ใน Start
6. ปล่อย input ให้กลับไป Idle แล้วจึงเริ่มทดสอบทิศถัดไป

ขั้นที่ 3 — ทดสอบเคสขอบกับทุกทิศ

ถ้าผลไม่ตรง ให้ไล่แก้จากอาการ

11. Stop, Pivot, Turn และ Spin

ข้อ 9 ใช้ Stop เดินหน้าคงที่เป็น fallback และข้อ 10 ทำ Directional Start สำเร็จแล้ว ขั้นต่อไปคือเลือกคลิปตอน ปล่อย input หรือ เปลี่ยนทิศกะทันหันขณะยังเคลื่อนที่ ให้ถูกประเภท จากนั้น latch ผลไว้จนคลิปจบ ห้ามคำนวณเลือก Stop/Pivot/Turn/Spin ใหม่ทุกเฟรมกลาง State

Moving
├─ ปล่อย input                         → Stop
├─ ยังมี input + กลับทิศ                → Pivot หรือ Spin
├─ ยังมี input + เปลี่ยน heading         → Moving Turn
└─ ไม่เข้าเงื่อนไขใด                    → Moving 2D ต่อ

Transition State จบหรือถูกยกเลิก        → Moving / Idle

11.1 เตรียมข้อมูลและกติกาการเลือกเพียงครั้งเดียว

สร้าง data contract ตาม C++ convention ของโปรเจกต์ โดยโครงที่อนุมัติแล้วต้องมีอย่างน้อยคือ:

• enum ELambeerLocomotionTransitionType มี None, Stop, Pivot, MovingTurn และ Spin
• SelectedTransitionAnimation ชนิด Animation Sequence reference สำหรับต่อเข้าพิน Sequence ของ Sequence Player
• ค่าที่ latch พร้อมกัน: transition type, gait, source direction, target direction, signed delta, foot phase และ entry speed
• bTransitionLocked หรือ state-equivalent ป้องกัน selector เขียนค่าทับจนกว่าคลิปจบหรือเข้า cancel path

11.2 Stop — ทำ baseline นี้ให้ผ่านก่อน

Stop เกิดเมื่อผู้เล่นเพิ่งปล่อย movement input แต่ capsule ยังมีความเร็ว ลำดับที่ใช้เลือกคือ Gait ceiling + entry speed → ทิศ velocity → FootPhase ส่วน Fast Stop เปิดใช้ภายหลังเมื่อมี threshold ที่อนุมัติ

JustReleased = (NOT bHasMovementInput) AND bHadMovementInput

JustReleased
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone
AND NOT bTransitionLocked
→ latch Stop inputs
→ choose nearest allowed Walk/Jog/Run authored-speed family
→ resolve SelectedTransitionAnimation
→ TransitionType = Stop

1. ในเฟรม JustReleased ให้บันทึก Gait, Direction, FootPhase และ GroundSpeed ก่อนอัปเดตค่าประวัติ input สำหรับเฟรมถัดไป
2. แปลง Direction ที่ latch ไว้เป็น bucket ชุดเดียวกับ Blend Space: Forward, ForwardLeft/Right, SideLeft/Right, BackwardLeft/Right และ Backward
3. ใช้ Gait ปัจจุบันเป็นเพดาน แล้วเทียบ TransitionEntrySpeed กับ Walk/Jog/Run speed หลังคูณ encumbrance เลือก family ที่ใกล้ที่สุด เช่นเพิ่งออกตัวด้วย Gait Jog แต่ปล่อยตอนความเร็วยังใกล้ Walk ให้เลือก Walk Stop; หาก Gait == Run แต่ทิศอยู่ใน backward hemisphere ให้ใช้ Jog fallback เพราะไม่มี Run backward Stop ทั้งสองกรณีไม่เปลี่ยน authoritative Gait
4. Forward/Backward family ที่มี _LU/_RU ให้เลือกจาก FootPhase; ถ้า FootPhase == Unknown ให้ใช้ fallback ที่ทีมกำหนดและเก็บ warning/debug flag แทนการสุ่มทุกเฟรม
5. ทิศเฉียง/ด้านข้างใช้คลิปที่ชื่อระบุทิศและไม่มี foot suffix เช่น A_INP_JogFwdLt_45_Stop ห้ามต่อ FootPhase เข้า selector ส่วนนั้น
6. ต่อ SelectedTransitionAnimation เข้าพิน Sequence ของ State Stop, ปิด Loop และเปิด Always Reset on Entry
7. คง Transition Rules และ cancel paths จากข้อ 9.4: ปล่อยแล้วหยุดสนิทอาจไป Idle โดยตรง และ input ใหม่ระหว่าง Stop ต้องออกไป Start/Moving ก่อนรอคลิปจบ

11.3 Pivot — เปลี่ยนจากทิศหนึ่งไปทิศสวนกัน

Pivot ใช้เมื่อยังถือ input อยู่ แต่ desired direction ใหม่สวนกับ velocity เดิมมากพอ ตัวตรวจต้องใช้ทั้ง DirectionDelta และ dot product เพื่อกันการเข้า Pivot จากการแก้ทิศเล็กน้อย

bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone
AND Abs(DirectionDelta) >= PivotEnterAngle      [Baseline 125°]
AND Dot(LocalVelocity2D, LocalDesired2D) < PivotDotThreshold [Baseline -0.35]
AND NOT bTransitionLocked
→ latch source + target + signed side
→ TransitionType = Pivot

1. ทำ Pivot ใน Walk หรือ Jog ก่อนหนึ่งคู่ เช่น Forward → Backward และ Backward → Forward แล้วทดสอบ lock/cancel ให้ผ่านก่อนเติมทิศเฉียง
2. เลือก source/target family จากทิศ velocity เดิมและ desired direction ใหม่ ไม่เลือกจาก target เพียงด้านเดียว เพราะชื่อ asset encode ทั้งสองฝั่ง เช่น JogFwd2JogBwd
3. เลือก _L/_R จากเครื่องหมาย signed delta ตามข้อ 10.7 ไม่ใช้ FootPhase
4. Walk, Jog และ Crouch มี Pivot family ที่ตรวจพบ; ไม่พบ Run Pivot จึงให้ Run reversal ไป Spin หรือ Jog fallback ตาม selector ที่อนุมัติ
5. ใน State Pivot ใช้ Sequence Player ที่เปิดพิน Sequence, ปิด Loop, เปิด Always Reset on Entry และตั้งทางออกหลักกลับ Moving เมื่อคลิปใกล้จบ
6. เพิ่ม cancel path ไป Airborne/Posture ก่อน และ Stop เมื่อผู้เล่นปล่อย input กลาง Pivot; priority ต้องสูงกว่าทางจบอัตโนมัติ

11.4 Moving Turn — เปลี่ยน heading แต่ยังไม่ใช่ reversal

Moving Turn ใช้เมื่อ source motion ยังอยู่ใน forward family และผู้เล่นเปลี่ยน heading ต่อเนื่อง คลิปที่ตรวจพบมีมุม 45°, 90°, 135° และ 180° สำหรับ Walk, Jog, Run และ Crouch

1. เริ่มจาก 45° ใน Walk/Jog ก่อน เพราะแยกจาก Pivot ได้ง่ายที่สุด แล้วค่อยเพิ่ม 90°, 135° และ 180° หลัง threshold bands ไม่ทับกัน
2. ตรวจว่า source velocity อยู่ใน forward region ก่อนเลือก Fwd_*_Turn; ถ้ากำลังเคลื่อนหลังหรือด้านข้างให้ใช้ Blend Space/Pivot/Spin แทนตาม coverage
3. ใช้ขนาด Abs(DirectionDelta) เลือก angle bucket และเครื่องหมายเลือก _L/_R; Baseline v0.1 เข้าเมื่อ 30° และแบ่ง bucket ที่ 67.5°/112.5°/157.5° พร้อม re-entry hysteresis 7.5°
4. เมื่อเข้า State ให้ latch animation และ target direction ห้ามสลับจาก 45 เป็น 90 กลางคลิปเพราะ input ขยับต่อ
5. ทางออกหลักกลับ Moving; ถ้า delta เพิ่มถึง reversal region ระหว่างคลิป ให้รอ cancel window ที่กำหนดหรือออกผ่าน Spin/Pivot ตาม policy ที่อนุมัติ ห้ามให้สอง State แข่งขันกันทุกเฟรม

11.5 Spin — ใช้เฉพาะ reversal รุนแรงที่มี coverage

Spin เป็น transition ที่ภาพชัดและกินเวลามากกว่า Pivot จึงเพิ่มเป็นลำดับสุดท้าย ใช้เมื่อ source/target ตรงกับ asset จริงและเข้า spin region ที่ทดสอบแล้ว ไม่ใช่ fallback สำหรับทุก direction mismatch

1. ทำ Pivot และ Moving Turn ให้เสถียรก่อน แล้วจึงเปิด selector ของ Spin เพื่อแยกสาเหตุเวลาทดสอบ
2. Forward ↔ Backward มีคลิป 180° แบบ _L/_R; diagonal cross-over มีคลิป 45°/90° ที่ชื่อ encode source และ target
3. Run Spin ที่ตรวจพบเปลี่ยนจาก Run Forward ไป Jog Backward เช่น A_INP_RunFwd_Spin_JogBwd_180_L/R หลังคลิปจบ animation family จึงต้องสอดคล้องกับ Jog fallback โดยไม่แก้ authoritative Gait ใน ABP
4. Spin ใช้ transition lock เช่นเดียวกับ Pivot และต้องมี cancel path สำหรับ Airborne, posture change และ input release
5. Policy confirmed: Pivot เป็น reversal มาตรฐาน ส่วน Spin ใช้เฉพาะ source/target ที่ตรงกับ asset coverage; Baseline v0.1 ใช้ enter 165°, re-entry hysteresis 10°, cooldown 0.35 s และ commit 20% ของ normalized clip time

11.6 ต่อ State และกำหนด priority ไม่ให้แข่งขันกัน

SM_Standing
├─ Idle
├─ Start
├─ Moving
├─ Stop
├─ Pivot
├─ MovingTurn
└─ Spin

Moving → Stop       เมื่อ TransitionType == Stop
Moving → Pivot      เมื่อ TransitionType == Pivot
Moving → MovingTurn เมื่อ TransitionType == MovingTurn
Moving → Spin       เมื่อ TransitionType == Spin

1. สร้าง State ใหม่ทีละ State เริ่ม Pivot แล้ว Compile/Test ก่อนเพิ่ม MovingTurn และ Spin ทุก State ใช้ Sequence Player ที่เปิดพิน Sequence ตัวเดียวต่อ State และรับค่าจาก SelectedTransitionAnimation
2. ปิด Loop และเปิด Always Reset on Entry ทุก transition State
3. Priority confirmed: selector คืน TransitionType เพียงค่าเดียวต่อ event ตามลำดับ Airborne/Posture cancel → Stop เมื่อไม่มี input → Spin เฉพาะ coverage ที่อนุมัติ → Pivot สำหรับ reversal อื่น → Moving Turn → None
4. ใช้ enter threshold กับ re-entry hysteresis แยกกันเพื่อไม่ให้ค่าใกล้ขอบทำ State flapping; Baseline v0.1 ใช้ Turn 7.5° และ Pivot/Spin 10° และต้องกลับออกจาก enter band ก่อน rearm
5. Baseline v0.1 ใช้ commit window แยกตาม family ที่ Turn 10%, Pivot 15% และ Spin 20% ของ normalized clip time; หาก visual test พบ foot plant/weight transfer ต่างกันรายคลิป ให้เพิ่ม Notify/curve override ใน tuning รอบถัดไปแทนการเปลี่ยนค่ากลางแบบเดา
6. เมื่อ State จบ ให้ clear lock/type หลังระบบอ่านทางออกแล้ว ไม่ clear ก่อนหน้าเพราะอาจกลับเข้า State เดิมซ้ำในเฟรมเดียวกัน
7. เพิ่ม debug output ที่แสดง transition type, selected asset name, latched source/target direction, signed delta, gait และ foot phase ระหว่าง PIE

11.7 ทดสอบทีละประเภทก่อนเปิดพร้อมกัน

11.8 แก้ปัญหาจากอาการที่เห็น

12. Turn in Place และ Idle Break

Turn in Place คือการหมุนท่ายืนโดย capsule ไม่ได้เคลื่อนที่ ส่วน Idle Break คือท่าพักสั้น ๆ ที่เพิ่มชีวิตให้ตัวละคร ทั้งสองระบบใช้คลิป one-shot แต่มี trigger และข้อจำกัดต่างกัน จึงต้องสร้าง State และ cancel policy แยกกัน

12.1 เข้าใจปัญหา rotation ก่อนสร้าง State

แนวทางที่อนุมัติสำหรับ implementation baseline คือ:

• Actor/capsule ownership: gameplay/server เป็น authoritative owner ต่อไป Animation ห้ามเขียน actor transform หรือหมุน capsule
• Mesh/Root-Yaw-Offset: ระหว่าง grounded idle ใน LookingDirection ให้สะสม signed turn request จาก actor-yaw delta และใช้ค่าตรงข้ามเป็น visual root-yaw compensation จน animation turn consume request
• Target-facing source: ShoulderAim/ADS ใช้ authoritative aim/facing yaw ที่ gameplay expose ไม่อ่าน local camera yaw ตรงใน AnimGraph; HipRelaxed ไม่เข้า Turn in Place จากกล้อง
• State entry: เมื่อ request ข้าม enter threshold ให้ latch stance, side, angle bucket และ animation เพียงครั้งเดียว แล้วคลาย visual offset ด้วย curve/notify ของคลิปที่ตรวจแล้ว
• Reset/cancel: movement, Airborne, posture/AimMode change, teleport และ network correction ต้อง clear หรือ rebase offset ตาม policy ที่ทดสอบแล้ว
• Root Motion: ไม่ใช้เป็น baseline; การเปิดใช้ในอนาคตต้องมีการตรวจ asset, collision และ network contract แยกต่างหาก

12.2 ข้อมูลที่ต้องมีหลัง rotation contract ได้รับอนุมัติ

ActorYawDelta      = Normalize Axis(ActorYaw - PreviousActorYaw)
TurnRequestYaw     = Normalize Axis(TurnRequestYaw + ActorYawDelta)
VisualRootYawOffset = -TurnRequestYaw
AbsTurnYaw          = Abs(TurnRequestYaw)

Eligible = GroundSpeed <= MovementSpeedDeadZone
       AND NOT bHasMovementInput
       AND NOT bIsFalling
       AND RotationMode == LookingDirection
       AND gameplay อนุญาตให้หมุน
       AND NOT bTransitionLocked

1. อ่าน actor yaw และ authoritative facing state จาก gameplay contract แล้วอัปเดต TurnRequestYaw; ไม่อ่าน camera yaw ตรงใน AnimGraph
2. เมื่อ Eligible เปลี่ยนเป็น true และมุมข้าม enter threshold ให้ latch side, angle bucket, stance และ selected animation พร้อมกัน
3. ล็อกค่าทั้งชุดตลอด turn clip แม้ target yaw เคลื่อนต่อ; การหมุนเพิ่มระหว่างคลิปให้เก็บเป็น pending turn หรือจัดการหลังคลิปจบตาม policy ที่อนุมัติ
4. ใช้ hysteresis/cooldown ที่ทดสอบแล้วเพื่อกันการสั่นที่ขอบมุม แต่ไม่กำหนดตัวเลขก่อนเปิด asset และทดสอบใน PIE

12.3 สร้าง TurnInPlace State สำหรับ Preview และ integration

ทำ Standing ก่อน แล้วจึงทำ Crouch โดยใช้ selector เดียวกันแต่คนละ asset family:

1. ใน SM_Standing สร้าง State TurnInPlace และต่อ Idle ↔ TurnInPlace
2. ใน State ใส่ Sequence Player ที่เปิดพิน Sequence แล้วต่อ SelectedTurnAnimation เข้าพินนั้น ปิด Loop และเปิด Always Reset on Entry
3. Idle → TurnInPlace ใช้ bRequestTurnInPlace ร่วมกับ grounded/idle/stance guards ไม่ใช้ AbsTurnYaw ตรง ๆ ทุกเฟรม
4. TurnInPlace → Idle ใช้ Automatic Rule Based on Sequence Player in State และ clear request/lock หลังออกจาก State
5. เพิ่ม cancel path ไป Start เมื่อมี movement input, Airborne เมื่อเริ่มตก และ outer posture transition เมื่อ Stance เปลี่ยน โดย cancel priority สูงกว่าทางจบอัตโนมัติ
6. สำหรับ Crouch ให้สร้าง State รูปแบบเดียวกันใน SM_Crouch หลังข้อ 13 ผ่านแล้ว และ selector ต้องเลือก A_INP_Crouch_Idle* จาก latched stance
7. ระหว่างที่ runtime signal, curve/commit และ network rebase ของ TBD-LOCO-007 ยังไม่ implement/verify ให้ trigger State ด้วย debug command/Boolean เฉพาะ Preview เพื่อเช็ก clip direction, skeleton, looping และ pose blend ห้ามปล่อย debug trigger เป็น production logic

12.4 Gate ทดสอบ Turn in Place

12.5 Idle Break — แยกจาก locomotion และ Turn in Place

Idle Break เป็น cosmetic one-shot ขณะตัวละครว่าง ไม่ใช้แก้ yaw และไม่ใส่เป็น sample ใน locomotion Blend Space คลิปที่ตรวจพบคือ Standing A_INP_Idle_Break_01 ถึง 03, Crouch A_INP_Crouch_Idle_Break_01 ถึง 03 และ Prone A_INP_Prone_Idle_Break_01 ถึง 02

1. สร้าง State IdleBreak ใน SM_Standing ก่อน และเพิ่มใน SM_Crouch/SM_Prone หลัง milestone ของ stance นั้นผ่าน; ใช้ Sequence Player ที่เปิดพิน Sequence, ปิด Loop และเปิด Always Reset on Entry
2. selector ใช้ shuffle bag แยกตาม stance, ไม่เลือกคลิปเดิมซ้ำติดกัน และเลือกเฉพาะ family ของ stance ที่ latch ตอน request ห้ามเปลี่ยน Standing break เป็น Crouch/Prone clip กลาง State
3. เงื่อนไข eligible ขั้นต่ำ: GroundSpeed อยู่ใน dead zone, ไม่มี movement input, ไม่ falling, ไม่มี transition lock, posture คงที่ และ gameplay action state อนุญาต
4. delay ก่อนเล่น, cooldown และน้ำหนัก/โอกาสของแต่ละคลิปยังเป็น TBD-LOCO-008 ให้ทดสอบ manual request ก่อนเพื่อไม่สร้างพฤติกรรมสุ่มที่ debug ยาก
5. ทางออกปกติกลับ Idle ด้วย Automatic Rule ทางยกเลิกต้องครอบคลุม movement input, AimMode change, attack/action, jump, damage/reaction และ stance change ตาม signal ที่ gameplay expose
6. Idle Break เป็น cosmetic local selection ได้และไม่ต้อง replicate animation time ทุกเฟรม แต่ action ที่มี gameplay meaning หรือกระทบ held item ต้องถูก block/อนุมัติจาก gameplay ก่อน

Idle
├─ bRequestTurnInPlace → TurnInPlace → Idle
└─ bRequestIdleBreak   → IdleBreak   → Idle

Movement / Airborne / Posture / Action cancel
→ ออกจาก one-shot ไป State ที่ authoritative

12.6 ทดสอบ Idle Break และ cancellation

12.7 แก้ปัญหาจากอาการที่เห็น

13. Crouch และ Prone

เป้าหมายของหัวข้อนี้คือเพิ่มท่าก้มให้ระบบเดิมโดยไม่รื้อ SM_Standing ให้ทำ Crouch เป็น milestone ที่เล่นและทดสอบได้ครบก่อน จากนั้นต่อ SM_Prone ด้วย verification collision/movement ของข้อ 13.5 ค่าขนาด capsule และ ProneSpeed ยังไม่ใช่ production config จนกว่าจะวัดจาก MetaHuman และคลิปจริง

SM_Posture
├─ Standing      → SM_Standing
├─ StandToCrouch → A_INP_Idle2CrouchIdle
├─ Crouching     → SM_Crouch
├─ CrouchToStand → A_INP_CrouchIdle2Idle
├─ StandToProne  → A_INP_Idle2ProneIdle
├─ CrouchToProne → A_INP_CrouchIdle2ProneIdle
├─ Prone         → SM_Prone
├─ ProneToStand  → A_INP_ProneIdle2Idle
└─ ProneToCrouch → A_INP_ProneIdle2CrouchIdle

SM_Prone
└─ Idle → Start → Moving → Stop → Idle

13.1 ตรวจ runtime และตัวแปรก่อนสร้างกราฟ [IMPLEMENTED 2026-09-03]

สถานะที่ตรวจพบในโปรเจกต์ปัจจุบัน:

1. ทำ ข้อ 6.2 ให้ผ่านก่อน แล้วเริ่ม PIE เพื่อตรวจว่า Stance เปลี่ยนเป็น Crouched ตามสถานะที่ Character Movement ยืนยัน, GroundSpeed เปลี่ยนตาม capsule และ Direction มีค่าครบทุกทิศ
2. ตรวจตัวแปร Stance: ค่า enum ใช้ชื่อ Crouched แต่ชื่อ State ในกราฟใช้ Crouching ได้ ทั้งสองชื่อทำหน้าที่ต่างกันและไม่จำเป็นต้องสะกดเหมือนกัน
3. ใน Event Graph ให้เลิก map Is Crouching ซ้ำเป็น Stance แล้วใช้ native ULambeerAnimInstance.Stance ซึ่งมาจาก CurrentStance ที่ locomotion component เป็นเจ้าของ; หลัง C01–C08 ผ่านแล้วให้เพิ่ม State Prone ตามข้อ 13.5
4. ทดสอบยืนขึ้นใต้เพดานต่ำหนึ่งครั้ง หาก Character Movement ปฏิเสธการ UnCrouch ค่า Stance ต้องยังเป็น Crouched และ animation ต้องคงอยู่ที่ Crouching ห้ามให้ ABP เดาเองว่าลุกสำเร็จแล้ว

13.2 สร้าง BS_Crouch_Locomotion_2D [ASSET INTEGRATED 2026-09-03]

1. [VERIFIED 2026-09-03] สร้าง /Game/Lambeer/Characters/Player/Animation/BS_Crouch_Locomotion_2D สำหรับ Skeleton เดียวกับ ABP_Player แล้ว
2. [CONFIRMED PROVISIONAL 2026-09-03 · TBD-LOCO-003] ตั้งแกนนอน Direction = -180..180 แบบ Wrap Input และแกนตั้ง GroundSpeed = 0..110; ใช้ 110 cm/s เป็น sample Y baseline ตาม runtime CrouchSpeed ที่อนุมัติให้ใช้ระหว่างรอวัด authored speed จริง
3. [VERIFIED 2026-09-03] สร้าง moving row หนึ่งแถวที่ 110 cm/s จาก directional Loop 8 ตัว; ไม่ใส่ Idle, Start, Stop, Turn หรือ Pivot ลงใน Blend Space เพราะ pose/state และคลิป non-loop เหล่านั้นแยกออกจาก Moving
4. วาง sample ตามตารางด้านล่าง โดยเริ่มจาก Forward, Backward และรอยต่อ -180/180 ก่อน จากนั้นค่อยเติมทิศเฉียงและด้านข้าง
5. ต่อ sample Backward ตัวเดียวกันไว้ทั้ง -180 และ 180 เพื่อปิด seam ด้านหลัง แล้วลาก Preview ข้าม seam ช้า ๆ
6. [CONFIRMED 2026-09-03 · TBD-LOCO-004] วางคลิป Rt ที่ค่าบวกและ Lt ที่ค่าลบ ใช้ตระกูล FwdLt/FwdRt_90 เป็น side-loop baseline สำหรับ Crouch; เก็บตระกูล BwdLt/BwdRt_90 ไว้เปรียบเทียบภายหลัง หาก Preview กลับด้านให้แก้ sample/asset mapping ที่ผิด ห้าม negate Direction เป็นจุด ๆ

ใส่ Sync Markers ให้ sample ที่ใช้งานจริง

1. เปิดเฉพาะ Animation Sequence ที่ถูกวางเป็น sample ใน BS_Crouch_Locomotion_2D
2. ใส่ LeftPlant และ RightPlant ตามหลักใน ข้อ 8 โดยดู foot contact ของคลิป Crouch แต่ละตัว ห้ามคัดลอกเวลา marker จาก Standing
3. Preview การ blend ระหว่างหน้า → เฉียง → ข้าง → เฉียงหลัง → หลัง และย้อนกลับ ถ้าเข่าหรือเท้ากระโดด ให้แก้ marker ของคู่ที่มีปัญหาก่อน
4. ยังไม่ต้องใส่ Crouch Start/Stop ใน Sync Group จน base flow เล่นถูกต้อง; เริ่มจาก Blend Space Player ใน State Moving เท่านั้น

13.3 สร้าง SM_Crouch

โครงภายในใช้หลักเดียวกับ SM_Standing เพื่อให้ debug ง่าย ความต่างอยู่ที่ pose และ Blend Space ที่เลือก

1. เปิด ABP_Player → AnimGraph → SM_Posture สร้าง State ชื่อ Crouching แล้วเปิด State Graph ของมัน
2. เพิ่ม State Machine ชื่อเสนอ SM_Crouch ต่อ output เข้า State Result
3. ภายใน SM_Crouch สร้าง Idle, Start, Moving และ Stop แล้วต่อ Entry → Idle → Start → Moving → Stop → Idle
4. เปิด Idle ใส่ A_INP_Crouch_Idle และเปิด Loop Animation
5. เปิด Start ใส่ A_INP_CrouchFwd_Start เป็น fallback รอบแรก ปิด Loop และเปิด Always Reset on Entry
6. เปิด Moving ใส่ Blend Space Player ของ BS_Crouch_Locomotion_2D ต่อ Direction และ GroundSpeed เข้าพินที่ตรงกัน
7. เลือก Blend Space Player ใน Moving ตั้ง Method = Sync Group, Group Name = GroundedLocomotion และ Group Role = Can Be Leader ให้ตรงกับข้อ 9.3
8. เปิด Stop ใส่ A_INP_CrouchFwd_Stop_LU เป็น fallback รอบแรกและปิด Loop หลัง base flow ผ่านแล้วจึงเพิ่มการเลือก _LU/_RU จาก FootPhase
9. สร้าง Transition Rules ชุดเดียวกับ ข้อ 9.4 รวมทางหนี Moving → Idle, Start → Stop, Start → Idle และ Stop → Start ไม่ใช่สร้างเฉพาะลูกศรหลักสี่เส้น
10. เพิ่มเงื่อนไข Stance == Crouched และ NOT bIsFalling ในทางเข้า Start ที่ต้องป้องกันการทำงานผิด posture หากค่า Stance เปลี่ยนระหว่าง Start/Stop ให้ outer SM_Posture เป็นผู้ตัดออกจาก Crouching
11. Compile และ Save จากนั้นเปิด Debug Filter ตรวจว่า SM_Crouch วิ่ง Idle → Start → Moving → Stop → Idle ได้ขณะตัวละครอยู่ใน Crouch ก่อนเพิ่ม directional Start/Stop/Pivot

13.4 ต่อ Standing ↔ Crouching ใน SM_Posture

คลิป Idle2CrouchIdle และ CrouchIdle2Idle เป็น one-shot จึงควรอยู่ใน State ของตัวเอง ไม่ควรใส่ใน Transition Rule Graph ซึ่งมีหน้าที่ตัดสิน Boolean และ blend pose เท่านั้น

ทางเปลี่ยน posture ขณะหยุด

1. ใน SM_Posture สร้าง State StandToCrouch ใส่ A_INP_Idle2CrouchIdle, ปิด Loop และเปิด Always Reset on Entry
2. สร้าง State CrouchToStand ใส่ A_INP_CrouchIdle2Idle, ปิด Loop และเปิด Always Reset on Entry
3. สร้าง Standing → StandToCrouch ด้วยกฎ Stance == Crouched AND GroundSpeed <= MovementSpeedDeadZone
4. สร้าง StandToCrouch → Crouching ด้วย Automatic Rule Based on Sequence Player in State
5. สร้าง Crouching → CrouchToStand ด้วยกฎ Stance == Standing AND GroundSpeed <= MovementSpeedDeadZone
6. สร้าง CrouchToStand → Standing ด้วย Automatic Rule Based on Sequence Player in State
7. เพิ่มทางยกเลิก: StandToCrouch → CrouchToStand เมื่อ Stance == Standing และ CrouchToStand → StandToCrouch เมื่อ Stance == Crouched จากนั้นตั้ง Priority ให้ทางยกเลิกมาก่อนทางจบอัตโนมัติ

ทางเปลี่ยน posture ขณะกำลังเคลื่อนที่

คลิป idle-to-idle ไม่เหมาะกับตัวละครที่ capsule ยังเคลื่อนที่ ให้ใช้ direct transition ที่ blend จาก moving pose เดิมไป moving pose ของ posture ใหม่:

Standing → Crouching
Stance == Crouched AND GroundSpeed > MovementSpeedDeadZone

Crouching → Standing
Stance == Standing AND GroundSpeed > MovementSpeedDeadZone

1. สร้างลูกศรตรง Standing → Crouching และ Crouching → Standing เพิ่มจากเส้น idle one-shot โดยใช้กฎด้านบน กฎที่ใช้ <= และ > แยกกันทำให้สองทางไม่แข่งขันในเฟรมเดียวกัน
2. [CONFIRMED BASELINE 2026-09-03] ใช้ Crossfade Duration 0.12 s สำหรับ direct moving posture transition ทั้งสองทิศ แล้วทดสอบภาพจริงก่อนปรับ การเปลี่ยนค่าภายหลังต้องบันทึกเป็น posture-transition tuning แยกจาก Baseline v0.1 ของ Pivot/MovingTurn/Spin
3. เมื่อเข้าถึง Crouching ขณะยังมี input ให้ outer state ส่ง pose เข้า SM_Crouch; ถ้า nested machine เริ่มที่ Idle แล้วเห็น crouch idle แวบหนึ่ง ให้ใช้ transition initialization/entry behavior ที่ทดสอบแล้วเพื่อพา Idle → Start/Moving โดยไม่ invent ค่าเวลาใหม่
4. อย่าใช้ Anim Notify สลับ collision capsule ฝั่ง Animation ระบบ Character Movement เป็น source of truth ของการ Crouch/UnCrouch และเป็นผู้ตรวจเพดานต่ำ

13.5 Prone — runtime พร้อมแล้ว ให้ต่อ Blend Space และ SM_Prone

ตรวจพบ Prone locomotion 24 assets ในกลุ่ม Start, Loop และ Stop พร้อม Prone Idle/transition assets ในกลุ่ม Idle มติ TBD-LOCO-009 อนุมัติ runtime architecture แล้ว และ native implementation เมื่อ 2026-09-04 มีดังนี้:

• ใช้ stance enum contract ชื่อ E_LocomotionStance { Standing, Crouched, Prone } และให้ ULambeerLocomotionComponent เป็นเจ้าของ replicated CurrentStance กับ request เปลี่ยน posture; ห้ามใช้ Boolean หลายตัวเป็น gameplay source of truth โดยรายละเอียด native representation ตอน implement Prone ต้องรักษาชื่อ/ค่าของ contract นี้
• ACharacter::bIsCrouched คงเป็นผลยืนยันทางกายภาพของ native Character Movement สำหรับ Crouch ส่วน CurrentStance ต้อง publish เฉพาะ committed posture ที่ gameplay/server ยอมรับแล้ว
• ใช้ Input Action ของ Prone แยกจาก Crouch เพื่อให้ request/cancel และ network debug ชัดเจน
• [CONFIRMED 2026-09-03] ปุ่ม Crouch ทำงานแบบ Standing ↔ Crouched; เมื่ออยู่ Prone ให้พยายามขึ้น Crouched หาก clearance ผ่าน
• [CONFIRMED 2026-09-03] ปุ่ม Prone ทำให้ Standing/Crouched ลง Prone ได้โดยตรง; เมื่อกดซ้ำจาก Prone ให้พยายามขึ้น Standing ก่อน หากยืนไม่ได้ให้ fallback เป็น Crouched และหากทั้งสอง clearance ไม่ผ่านให้คง Prone
• ห้ามเข้า Prone กลางอากาศ และ gameplay action gate ต้องอนุญาตก่อนรับ request
• [CONFIRMED 2026-09-03] Prone ใช้ vertical root capsule ขนาดย่อเป็น Updated Component ของ Character Movement และใช้ server-authoritative prone body-envelope sweep ตามแนวนอนครอบคลุมลำตัว ห้ามพึ่ง secondary blocking component ที่ Character Movement ไม่ได้ sweep เป็นหลัก
• server ต้องทำ body-envelope sweep ตอนเข้า Prone, ระหว่างคลาน และตอนออกจาก Prone ก่อน commit capsule/stance; การชนระหว่างคลานต้องหยุดหรือ slide ตามผล sweep โดยไม่ปล่อย mesh ทะลุสิ่งกีดขวาง
• ขนาด root capsule และ body envelope ต้องวัดจาก MetaHuman target กับ extreme pose ของ animation จริง รวม safety margin ที่ผ่าน corridor/low-cover test แล้วจึงบันทึกเป็น runtime config; ห้ามคัดลอก Crouch capsule หรือใส่ค่าประมาณเป็น production default
• หากขอออกจาก Prone ไป Standing แต่พื้นที่ไม่พอยืนและยังพอ Crouch ให้ fallback เป็น Crouched; หากไม่ผ่านทั้งสอง clearance ให้คง Prone โดยไม่เปลี่ยน collision ล่วงหน้า
• [CONFIRMED 2026-09-03] Prone มี gait เดียวและใช้เพดานความเร็วเดียวกันทุกทิศ อนาล็อกปรับได้ตั้งแต่หยุดถึง ProneSpeed; ไม่มี Prone Walk/Jog/Run แยกกัน
• ProneSpeed, ProneMaxAcceleration และ ProneBrakingDeceleration เป็น runtime config ใน locomotion system และใช้ encumbrance multiplier เดียวกับ stance อื่น ค่า production ต้อง derive จาก Prone Start/Loop/Stop ที่วัดจริงและติดตามใน TBD-LOCO-003 ห้ามคัดลอก CrouchSpeed มาใช้
• [CONFIRMED 2026-09-03] เมื่อกด Sprint ขณะ Prone ให้ส่ง request ออกจาก Prone ไป Standing ทันทีโดยไม่ queue; server ตรวจ Standing clearance ก่อน commit หากผ่านให้รักษา Sprint-held intent และเลือก Run หลัง CurrentStance == Standing หาก clearance ไม่ผ่านให้คง Prone และไม่เริ่ม Sprint
• ทาง Sprint-to-Stand เป็น gameplay transition เร่งด่วน: ABP ต้องออกจาก Prone ด้วย direct short blend และไม่บังคับรอ one-shot A_INP_ProneIdle2Idle จบก่อน capsule/ความเร็วเปลี่ยน
• [CONFIRMED 2026-09-03] เมื่อกด Jump ขณะ Prone ให้ consume input ครั้งนั้นเป็น request ไป Standing เท่านั้น ไม่เรียก Jump() ต่อใน input เดียวกัน; หาก server ยืนยัน Standing clearance ให้ลุกด้วย direct short blend หากไม่ผ่านให้คง Prone ผู้เล่นต้องปล่อยและกด Jump ใหม่หลังยืนแล้วจึงกระโดด
• [CONFIRMED 2026-09-03] Autonomous proxy ตรวจ clearance ในเครื่องและเริ่ม predicted stance/collision/animation ทันที จากนั้นส่ง request พร้อม sequence ID ให้ server ตรวจซ้ำ; server ยังคงเป็นเจ้าของ collision และ committed CurrentStance ขั้นสุดท้าย
• เมื่อ server ยืนยัน request ให้ client ปิด pending prediction ด้วย sequence ID ที่ตรงกัน; หากปฏิเสธหรือ authoritative state ไม่ตรง ให้ rollback stance/collision ไปค่าของ server และใช้ inertial blend สั้นเพื่อลด pose pop โดยห้าม blend หรือคาดเดา collision authority
• Simulated proxy ไม่ทำ stance prediction และอ่าน replicated CurrentStance เท่านั้น Sprint/Jump-to-Stand ใช้ prediction contract เดียวกัน แต่ Jump input แรกยังถูก consume และไม่เรียก Jump()
• [CONFIRMED 2026-09-03] Interrupted-recovery priority คือ Death/Ragdoll/Knockdown → Airborne → Posture transition; pending request ที่ยังไม่ commit ต้องถูกยกเลิกและคืน stance/collision ล่าสุดของ server
• ถ้า server commit stance แล้วแต่ animation ถูกตัด ให้คง authoritative stance/collision และ inertial blend ไป pose ที่ถูกต้อง; response ของ sequence ID เก่าต้องถูกทิ้ง และ collision ห้ามเปลี่ยนจาก Anim Notify หรือเวลาในคลิป
• เมื่อตกขอบขณะ Prone ให้ Airborne pose/movement override โดยคง CurrentStance = Prone; ตอนลงพื้น server ตรวจ body envelope ใหม่ก่อนคืน Prone locomotion หากไม่ผ่านให้หยุด movement และแก้ penetration โดยไม่บังคับขยาย capsule เป็น Crouched/Standing ในพื้นที่แคบ
• Damage reaction ที่ไม่ใช่ knockdown เล่น additive/upper-body โดยไม่เปลี่ยน stance; Knockdown/Ragdoll เป็นเจ้าของ pose/collision ชั่วคราว และตอนฟื้นต้อง request stance ใหม่ผ่าน clearance contract เดิม

Prone action gate [CONFIRMED 2026-09-03]

ทุก gameplay action ต้องประกาศ stance policy แบบ data-driven เป็น Allowed, RequiresStanding หรือ Blocked และ server ตรวจ policy เดียวกัน ห้ามให้ ABP เป็นผู้อนุญาต gameplay action

Interrupted recovery [CONFIRMED 2026-09-03]

คลิป Prone ที่ใช้รอบแรกอยู่ที่ /Game/Lambeer/Characters/Player/Animation/Idle และ .../Animation/Prone แล้ว (ยืนยันจากไฟล์บนดิสก์เมื่อ 2026-09-04) ยังไม่ต่อ A_INP_Prone_Idle_Break_01/02 จนกว่า Idle Break ของข้อ 12 พร้อม

สร้าง BS_Prone_Locomotion_2D

1. สร้าง /Game/Lambeer/Characters/Player/Animation/BS_Prone_Locomotion_2D สำหรับ Skeleton เดียวกับ ABP_Player
2. ตั้งแกนนอน Direction = -180..180 แบบ Wrap Input และแกนตั้ง GroundSpeed = 0..80; ใช้ 80 cm/s เป็น sample Y ตาม runtime verification ProneSpeed ห้ามคัดลอก 110 ของ Crouch
3. สร้าง moving row หนึ่งแถวที่ 80 cm/s จาก Loop 8 ทิศ; ไม่ใส่ Idle, Start, Stop, Turn หรือ Idle Break ลงใน Blend Space
4. วาง sample ตามตารางด้านล่าง โดยเริ่มจาก Forward, Backward และรอยต่อ -180/180 ก่อน จากนั้นค่อยเติมทิศเฉียงและด้านข้าง
5. ต่อ sample Backward ตัวเดียวกันไว้ทั้ง -180 และ 180 เพื่อปิด seam ด้านหลัง แล้วลาก Preview ข้าม seam ช้า ๆ
6. วางคลิป Rt ที่ค่าบวกและ Lt ที่ค่าลบ ตาม TBD-LOCO-004 หาก Preview กลับด้านให้แก้ sample mapping ห้าม negate Direction
7. ใส่ LeftPlant และ RightPlant บน Loop ทั้ง 8 ตัวตามข้อ 8 โดยดู foot/hand contact ของคลิป Prone ห้ามคัดลอกเวลา marker จาก Crouch

สร้าง SM_Prone ใน ABP_Player → SM_Posture

ทำหลังมี BS_Prone_Locomotion_2D และหลัง Live Coding/compile C++ จน inherited Stance กับ bUrgentStandFromProne ปรากฏใน ABP_Player ใช้โครงเดียวกับ SM_Crouch ความต่างอยู่ที่คลิป, Blend Space และค่า enum Prone

SM_Posture
└─ Prone          ← State ใหม่ในหน้า SM_Posture (ยังไม่ต่อจาก Entry)
   └─ SM_Prone
      ├─ Entry → Idle
      ├─ Idle → Start
      ├─ Start → Moving
      ├─ Moving → Stop
      └─ Stop → Idle

ทางหนีใน SM_Prone (สร้างครบเหมือนข้อ 9.4):
Start → Stop, Start → Idle, Moving → Idle, Stop → Start

สร้าง State Prone และ nested SM_Prone

1. เปิด /Game/Lambeer/Characters/Player/Animation/ABP_Player แล้ว Compile ให้ผ่านก่อนเพิ่ม State เพื่อแยก error เดิม
2. ไปที่ AnimGraph ดับเบิลคลิก SM_Posture ต้องเห็น Standing, Crouching และ one-shot Crouch ที่ทำในข้อ 13.3–13.4 แล้ว
3. คลิกขวาพื้นที่ว่างใน SM_Posture เลือก Add State ตั้งชื่อ Prone ให้สะกดตรงนี้ อย่าลากเส้นจาก Entry มาที่ Prone เพราะ Entry ยังต้องชี้ Standing
4. ดับเบิลคลิก State Prone เพื่อเปิด State Graph ของมัน
5. คลิกขวาพื้นที่ว่าง เพิ่ม State Machine ตั้งชื่อเสนอ SM_Prone แล้วลากพิน pose ของ node นี้เข้า State Result
6. ดับเบิลคลิก node SM_Prone สร้าง States ชื่อ Idle, Start, Moving และ Stop ให้สะกดตรงกับ SM_Crouch
7. ลากจาก Entry ไป Idle จากนั้นลากลูกศรหลัก Idle → Start → Moving → Stop → Idle
8. ลากทางหนีเพิ่มอีกสี่เส้นทันที: Moving → Idle, Start → Stop, Start → Idle, Stop → Start ห้ามมีแค่ลูกศรหลักสี่เส้น
9. Compile ตอนนี้ compiler อาจเตือนว่า State ยังไม่มี pose นั่นปกติจนกว่าจะใส่คลิปด้านล่าง

Idle — คลิปนอนรอ

1. ใน SM_Prone ดับเบิลคลิก State Idle
2. ลาก /Game/Lambeer/Characters/Player/Animation/Idle/A_INP_Prone_Idle จาก Content Browser มาวาง จะได้ Sequence Player
3. ต่อ output pose เข้า State Result
4. เลือก Sequence Player เปิด Loop Animation เพราะ Idle ต้องวน

Start — คลิปเริ่มคลานหน้าเป็น fallback รอบแรก

1. กลับ SM_Prone แล้วดับเบิลคลิก State Start
2. ลาก /Game/Lambeer/Characters/Player/Animation/Prone/A_INP_ProneFwd_Start มาวางและต่อเข้า State Result
3. เลือก Sequence Player แล้วปิด Loop Animation
4. กลับหน้า SM_Prone คลิก State Start (ไม่ใช่คลิปในกราฟ) เปิด Always Reset on Entry ใน Details หากตัวเลือกนี้แสดงอยู่
5. รอบนี้ยังไม่เลือกทิศอื่นใน Start; directional Start เป็นงานหลัง base flow ผ่าน

Moving — Blend Space คลาน

1. ดับเบิลคลิก State Moving
2. ลาก /Game/Lambeer/Characters/Player/Animation/BS_Prone_Locomotion_2D มาวางเป็น Blend Space Player แล้วต่อเข้า State Result
3. คลิกขวาพื้นที่ว่าง เลือก Get Direction ต่อเข้าพินแกนนอนชื่อ Direction ของ node
4. Get GroundSpeed ต่อเข้าพินแกนตั้งชื่อ GroundSpeed หากชื่อพินไม่ตรง ให้เปิด Details ของ Blend Space ตรวจชื่อแกน ห้ามสลับแกน
5. เลือก Blend Space Player เปิดหมวด Sync: เปลี่ยน Method จาก Do Not Sync เป็น Sync Group ก่อน แล้วตั้ง Group Name = GroundedLocomotion และ Group Role = Can Be Leader ให้ตรงข้อ 9.3
6. ถ้า compiler ขึ้น “set to not use named sync groups” แปลว่าใส่ชื่อกลุ่มแล้วยังไม่ได้เปลี่ยน Method ให้แก้ที่ node เดิม ไม่ต้องสร้าง Player ใหม่

Stop — คลิปหยุดคลานหน้า

1. ดับเบิลคลิก State Stop
2. ลาก /Game/Lambeer/Characters/Player/Animation/Prone/A_INP_ProneFwd_Stop มาวางและต่อเข้า State Result
3. ปิด Loop Animation บน Sequence Player
4. กลับหน้า SM_Prone คลิก State Stop เปิด Always Reset on Entry หากมีใน Details
5. ชุด Prone ไม่มี suffix _LU/_RU บน Stop จึงไม่ต้อง Select จาก FootPhase ในรอบนี้

Transition Rules ภายใน SM_Prone ทีละเส้น

ดับเบิลคลิกวงกลมบนลูกศรเพื่อเปิด Rule Graph แล้วต่อ Boolean เข้า Can Enter Transition ใช้ Get ตัวแปรเดิม ห้ามเปิด Bidirectional แทนลูกศรขากลับ ค่า Priority Order ที่เลขน้อยกว่าถูกพิจารณาก่อน ตามข้อ 9.4

Idle → Start

bHasMovementInput
AND NOT bIsFalling
AND Stance == Prone

1. ดับเบิลคลิกวงกลมบนลูกศร Idle → Start
2. Get bHasMovementInput ต่อเข้า Boolean AND
3. Get bIsFalling ผ่าน Boolean NOT แล้วต่อเข้า AND
4. Get Stance ต่อ Equal (Enum) เลือก Prone แล้วต่อผลเข้า AND ห้ามใช้ค่า Crouched จาก SM_Crouch คัดลอกมาแล้วลืมเปลี่ยน
5. ต่อผล AND เข้า Can Enter Transition

Start → Moving

1. คลิกวงกลมบนลูกศร Start → Moving ครั้งเดียวให้ Details ของ transition ขึ้น
2. เปิด Automatic Rule Based on Sequence Player in State
3. คง Automatic Rule Trigger Time เป็นค่าติดลบ/default ในรอบแรก ให้อิง Crossfade Duration

Moving → Stop

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone

1. ดับเบิลคลิกวงกลม Moving → Stop
2. NOT ของ bHasMovementInput, NOT ของ bIsFalling และ Float > ระหว่าง GroundSpeed กับ MovementSpeedDeadZone
3. รวมด้วย AND เข้า Result

Stop → Idle

1. คลิกวงกลม Stop → Idle เปิด Automatic Rule Based on Sequence Player in State
2. คง Trigger Time เป็น default รอบแรก

Moving → Idle

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed <= MovementSpeedDeadZone

1. เปิด Rule ของลูกศร Moving → Idle ที่ลากไว้แล้ว
2. สร้างกราฟแบบ Moving → Stop แต่เปลี่ยนตัวเปรียบเทียบเป็น <=

Start → Stop

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed > MovementSpeedDeadZone

1. เปิด Rule ของ Start → Stop ให้เหมือน Moving → Stop
2. ตั้ง Priority Order ให้พิจารณาก่อน Start → Moving

Start → Idle

NOT bHasMovementInput
AND NOT bIsFalling
AND GroundSpeed <= MovementSpeedDeadZone

1. เปิด Rule ของ Start → Idle ให้เหมือน Moving → Idle
2. ตั้ง Priority ให้พิจารณาก่อน Start → Moving เส้นนี้ไม่ชนกับ Start → Stop เพราะใช้ <= คนละเส้นกับ >

Stop → Start

bHasMovementInput
AND NOT bIsFalling
AND Stance == Prone

1. เปิด Rule ของ Stop → Start ให้เหมือน Idle → Start รวม Equal Enum เป็น Prone
2. ตั้ง Priority ให้พิจารณาก่อน Automatic Stop → Idle

1. กลับ State Graph ของ Prone ยืนยันว่า SM_Prone ต่อถึง State Result
2. Compile และ Save ก่อนเริ่มลากลูกศรในหน้า SM_Posture

ต่อ Standing/Crouching ↔ Prone ในหน้า SM_Posture

คลิป idle-to-idle เป็น one-shot จึงอยู่ใน State ของตัวเอง Transition Rule Graph มีหน้าที่ส่ง Boolean เท่านั้น ห้ามวาง Sequence Player ใน Rule Graph Sprint/Jump-to-Stand ต้องออกจาก Prone ด้วยลูกศรตรงที่อ่าน bUrgentStandFromProne ห้ามเข้า ProneToStand

สร้าง State one-shot สี่ตัว

คลิปอยู่ที่ /Game/Lambeer/Characters/Player/Animation/Idle/ สำหรับทุกชื่อด้านล่าง

1. ในหน้า SM_Posture Add State ชื่อ StandToProne ดับเบิลคลิก ลาก A_INP_Idle2ProneIdle ต่อเข้า State Result ปิด Loop บน Sequence Player แล้วคลิก State ในหน้าเครื่องตั้ง เปิด Always Reset on Entry
2. สร้าง CrouchToProne ใส่ A_INP_CrouchIdle2ProneIdle ปิด Loop เปิด Always Reset on Entry
3. สร้าง ProneToStand ใส่ A_INP_ProneIdle2Idle ปิด Loop เปิด Always Reset on Entry
4. สร้าง ProneToCrouch ใส่ A_INP_ProneIdle2CrouchIdle ปิด Loop เปิด Always Reset on Entry
5. Compile ยืนยันว่าทั้งสี่ State มี pose ถึง Result และไม่มีคลิปที่ Loop ค้าง

ลูกศร idle — เข้า Prone ตอนหยุด

Standing → StandToProne

Stance == Prone
AND GroundSpeed <= MovementSpeedDeadZone

1. ลากจากขอบ Standing ไป StandToProne ลูกศรต้องชี้ทางเดียว
2. ดับเบิลคลิกวงกลม Get Stance Equal Enum เป็น Prone
3. Get GroundSpeed กับ MovementSpeedDeadZone เข้า Float <=
4. AND ทั้งสองเข้า Can Enter Transition

Crouching → CrouchToProne

Stance == Prone
AND GroundSpeed <= MovementSpeedDeadZone

1. ลาก Crouching → CrouchToProne แล้วสร้าง Rule แบบเดียวกับเส้น Standing แต่ต้นทางเป็น Crouching

StandToProne → Prone และ CrouchToProne → Prone

1. ลาก StandToProne → Prone คลิกวงกลม เปิด Automatic Rule Based on Sequence Player in State คง Trigger Time เป็น default
2. ลาก CrouchToProne → Prone แล้วเปิด Automatic Rule แบบเดียวกัน

ลูกศร idle — ออกจาก Prone ตอนหยุด (ไม่ใช่ Sprint/Jump)

Prone → ProneToStand

Stance == Standing
AND GroundSpeed <= MovementSpeedDeadZone
AND NOT bUrgentStandFromProne

1. ลาก Prone → ProneToStand
2. Equal Enum Stance == Standing, Float GroundSpeed <= MovementSpeedDeadZone, Get inherited bUrgentStandFromProne ผ่าน Boolean NOT
3. AND ทั้งสามเข้า Result การใส่ NOT ทำให้ Sprint/Jump ไม่ไหลเข้า one-shot นี้

Prone → ProneToCrouch

Stance == Crouched
AND GroundSpeed <= MovementSpeedDeadZone
AND NOT bUrgentStandFromProne

1. ลาก Prone → ProneToCrouch แล้วสร้าง Rule แบบเส้น Stand แต่ Equal เป็น Crouched
2. เส้นนี้ใช้ตอนปุ่ม Crouch จาก Prone หรือตอน Prone key fallback เป็น Crouched ขณะหยุด

ProneToStand → Standing และ ProneToCrouch → Crouching

1. ลาก ProneToStand → Standing เปิด Automatic Rule Based on Sequence Player in State
2. ลาก ProneToCrouch → Crouching เปิด Automatic Rule เช่นกัน

ทางยกเลิก one-shot เมื่อ Stance กลับด้านก่อนคลิปจบ

ลากลูกศรข้ามระหว่าง one-shot ตามตาราง แล้วตั้ง Priority Order ของทางยกเลิกให้พิจารณาก่อน Automatic Rule ที่รอคลิปจบ

1. แต่ละเส้นเปิด Rule Graph แล้ว Equal Enum ตามคอลัมน์ Rule ต่อเข้า Result โดยตรง ไม่ต้องใส่ GroundSpeed ในทางยกเลิกเหล่านี้
2. อย่าเปิด Bidirectional บนลูกศร idle หลัก

ลูกศรตรงขณะเคลื่อนที่ และ Sprint/Jump-to-Stand

คลิป idle-to-idle ไม่เหมาะตอน capsule ยังไหล และห้ามใช้ตอน urgent stand สร้างลูกศรตรงแยกจาก one-shot กฎ <= กับ > ทำให้ idle กับ moving ไม่แข่งขันในเฟรมเดียวกัน

Standing → Prone

Stance == Prone
AND GroundSpeed > MovementSpeedDeadZone

1. ลากลูกศรตรง Standing → Prone คนละเส้นกับ Standing → StandToProne
2. Equal Enum Prone AND Float GroundSpeed > MovementSpeedDeadZone
3. คลิกวงกลมใน Details ตั้ง Duration / Crossfade Duration เป็น 0.12 ตาม baseline ข้อ 13.4 ที่อนุมัติแล้วสำหรับ moving posture

Crouching → Prone

Stance == Prone
AND GroundSpeed > MovementSpeedDeadZone

1. ลาก Crouching → Prone แยกจาก Crouching → CrouchToProne ใช้ Rule และ Crossfade 0.12 s แบบเดียวกัน

Prone → Standing

Stance == Standing
AND (GroundSpeed > MovementSpeedDeadZone OR bUrgentStandFromProne)

1. ลากลูกศรตรง Prone → Standing คนละเส้นกับ Prone → ProneToStand
2. Get Stance Equal Standing
3. สร้าง Float GroundSpeed > MovementSpeedDeadZone
4. Get bUrgentStandFromProne (inherited, ไม่ Set)
5. Boolean OR ระหว่างเงื่อนไขความเร็วกับ bUrgentStandFromProne จากนั้น AND กับ Equal Stance เข้า Result
6. ตั้ง Crossfade Duration 0.12 s
7. ตั้ง Priority Order ของเส้นนี้ให้พิจารณาก่อน Prone → ProneToStand หากไม่ทำ Sprint/Jump จะไหลเข้า one-shot แล้ว capsule ลุกก่อน pose

Prone → Crouching

Stance == Crouched
AND (GroundSpeed > MovementSpeedDeadZone OR bUrgentStandFromProne)

1. ลากลูกศรตรง Prone → Crouching แยกจาก Prone → ProneToCrouch
2. สร้าง Rule แบบเส้น Standing แต่ Equal เป็น Crouched รวม OR กับ bUrgentStandFromProne เพราะ Jump/Sprint ที่ fallback เป็น Crouch ต้องตัด one-shot เช่นกัน
3. Crossfade 0.12 s และ Priority ก่อน Prone → ProneToCrouch

1. เมื่อเข้า Prone ขณะยังมี input nested SM_Prone เริ่มที่ Idle ตาม Entry หากเห็น prone idle แวบหนึ่งแล้วค่อยไป Start ให้ใช้วิธี entry/initialization เดียวกับที่ทดสอบแล้วใน SM_Crouch ข้อ 13.4 ห้าม invent เวลา blend ใหม่
2. อย่าใส่ Anim Notify เพื่อสลับ capsule; locomotion component เป็นเจ้าของ collision

สรุปลูกศรใน SM_Posture ที่เกี่ยวกับ Prone

Compile, Save และจุดตรวจก่อน PIE

1. Compile ABP_Player แก้ error เรื่อง Result ว่าง, Enum ผิดชนิด หรือ Sync Group ก่อน Save
2. Save asset
3. ใน My Blueprint ตรวจว่า bUrgentStandFromProne เป็น inherited ไม่ใช่ตัวแปรที่สร้างเอง
4. Hover วงกลมลูกศรทุกเส้นใน SM_Posture และ SM_Prone ยืนยันว่า Result ถูกต่อและ preview expression ตรงตาราง
5. ยังไม่ต่อ Idle Break, directional Start/Stop หรือ Crouch Pivot ในรอบนี้

13.6 ทดสอบใน PIE

เลือก player instance ใน Debug Filter แล้วเปิดทั้ง SM_Posture, SM_Crouch และ SM_Prone สลับดูระหว่างทดสอบ Watch อย่างน้อย Stance, GroundSpeed, Direction, bHasMovementInput, bIsFalling และ bUrgentStandFromProne; ใช้ Character Movement → Is Crouching เมื่อต้องวินิจฉัย Crouch

Prone acceptance tests หลังต่อ SM_Prone

ปุ่ม Prone runtime เริ่มต้นคือ Z (IA_Prone) หรือ console Lambeer.Prone ระหว่างทดสอบให้ดู Debug Filter ว่า active state ใน SM_Posture ตรงคอลัมน์ผล และ bUrgentStandFromProne เป็น true เฉพาะตอน Sprint/Jump-to-Stand

13.7 แก้ปัญหาจากอาการที่เห็น

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, skeleton/IK bones, retarget/rig และ runtime configuration ติดตามแยกใน TBD-LOCO-010 จนถึงขั้น implementation

16. Multiplayer และ Persistence

• ตำแหน่งจริงและ movement mode ยังคง authoritative ผ่าน replicated UCharacterMovementComponent
• ALambeerCharacter reset MovementInputMagnitude เมื่อ Move Action เกิด Completed หรือ Canceled เพื่อสร้างขอบสัญญาณ true → false ที่แน่นอนบนเจ้าของ
• ULambeerAnimInstance ใช้ HasMovementInputForAnimation() ตรวจ JustReleased; simulated proxy อ่านค่าที่ server replicate แล้วเลือก Stop ในเครื่องจาก replicated velocity และ transition state ที่มีอยู่ ห้าม multicast การเล่น animation
• Loop pose, direction และ local transition selection ควรคำนวณจาก replicated velocity/state บนแต่ละ proxy โดยไม่สมมติว่า acceleration ของ simulated proxy เชื่อถือได้
• เมื่อ runtime เปลี่ยน mesh offset จาก capsule ตาม stance ต้องเรียก ACharacter::CacheInitialMeshOffset() หลัง SetRelativeLocation() เพื่ออัปเดตเป้าหมาย network smoothing ของ simulated proxy; การตั้ง relative location อย่างเดียวอาจถูก smoothing เขียนทับ
• อย่า replicate animation time ทุกเฟรม
• replicate เฉพาะ gameplay state ที่อนุมานไม่ได้อย่างเสถียร เช่น stance, aim mode หรือ movement intent ที่จำเป็นต่อ transition edge
• locomotion pose ไม่มีข้อมูลที่ต้อง persist ลง save game
• Dedicated Server PIE แบบ 2 clients ผ่าน smoke test ของ Stop แล้ว; ยังต้องทดสอบ Listen Server, simulated latency, packet loss และ Stop ทุกทิศ/foot phase ก่อนอนุมัติ multiplayer gate เต็มรูปแบบ

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
• [CONFIRMED 2026-09-02] Idle, Start, Stop, Pivot, MovingTurn และ Spin เป็น State แยกใน SM_Standing
• [PROPOSED] ไม่อนุญาต Run ใน backward hemisphere เมื่อไม่มี animation coverage
• [CONFIRMED] HipRelaxed ใช้ VelocityDirection; ShoulderAim/ADS ใช้ LookingDirection และ gameplay เป็นผู้ควบคุม actor rotation ตามข้อ 10.7
• [CONFIRMED · TBD-LOCO-002] _L/_R คือทิศซ้าย/ขวา ส่วน _LU/_RU คือ Left Up/Right Up ของ gait phase ตามข้อ 10.7
• [CONFIRMED · TBD-LOCO-006] ULambeerLocomotionComponent.CurrentGait เป็น replicated source of truth ของ Walk/Jog/Run; AnimInstance ใช้ Gait == Run แทน bIsSprinting
• [CONFIRMED 2026-09-01 · TBD-LOCO-001] ใช้ Manny SKM_Manny_Simple เป็น source, MetaHuman SKM_MHC_Man_BodyMesh เป็น target และ /Game/MaleLocomotionSet/Animations/Mannequin/RTG_AutoGenerated เป็น IK Retargeter
• [PARTIALLY CONFIRMED 2026-09-03 · TBD-LOCO-003] Forward Loop วัดจาก Root Motion ได้ Walk ≈164, Jog ≈442 และ Run ≈660 cm/s; runtime/Standing Blend Space ใช้ 165/442/600 และ Jog braking 260 จาก Stop-distance ratio; Crouch Blend Space ใช้ provisional baseline 110 cm/s ตาม runtime CrouchSpeed ที่อนุมัติแล้ว ส่วน authored speed ของทิศอื่นยังต้องวัด
• [CONFIRMED 2026-09-03 · TBD-LOCO-004] signed Direction ใช้ค่าบวก = ขวาและค่าลบ = ซ้าย; side-loop baseline ใช้ตระกูล FwdLt/FwdRt_90 ทุก gait/stance ที่มี coverage และเก็บตระกูล backward-side ไว้เปรียบเทียบภายหลัง
• [CONFIRMED BASELINE v0.1 · 2026-09-02 · TBD-LOCO-005] selector กลางอยู่ใน C++, ABP เป็นผู้บริโภค, priority คือ Airborne/Posture → Stop → Spin → Pivot → Moving Turn; Turn/Pivot/Spin enter = 30°/125°/165°, Pivot dot < -0.35, Turn buckets = 67.5°/112.5°/157.5°, hysteresis = 7.5°/10°/10°, cooldown = 0.15/0.25/0.35 s, commit = 10%/15%/20%, blend เข้า/ออก = Turn 0.10/0.12 s, Pivot 0.08/0.12 s, Spin 0.08/0.15 s และ Fast Stop ปิดอยู่; implementation ผ่าน build, ABP compile/save และ PIE startup แต่ visual/behavior กับ multiplayer gate ยังไม่ผ่าน
• [PARTIALLY CONFIRMED · TBD-LOCO-007] Turn in Place ใช้ Mesh/Root-Yaw-Offset, gameplay/server เป็น actor/capsule owner, HipRelaxed ไม่ turn ตามกล้อง และไม่ใช้ Root Motion เป็น baseline; runtime aim-yaw signal, curve/commit, thresholds, residual yaw และ network rebase/correction ยังเป็น TBD
• [PARTIALLY CONFIRMED · TBD-LOCO-008] Idle Break ใช้ gameplay action gate, เริ่มจาก Standing, เลือกด้วย stance-specific shuffle bag แบบไม่ซ้ำติดกัน และ cancel ตาม authoritative state; runtime signal, delay, cooldown และ selection weights ยังเป็น TBD
• [IMPLEMENTED RUNTIME 2026-09-04 · ANIMATION GRAPH COMPLETED BY USER 2026-09-05 · TBD-LOCO-009] Prone ใช้ replicated ELambeerLocomotionStance/CurrentStance, input paths, vertical root capsule + server body-envelope sweep, gait เดียว, Sprint/Jump-to-Stand, bUrgentStandFromProne, data-driven action gate และ recovery hooks ตามข้อ 13.5 แล้ว; คลิป retarget รอบแรกมีแล้วในโฟลเดอร์ผู้เล่น; native mesh-offset และ Prone Moving ผ่านเส้นทางที่ผู้ใช้ทดสอบ โดย Start → Moving ใช้ Automatic Rule baseline เดิม ส่วนค่าขนาด collision กับ ProneSpeed = 80 ยังเป็น verification placeholders จนกว่าจะวัดจาก MetaHuman
• [TBD · TBD-LOCO-010] plugin/IK configuration

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

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

438 assets

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

Retargeted pistol / rifle aim and walk — 2026-09-19

[CONFIRMED] Owner scope: use the supplied pistol and rifle Aim Offsets in ADS and ShoulderAim, including supported, unsupported and dual-pistol contexts in Standing, Crouched and Prone. Standing grounded aim uses the new full-body idle/walk blend; crouch/prone retain their existing lower-body locomotion and use the new content only through held upper-body/arm masks. Melee and unarmed have no new Aim Offset in this delivery and retain their prior presentation.

Source root: /Game/Lambeer/Characters/Player/Animation/Aim/. All pistol AO, samples, idle and walk content now resides in Aim/Pistol/; rifle content resides in Aim/Firearm2H/. Pistol/AO_Pistol uses Pistol/MF_Pistol_Idle_ADS_AO_{CD,CC,CU} and base Pistol/MF_Pistol_Idle_ADS. Firearm2H/AO_Rifle uses Firearm2H/MM_Rifle_Idle_ADS_AO_{CD,CC,CU} and base Firearm2H/MF_Rifle_Idle_ADS. Owner confirmed the two pistol idle assets were duplicates; references were consolidated into the existing Pistol-folder asset, and the unreferenced root duplicate was removed. All six AO samples are Mesh Space additive against frame 0 of their matching base; the two idle bases and sixteen walk clips are non-additive and share the MetaHuman base skeleton. Owner supplied the retargeted assets; no retarget/export was performed by the agent.

Pistol/BS_Pistol_AimWalk and Firearm2H/BS_Rifle_AimWalk use their corresponding MF_{Pistol,Rifle}_Walk_{Fwd,Fwd_Left,Fwd_Right,Left,Right,Bwd,Bwd_Left,Bwd_Right} clips. X is actor-relative movement direction from -180 to +180 degrees with a duplicated backward seam; Y is current planar speed divided by the current movement maximum, clamped to 0–1. Each space has nine idle samples at Y=0 and nine directional walk samples at Y=1. This defines blend coordinates, not a new gameplay speed or calibrated foot-speed claim.

Aim mapping: owner corrected the authored camera/base-aim pitch endpoints to -80 / 0 / +80 degrees, mapped to -1 / 0 / +1 on the existing AO Y axis. This supersedes the earlier approved -90/+90 mapping. Runtime normalizes wrapped pitch, divides by 80 and clamps to [-1, 1]. X remains zero because this delivery contains vertical samples only. Existing AO sample positions are preserved. Both camera modes share the same exact-context Aim entries. FLambeerHeldAnimEntry now exposes AimWalk and AimOffset beside Pose; eighteen pistol and six rifle Aim entries are bound, with Carry entries, masks and context keys preserved.

Evaluation: standing firearm idle/walk selection → Foot IK → each selected held sequence/walk blended with its own Aim Offset → existing UpperBody/right/left mesh-space rotation masks → DefaultSlot → finger poses / component-space controls → ADS alignment → procedural recoil → support IK. The walk players share the P09AimWalk sync group. Native per-layer Aim Offset selection suppresses the old clavicle pitch on those chains so elevation is not applied twice. Non-AO contexts retain the earlier arm-pitch path. Missing/incompatible content clears the new outputs; equipment or aim changes cannot retain a stale offset. Right-hand precedence selects full-body locomotion for dual/mixed pairs.

Existing support-hand targets, item grip transforms, sight alignment scope/settings, procedural recoil, action permissions and input bindings are preserved. Reusing the supplied supported-style clips for unsupported/dual and other stances is owner-approved content reuse; this does not establish a final independent left-pistol posture or visual contact quality. No new authored hand pose, mirror asset, yaw sample or stance-specific retarget is inferred. Presentation is transient and introduces no persistence fields or schema changes.

Initial non-PIE validation (insufficient directional coverage; corrected below): closed-Editor LambeerEditor Win64 Development build passed. MCP compiled ABP_Player with warnings treated as errors and saved the graph/profiles/blend spaces. Six focused automation tests passed with no warnings/errors, including Lambeer.HUD.Content.RetargetedFirearmAim, which evaluates both blend spaces at every direction and idle/half/full speed, plus AO center/endpoints and all authored profile stances. An Editor sample-array assertion occurred during initial rifle authoring; after reopening, the rifle samples were replaced without clearing the array, read back and passed evaluation. Evidence: Saved/P09RetargetedAim/.

Owner report and repair — 2026-09-19: owner confirms looking up/down now works. Cardinal movement remained idle and diagonal movement selected incorrect walk clips; weapon/body/view/network coverage of that report was not specified. A fresh-process regression reproduced the fault: full-speed pistol forward/right returned idle weight 1.0 instead of the expected walk. The earlier test accepted any clip from the same family, so its pass did not establish correct direction selection.

Root cause: sample properties had changed while the serialized runtime triangulation still described the duplicated source Blend Space. UE 5.8 UBlendSpace::PostEditChangeProperty does not rebuild that data by itself; SBlendSpaceEditor::Construct calls ResampleData. Opened both spaces through Unreal MCP's OpenEditorForAsset, rebuilt runtime samples, dirtied and saved each exact asset while restoring its original loop setting. Both use the original approved direction and speed axes; no movement/input tuning was changed.

Regression: Lambeer.HUD.Content.RetargetedFirearmAim now asserts the exact expected directional clip weight and idle weight at every cardinal/diagonal/backward-seam coordinate for idle, half and full speed, rather than merely accepting a family match. It failed with 72 assertions before repair and passed in-editor after resampling. Independent fresh-process on-disk validation passed 1/1 with zero warnings/errors, recorded in Saved/Automation/P09AimWalkAfterRepair; pre-repair evidence is Saved/Automation/P09AimWalkBeforeRepair. Owner visual retest of walking remains required.

Pitch correction and FPP report — 2026-09-19: owner reports elbow distortion when pitching during pistol ADS in FPP; rifle has not been tested. Owner A/B retest: disabling Sight Alignment removes the visible problem; the owner restored Enabled afterward, confirmed true through MCP. This isolates the enabled sight-alignment path as the trigger in this tested case, but does not identify the exact failing transform or IK operation. Affected arm remains unspecified; rifle remains untested. Inspection confirms both IK nodes already disable twist and use incoming lowerarm poles; these flags have not been changed again. The right-hand sight solve runs after AO for the enabled standing/right/supported ADS scope, followed by recoil and left support IK. Owner subsequently confirmed: use the new AO as the main aiming pose, refactor Sight Alignment, and retain sights aligned with the camera. The replacement solver and remaining visual acceptance are documented below. Pitch correction validation: closed-Editor LambeerEditor Win64 Development build succeeded; SightAlignment and RetargetedFirearmAim automation passed 2/2 without warnings/errors after reopening the exact project. The mapping regression covers neutral, half pitch, both authored endpoints, clamping and wrapped remote pitch. The A/B result is owner-reported; no permanent elbow fix or broader PIE acceptance is claimed.

Owner follow-up — 2026-09-19: eye-pivot change improves the motion, but Sight Alignment is correct only over part of downward aim; at other pitches the owner reports the barrel is not parallel to the view in FPP ADS. This is partial improvement, not final acceptance. No further sight/arm tuning has been made from that description. Added Lambeer.SightDump to compare rendered versus solve camera, requested/actual hand orientation, sight-axis error, reach and alignment/recoil state at a good, neutral and bad pitch. Exact item/context and measured fault location await runtime evidence; arm reach alone is not established as the cause of the reported angular error.

Adaptive depth validation — 2026-09-19: closed-Editor LambeerEditor Win64 Development succeeded; ArmAlignment, SightAlignment and AimViewContract passed3/3 without warnings/errors. The added regression sweeps161 rotations with reachable/unreachable preferred depths, checking nearest boundary, permitted depth segment, no lateral/vertical deviation from the sight line, preserved orientation and arm solve reach. It also checks missing intersection, minimum-depth limits and the inner reach boundary. MCP compiled ABP_Player with warnings treated as errors, saved and verified clean, right-only adaptive setting and ADSSightPullback wiring. Evidence: Saved/P09SightReach/adaptive-tests.json and adaptive-wiring.json. Owner retest should repeat good/neutral/bad pitch using SightDump; look for SightLineReachable=1, EffectiveHandErrorCm near zero when settled without recoil, and view-space lateral/vertical offsets limited to existing sway. No owner visual pass is claimed.

Owner-only PIE acceptance remains open: test pistol and rifle in both views at neutral/up/down pitch; walk all eight directions, stop/start, and release aim; compare Standing with Crouched/Prone lower-body preservation; check supported/unsupported/dual and mixed-pair hand policy, grip/wrist/elbow contact and recoil. Repeat on both bodies and Dedicated Server with two client Preview windows (owner and observer). Agent checks do not prove visual/network acceptance; P09 remains Partial.

Shared aim pose and arm evaluation — 2026-09-18

Superseded firearm content/elevation: see the 2026-09-19 retargeted firearm Aim Offset contract. The migration and earlier validation below remain historical evidence; eligibility rules still apply. The arm solver below is superseded by the AO-based sight refactor.

Owner confirmed: ADS and ShoulderAim use one animation. Pose Context no longer contains AimMode; Action contains Carry, Aim and Attack only. Firearm recoil uses NotifyWeaponShot and procedural arm rotation. AimMode still controls camera, movement and gameplay rules.

Six profiles contain 141 unique entries: Pistol 39, Unarmed 3, Melee1H 57, Melee2H 12, Firearm2H 12 and TwoHandedItem 18. Seven identical camera-mode duplicates were merged from the inspected 148 rows. The owner's standing supported pistol clip is A_Aim_Pistol_Supported_Stand. No conflicting clips were chosen, no animation assets were deleted, and all 16 inspected item override arrays were empty. The older 294/147-entry counts below are migration history. Snapshot: Saved/P09AimSimplify/profiles-before.json.

bHasSupportHandTarget replaces bAllowFreeLeftHandSupport. A one-handed firearm uses its authored support target only while aiming and with the left inventory hand empty. Two-handed support remains available during Carry. Inventory handedness is unchanged. Without an enabled target, the selected Pose owns the left arm: UpperBody includes it; RightArm deliberately does not. Supported and unsupported rows remain separate, so edit the row matching the actual support state.

Evaluation order: locomotion → Foot IK → selected UpperBody/right/left overlays → DefaultSlot → right fingers → component space → right/left clavicle aim-pitch rotations → ADS hand IK and wrist orientation → procedural recoil → left support IK → local space → left fingers. Foot IK runs before held overlays so its output cannot replace the chosen upper-body pose. Empty left inventory hands do not receive a separate Carry overlay.

Both views apply camera elevation to the selected aiming arm chains before IK. Pitch is normalized and converted from actor axes into mesh component axes; a mixed-pair left Carry arm is not pitched. This is cosmetic pitch following, not third-person ballistic convergence or scope alignment. ADS sight alignment retains the existing enabled standing/right/supported L1810 scope and authored sight/grip/eye-distance/sway settings.

The former left pole was component origin (0,0,0); the former right pole was a camera-rotated offset derived outside pose evaluation. Both Two Bone IK nodes now use their incoming lowerarm bone as the pole in the current evaluated, pitched pose. The old right elbow offset field and previous-frame socket read are removed. Stretching remains disabled. Both nodes keep bMaintainEffectorRelRot so the wrist retains its incoming local rotation relative to the forearm. MCP 2026-09-19: both nodes now have bAllowTwist=false (TwistAxis remains local X). Engine Two Bone IK otherwise lets FindBetweenNormals roll the forearm at high/low pitch; with twist allowed, Maintain Effector Rel Rot carries that roll into the hand. Disabling twist restores the incoming pose twist after the reach solve. This does not consume SupportHandTarget Rotation. Visual acceptance still requires owner PIE.

Owner report — 2026-09-18: both elbows rotate erratically at high/low pitch in first-person ADS, standing with L1810 and an empty left hand. Third-person gun pitch following was absent and is included in the 2026-09-18 arm-pitch change.

Owner report — 2026-09-19: holding L1810, aiming, left support IK reaches the gun, but looking up/down spins the left hand. That matches the previous AllowTwist path on hand_l. The same flag is now off on the right ADS IK as well because the 2026-09-18 elbow report covered both arms. No owner retest of this change is claimed.

Validation: 2026-09-18 closed-Editor LambeerEditor Win64 Development passed; focused AimViewContract, GripContract, HeldAnimation, ProceduralRecoil and SightAlignment tests passed 5/5 with no warnings/errors. MCP compiled ABP_Player with warnings treated as errors, saved and verified the arm-pitch links, Foot IK order, bone-space elbow poles and clean assets. All six profiles exactly match the preserved content after removing duplicate camera keys; no AimMode/Fire or removed support flag remains in the reflected schema. 2026-09-19 is ABP-only: MCP compiled ABP_Player with warnings treated as errors, saved it (is_dirty false) and read back both Two Bone IK nodes with bAllowTwist=false, bMaintainEffectorRelRot=true, left effector still SupportHandIKBoneLocation in hand_r bone space, right effector still ADSHandLocation in component space. No native rebuild. Owner-only PIE: compare both views at neutral/high/low pitch, aim on/off, support target on/off with the matching UpperBody entry, occupied left hand, recoil, and Dedicated Server owner/observer. Verify the supporting left wrist no longer spins while looking up/down, plus wrist contact, elbow bend and no idle left-arm override. Presentation state is transient; no persistence schema or durable save fields change.

P09 shared Carry / Aim actions — 2026-09-17

Historical shared-action decision: idle and movement used the same held upper-body pose. The 2026-09-19 firearm delivery now adds AimWalk content within the same Aim context, without restoring separate idle/move actions. Context.Action exposes Carry, Aim and Attack. Fire is removed because shots use procedural recoil. CarryIdle/CarryMove migrate to Carry; AimIdle/AimMove migrate to Aim through enum value redirects. Native selection no longer branches on movement speed. Stance, hand topology, family, support eligibility and PresetId remain distinct. AimMode remains gameplay/camera state only. Locomotion movement/gait is unchanged.

Authoring: assign the Animation Sequence to Pose on one Context.Action=Aim row for both ADS and ShoulderAim. Do not duplicate this row for movement. Per-item exceptions remain AnimationOverrides; family defaults remain profile Entries. Existing non-additive/player-skeleton and exact-context rules remain.

Migration complete: owner selected Idle clips for all pairs. Six profiles were reduced from 294 to 147 unique entries: Unarmed 3, TwoHandedItem 18, Firearm2H 12, Melee1H 60, Pistol 42, Melee2H 12. All 16 inspected item definitions had empty AnimationOverrides. Exact property readback matched the intended merge. Nine obsolete Carry *_Move sequences were deleted through Unreal MCP after empty referencer checks and no source/config references. Original property snapshots are stored under Saved/P09ActionMigration/before.json. Do not interpret the earlier 294-entry history as the current target count. The retained *_Idle filenames now serve both idle and movement; no rename is required. The nine removed *_Move files are no longer delivery requirements.

Validation: closed-Editor LambeerEditor Win64 Development succeeded; final headless Lambeer.HUD 27/27 passed with no warnings/errors, including legacy enum redirect checks. Reopened MCP verified PIE=false, profile readback and unique keys; ABP_Player compiled with warnings treated as errors and was saved. HTML validation passed 45/45. The first test run incorrectly expected name lookup to ignore redirects; corrected the test to inspect enum choices separately and assert old-name migration. Owner PIE should compare held pose while starting/stopping movement, remaining stance differences and both aim views. No new durable gameplay state is introduced.

P09 Aim refactor — 2026-09-17

Owner-approved behavior: canonical RMB / weapon / camera matrix. Empty hands explicitly use the same toggle as melee. Switching view retains aim. The weapon follows camera direction without independent free look; first-person visual motion may depart from screen center without locking the camera behind the sight.

Native foundation: remove tap/hold timing and release-driven transitions. IA_Aim Started toggles requested aim. A camera-view change resubmits the same toggle with the new first-person flag. Server derives ShoulderAim/ADS from held-item family, re-evaluates equipment changes and refuses Item-family primary hands. An eligible firearm/melee equipment change reselects mode; an ineligible change clears the toggle. The existing local eye-height camera and FOV interpolation remain. Free-left firearm support eligibility now includes ADS, still requiring an authored target and an empty left hand.

Authoring update — 2026-09-17: the owner supplied SightReference on SKM_L1810 and bound A_ADS_Pistol_Supported_Stand to the shared Pistol profile (Aim, ADS, Standing, RightOnly, Right Firearm/Left Empty, supported). The owner confirmed +X toward the muzzle and +Z up and authorized per-gun experimental alignment/sway settings for this case. Current alignment implementation and calibration. This was the initial 2026-09-17 binding. The 2026-09-18 shared Aim contract supersedes the separate camera-mode key; other stance/topology/support distinctions remain exact.

Movement: the existing ShoulderAim Walk cap remains. This refactor does not introduce a new ADS gait/speed contract. Aim/view are transient and add no save schema fields.

Validation status: closed-Editor LambeerEditor Win64 Development succeeded; headless Lambeer.HUD passed 27/27 with no failed or warning tests (Saved/Automation/P09AimRefactor). Reopened Unreal MCP confirmed PIE=false, IA_Aim=RMB and IA_ToggleCameraView=V with no triggers/modifiers on those mappings; BP_PlayerCharacter references both actions. BP_PlayerCharacter and ABP_Player compiled with warnings treated as errors and were saved. Canonical HTML validation passed 45/45. These checks do not establish owner PIE or network/visual acceptance. Owner-only PIE must verify one press on/next press off, held/released RMB has no extra transition, first/third view changes preserve aim, firearm/melee/unarmed and mixed-hand precedence, ineligible equipment cancellation, throw cancellation, and Dedicated Server + two clients. ADS visual acceptance waits for authored assets.

22. P09 held-item animation design — 2026-09-16

2026-09-17 owner decision: all character recoil will be procedural. Animation Entry now contains Context, Mode, Layer, Pose and Montage only. Historical Fire/_Add sequence names below record 15 deleted placeholders. The arm-recoil event/debug path is implemented with per-item trial settings; owner visual/network acceptance remains open.

Partial implementation; content and owner acceptance pending. The owner requests the case matrix below, Layered Blend Per Bone, item-specific animation overrides, per-item finger Pose Assets, a folder/file plan and an Editor grip-calibration guide, and authorized feasible native/AnimBP implementation. The implementation record below separates completed foundations from proposed action/recoil work. No clips were retargeted, offsets measured, Pose Assets created or PIE started by the agent.

Existing evidence: source contains RightGripRelative, optional left/support transforms and body grip overrides on ULambeerItemDefinition. Live MCP pin inspection on 2026-09-16 confirms the existing Two Bone IK node receives SupportHandIKAlpha/SupportHandIKLocation and reaches Output through Component To Local. The inherited support query was two-handed-only and position-only. The original change enabled ShoulderAim support; the later P09 aim refactor also enables ADS support when the left hand is empty and an authored target exists. It remains position-only. Changing pistol handedness to TwoHanded would incorrectly remove dual-wield eligibility.

Owner movement rule — 2026-09-17: Carry uses the same upper-body pose across Walk/Jog/Run. Gait is removed from held-animation Context, lookup and overrides; lower-body locomotion retains its gait state. ShoulderAim returns Walk before sprint/input gait selection on authority and the owning client, preserving existing crouch/prone speed limits. Toggling aim off restores normal gait selection from current input. The ADS gait policy is unchanged. Build and owner PIE acceptance are tracked in the roadmap.

Validation after schema cleanup — 2026-09-17: closed-Editor native build succeeded; reopened MCP confirms no Gait/Recoil entry fields. Pistol now contains owner-authored standing supported AimIdle (UpperBody) and AimMove (RightArm) rows; the earlier empty-profile diagnosis below is historical. HUD regression passed 26/26 without errors/warnings, including held-animation resolution. The new ShoulderAim movement rule still requires owner PIE verification, including dedicated clients; these tests do not establish visual/network acceptance. Procedural recoil runtime remains pending.

Implemented foundation — 2026-09-16

• ULambeerHeldAnimationProfile and item AnimationProfile/AnimationOverrides: exact-context resolution with body-specific precedence and Replace/Disable/Inherit. Context includes Action, Topology, RightFamily, LeftFamily, Stance, Hand, support eligibility and PresetId. Each stance is authored explicitly; upper-body movement poses are shared across gaits.
• ULambeerAnimInstance resolves continuous carry/aim sequences into UpperBody/RightArm/LeftArm outputs. Missing, additive or wrong-skeleton continuous poses have zero layer weight and set bMissingHeldPose. Empty-handed relaxed locomotion is unchanged. Asset references are hard references loaded with the item/profile, not per-frame loads.
• ABP_Player evaluates Foot IK before held overlays, then arm pitch, ADS IK, recoil and support IK. See the current evaluation order. BranchFilter roots remain spine_01, clavicle_r/l and hand_r/l; UpperBody includes both arms.
• One-handed firearm support uses bHasSupportHandTarget; it requires ShoulderAim or ADS and an empty left inventory hand. It does not change item handedness. L1810 is opted in; no support target or numeric grip was fabricated.
• Six profile assets exist under Profiles/. Crowbar, FireAxe and WoodenMallet reference Melee1H; Sledgehammer references TwoHandedItem; L1810 references Pistol; ABP unarmed defaults reference Unarmed. Melee2H and Firearm2H are available for future item assignment. Their current entries are documented in the shared Aim contract; owner visual acceptance remains pending.
• Live catalog readback: Crowbar/FireAxe/WoodenMallet have bMeleeWeapon=false, so their current context family is Item despite the profile's intended future family name. Sledgehammer has bMeleeWeapon=true but remains hold/throw-only in the approved slice. No catalog flag or gameplay attack permission was changed. Author entries against actual context and resolve future melee classification in its owning workstream.
• ResolveHeldAction exposes exact-context attack content lookup and rejects left aim/actions for mixed firearm/melee pairs. Dual one-handed melee uses the right-side lookup key for one paired action and rejects a second independent left attack; this is a resolver convention, not an input binding. It does not play montages, implement dual-fire inputs, fire shots, apply damage or drive recoil. The Montage field and the independent-hand context are preparation for those consumers. The separate NotifyWeaponShot event and procedural arm recoil now include current-pose support-target evaluation. P10 shot integration, action slots and authored wrist orientation remain pending. Pistol/rifle Aim Offset integration is delivered in the current retargeted aim contract.
• Validation: closed-Editor LambeerEditor Win64 Development build passed; Lambeer.HUD headless automation passed 26/26, no failed/warning tests; MCP compiled ABP with warnings-as-errors, saved it and read back the branch filters. No owner PIE acceptance.

Author a first profile entry after selecting a clip

Open a profile Data Asset → Entries → add a row → expand Context. For a supported standing L1810 ShoulderAim idle: Action=Aim, Topology=RightOnly, RightFamily=Firearm, LeftFamily=Empty, Stance=Standing, Hand=Right, bSupportHand=true, PresetId=None for shared body content. Set Mode=Replace, Layer=UpperBody, Pose=the owner-selected non-additive sequence retargeted to the actual player skeleton. This row matches only after a support target is authored; author a separate bSupportHand=false entry for unsupported carry/aim. This is an authoring example, not a selected clip or fabricated asset.

For dual melee Attack, author Topology=DualItems, RightFamily=Melee, LeftFamily=Melee, Hand=Right and the dedicated paired montage; use UpperBody or FullBody according to the approved clip/action. There is no separate left attack row for that paired action. Aim is shared between idle and movement. Add only the required distinct Crouched/Prone contexts using reviewed clips; no idle/move or per-gait rows are needed. Duplicate a row only when its clip is actually valid in that context. Per-item exceptions use AnimationOverrides with the same exact key; PresetId-specific rows win over shared rows. Leave Montage unset until the selected actions exist. Exact matching is deliberate; empty Entries explain why newly assigned profiles currently show the old locomotion.

Owner report and current data — 2026-09-17

Owner-reported: holding RMB now makes the left hand move into support, but the aim animation appears not to play. This is evidence of a visible support response in the owner's tested case, not full grip, aim-pose, all-stance or multiplayer acceptance. The item, body and network configuration of that test were not explicitly identified.

MCP read-only inspection: PIE was not running. DA_Item_L1810 has bAllowFreeLeftHandSupport=true and bHasSupportHandTarget=true with a non-identity authored target. Its AnimationProfile points to DA_AnimProfile_Pistol, whose Entries=[]; the item also has AnimationOverrides=[]. Numeric calibration remains canonical in the item Data Asset. Earlier statements that L1810's support target was unauthored describe the previous snapshot and are superseded by this observation; the agent did not alter the owner's target.

Diagnosis for this inspected L1810 configuration: support eligibility/target calculation and pose lookup are separate. An empty profile supplies no AimIdle/AimMove entry; the native resolver keeps pose weights at zero on a missing entry. A visible left-hand IK response therefore does not prove that the ShoulderAim pose is playing. No live runtime reproduction is claimed.

Next integration work: bind the reviewed supported/unsupported/dual ShoulderAim sequences to explicit profile contexts, followed by Carry contexts; cover stance, aim mode, topology, both hand families, selected hand, support eligibility and body override. Do not accidentally map ShoulderAim to ADS. Read back the profile and verify selected pose, missing-pose flag and layer alpha on the owner's next test. File existence (69/69) is not profile integration. Attack montage/slot playback and independent firearm-hand versus paired-melee arbitration remain separate work.

Procedural arm recoil implemented; owner acceptance pending: event/debug API, per-item trial settings and current-pose support IK. The 15 unused non-additive Fire placeholders were deleted. Camera feedback, slide/bolt and P10 firing remain separate. Closed-Editor native build passed, HUD automation passed 28/28 without test warnings/errors, and the rewired ABP_Player compiled warnings-as-errors and saved clean. Visual/contact and multiplayer acceptance require owner PIE.

22.1 Separate equipment, pose and action

• Equipment facts: right item, left item, per-item authored handedness, firearm/melee presentation family, body PresetId. Preserve the inventory contract: one item using both hands differs from two independent one-handed items.
• Presentation context: stance, existing aim mode, carry topology, support-hand availability and action hand. Derive this context from gameplay state; do not maintain an unrelated AnimBP equipment state.
• Continuous pose: Carry/Ready/Aim. Owner correction: all eight requested aiming cases mean ShoulderAim, not ADS. The existing ADS mode remains distinct.
• Transient action: Attack or Fire, with explicit Right/Left/Both participation and a resolved compatible animation entry. A two-handed swing is one action, not two independent hand montages.
• Mixed pair: pistol + melee is already allowed by FEAT-COMBAT. Resolve each hand's family independently; do not force the pair into a pistol-only or melee-only enum. Owner confirmed independent right/left firearm firing. With a firearm/melee mixed pair, only the right hand participates in aiming and combat actions; the left keeps holding its item. Dual one-handed melee uses its own authored paired animation. Exact button bindings remain open.

22.2 Required presentation matrix

These are logical entries, not a claim that every row needs a new exported clip. Shared compatible clips may be referenced by multiple entries. All new names below are proposed. Standing, Crouched, Prone and Sprint/Run coverage is required by the owner. The owner will supply animation files later. Exact source animations, additive reference frames and final clip count await that content; the delivery table below fixes destinations and names now.

Coverage edge: existing inventory permits left-only items and mixed pairs. Keep these contexts representable in the resolver; left-only visual behavior and asset selection need owner confirmation rather than mirroring right-hand clips. Two-handed support in Carry versus Aim is an explicit profile choice; the current runtime enables it whenever a valid two-handed support target exists.

22.3 Layered Blend Per Bone composition

1. Cache the existing locomotion result as proposed CP_Locomotion. Keep the standing/crouch/prone, start/stop/turn, jump and inertialization graphs intact.
2. Build the selected carry/aim pose separately. Feed the cached locomotion to Base Pose of Layered Blend Per Bone; feed the selected upper-body or arm pose to a Blend Pose input. Drive weight from resolved presentation state. Weight zero must reproduce the existing unarmed locomotion.
3. Proposed skeleton blend masks: BM_Player_UpperBody, BM_Player_RightArm, BM_Player_LeftArm. These are entries on the shared Skeleton, not standalone files. Exact spine/clavicle boundaries and weights require inspecting the target skeleton and selected animations; do not copy a mannequin bone name blindly. Keep locomotion root, pelvis and legs outside carry overlays.
4. Use UpperBody for a coherent two-handed pose; use arm masks for independent held items. Torso contribution needs one resolved owner, not two competing full-torso arm layers. Layer order matters on overlapping bones. Mesh Space Rotation Blend is a separate blending option, not a substitute for an additive clip or a support solve.
5. Route action slots through the appropriate mask. Proposed independent groups/slots: RightAction.RightUpperBody, LeftAction.LeftUpperBody, BothAction.UpperBody, FullBodyAction.FullBody. Separate groups permit independent montages, but gameplay arbitration must explicitly stop/suppress arm actions when a both-arm/full-body action owns those bones.
6. Use full-body override only for an authored action that needs lower-body motion. Movement locking, root-motion policy, attack cancellation and stance restrictions remain P10 decisions; do not flatten every melee swing into an upper-body mask and claim the feet will be correct.
7. Apply procedural character recoil after the ready/aim pose and before the final support solve. Preserve the existing Control Rig behavior. Verify which bones it writes before choosing the final insertion point; no lower-body correction may overwrite the finished hand pose.
8. Apply the occupying right item’s RightHandPose with Layered Blend Per Bone rooted at hand_r after Control Rig and before support IK, so fingers curl around the attached mesh while recoil still moves the gun.
9. For support contact during fast movement/recoil, prefer a target evaluated from the current right-hand pose plus the calibrated item-relative transform in the same evaluation. The procedural-recoil change now uses a hand_r-space target derived from the authored attachment/support transforms; the AnimGraph evaluates it after recoil. Match the runtime scale contract and verify contact in owner PIE.
10. Apply the left finger Pose Asset after Two Bone IK, rooted at hand_l: the independent left item’s LeftHandPose, or the right item’s LeftHandPose while support IK is active. IK sets the wrist; the Pose Asset curls fingers. Canonical contract: TBD-INVENTORY-GRIP-003.

Curves need explicit ownership through these blends: final SupportHandIK must come from the active contact/release action rather than be accidentally overwritten by a carry layer. Missing curve currently means full weight; gameplay eligibility must multiply that weight so occupied hands never receive support IK. The current effector remains position-only. Both Two Bone IK nodes now disable chain twist so looking up/down keeps the incoming forearm/wrist twist from the posed chain. Using SupportHandTarget Rotation to aim the wrist is still a separate validated design.

Pistol/rifle pitch correction now uses the bound Aim Offset; other families still have optional unprovided Aim Offset content. No yaw samples were supplied. Epic requires its samples to use Mesh Space additive animation. A ready pose and an Aim Offset solve different problems; do not mark every Carry/Aim clip additive automatically. See Epic: layered animations, blend masks and Aim Offset.

22.4 Shared animation profiles and item overrides

Recommendation: keep measured grip transforms on existing DA_Item_*. Use an asset reference to the implemented ULambeerHeldAnimationProfile Data Asset for reusable animation content. This is an animation profile, not a second grip database. A special weapon can reference its own profile or replace a small number of entries on its item definition.

Owner correction: use one Carry action for idle and movement, and one Aim action for idle and movement. Movement speed does not select a separate held pose. This avoids duplicating all existing Walk/Jog/Run directional clips for each weapon. A shared profile is preferable to putting an entire animation matrix on every item; Linked Anim Layers can be added later if families need different graph logic, not just different assets.

22.5 What makes hands lift when firing?

A weapon's mechanism animation moves its slide/bolt/trigger on the weapon skeleton. It does not automatically animate the character's arms. The recommended presentation has three separate consumers of the same validated shot: weapon mechanism, character recoil, and local camera response. Camera recoil alone cannot make another client see the arms kick.

Owner decision (2026-09-17): all character recoil uses a procedural response over the current holding/aim pose; no recoil Animation Sequence is required. The attached gun follows the right hand; solve the supporting left hand afterward. Unsupported pistol recoil preserves the left item's pose. Dual-wield events identify the firing hand and use independent recoil channels; the owner selected separate right/left firing; exact buttons remain unassigned. The procedural implementation and its strengths/timings remain pending; values must be authored and approved, not invented here. Weapon bolt recoil and character recoil must not both translate the entire gun by the same kick.

Gameplay shot direction, spread, ammo consumption and damage remain server-authoritative P10 behavior. Cosmetic recoil does not drive hit truth. Do not replicate per-frame bone transforms or animation time; the future shot/action event needs enough identity and timing to reproduce remote presentation and prevent owner prediction being played twice. Grip/profile assets are content; transient pose, IK weight and recoil do not add durable save records. Existing persisted held item identity remains the input after restore.

22.6 Proposed folder and file structure

Filesystem root: Content/Lambeer/Characters/Player/Animation/. Unreal package root: /Game/Lambeer/Characters/Player/Animation/. Keep existing assets in place: C++ currently loads locomotion paths under this root. Profiles/ and the six named profile Data Assets now exist. Other new branches below remain a naming plan; no existing animation assets were moved.

Animation/
  ABP_Player.uasset                         [existing: extend in place]
  Idle/ Walk/ Jog/ Run/ Crouch/ Prone/ Spin/ [existing: retain]
  UnarmedAttack/                            [existing: retain; audit clips]
  Profiles/                                [created; Entries empty]
    DA_AnimProfile_Unarmed
    DA_AnimProfile_Melee1H
    DA_AnimProfile_Melee2H
    DA_AnimProfile_Pistol
    DA_AnimProfile_Firearm2H
    DA_AnimProfile_TwoHandedItem             [non-attack carry profile]
    Items/
      DA_AnimProfile_Crowbar                [only if behavior differs]
  Carry/
    RightOnly/  A_Carry_RightOnly_Idle
    DualItems/  A_Carry_DualItems_Idle
    TwoHanded/  A_Carry_TwoHanded_Idle
  Aim/
    Unarmed/            A_ShoulderAim_Unarmed_Ready
    Melee1H/            A_ShoulderAim_Melee1H_Right, A_ShoulderAim_Melee1H_Dual
    Melee2H/            A_ShoulderAim_Melee2H_Ready
    Pistol/             A_ShoulderAim_Pistol_Supported, A_ShoulderAim_Pistol_Unsupported
                        A_ShoulderAim_Pistol_Dual
    Firearm2H/          A_ShoulderAim_Firearm2H_Ready
  Attack/
    Unarmed/            AM_Attack_Unarmed_01 [may wrap audited existing clip]
    Melee1H/            A_Attack_Melee1H_Right_01, AM_Attack_Melee1H_Right_01
                        A_Attack_Melee1H_Dual_01, AM_Attack_Melee1H_Dual_01
    Melee2H/            A_Attack_Melee2H_01, AM_Attack_Melee2H_01
  Overrides/
    Items/Crowbar/      A_Attack_Crowbar_Right_01, AM_Attack_Crowbar_Right_01
    Bodies/            [create only for an actual authored body variant]
  Calibration/
    BP_GripCalibration [proposed editor preview helper; not created]
  HandPoses/                               [plan; no assets created]
    L1810/    PA_L1810_RH, PA_L1810_LH
    Crowbar/  PA_Crowbar_RH, PA_Crowbar_LH
    FireAxe/  PA_FireAxe_RH, PA_FireAxe_LH
    Sledgehammer/ PA_Sledgehammer_RH, PA_Sledgehammer_LH
    WoodenMallet/ PA_WoodenMallet_RH, PA_WoodenMallet_LH

Omitted extensions above are .uasset. Naming tokens: A_ Animation Sequence, AM_ Montage, BS_ Blend Space, AO_ Aim Offset, PA_ Pose Asset, DA_AnimProfile_ proposed animation profile. Optional Aim Offset example: AO_Pistol_Supported. Suffix _Add is a content promise requiring correct additive settings. _01 is a variant ID, not a promise of combo count. Add stance/body tokens only when a distinct authored asset exists; _Stand, _Crouch, _Prone, _Man, _Woman are proposed. ShoulderAim and ADS get distinct entries if the owner wants different poses, even if they reference one shared asset.

Weapon mechanism clips remain with the weapon's content, not in the player animation tree. DA_Item_* stays under /Game/Lambeer/Core/Data/Items/. Skeleton masks and montage slots are named skeleton entries and are not folders/files. Do not move the existing UnarmedAttack clips until their skeleton, montage and runtime references have been audited.

22.7 Owner decisions and implementation gates

• Confirmed: the requested aim matrix is ShoulderAim, not ADS. Separate right/left firearm firing; mixed firearm/melee pairs use the right hand only for aim/actions.
• Confirmed 2026-09-17: each held item needs its own finger Pose Asset. Family Carry/ShoulderAim stays shared. TBD-INVENTORY-GRIP-003.
• Open in FEAT-COMBAT: exact button bindings, interruption, block/parry and reload constraints. Dual one-handed melee now uses a dedicated paired animation; firearm hands remain independent. Mixed firearm/melee eligibility is already confirmed.
• Confirmed: all poses are required: Standing, Crouched, Prone and Sprint/Run. Existing locomotion transition rules remain unchanged; this does not introduce a simultaneous Prone+Sprint stance. Exact clips and left-only authored presentation still need owner content.
• Authorized: implement feasible native and AnimBP presentation work in this task. P10 damage, firing mechanics, attack timings and unresolved dual-melee inputs are not inferred from this animation request.

Remaining sequence: owner selects/retargets compatible clips and per-item hand Pose Assets → author profile entries, measured grips and Pose Asset bindings → add validated action/recoil playback and slot arbitration where gameplay events exist → compile/save through MCP → owner performs visual/network PIE. Keep ROAD-P09-03's historical grip-slice completion. ROAD-P09-05 ABP/native wiring landed 2026-09-17; authored poses remain ROAD-P09-04. P09 does not close while only its former grip slice is implemented.

Acceptance: unarmed baseline unchanged; feet continue idle/move under arm overlays; no unsupported stance fallback; supported pistol toggles IK when the left hand becomes occupied/free; per-hand recoil does not overwrite the other hand; special-item override affects only the intended entries; release curves restore contact cleanly; Man/Woman and local/remote representations agree. Owner-only PIE: Dedicated Server with two client Preview windows, plus the existing relevant locomotion regressions. Source/profile validation and Blueprint compile are not visual acceptance.

22.8 Clip delivery destinations and names — owner will supply clips later

Owner direction: animation files will be supplied later; provide exact destinations and names now. This table supersedes shorter illustrative names in the folder overview. It defines naming, not the existence or acceptance of any clip. All paths below are relative to /Game/Lambeer/Characters/Player/Animation/ (filesystem Content/Lambeer/Characters/Player/Animation/).

Replace {Stance} with exactly Stand, Crouch or Prone. These filename tokens map to native Standing, Crouched and Prone. Use no literal braces in asset names. Unreal creates the .uasset extension; the owner delivers/retargets Animation Sequences (A_). Montage wrappers (AM_) can be created after clip selection and action rules are ready; an FBX must not merely be renamed to .uasset.

Movement and Sprint: Carry uses the retained _Idle clip across idle, Walk/Jog/Run by owner decision (2026-09-17). Held-animation entries do not have a Gait field or gait-specific filenames. Carry and Aim each use one action across idle/move; ShoulderAim permits only Walk. Stance remains explicit: Standing, Crouched and Prone use their corresponding clips and existing stance speed limits. Run remains a locomotion gait, not a fourth stance. Existing profile rows that differed only in Gait now have the same key; keep one intended row per remaining context to avoid first-match duplicates.

No duplicate exports required: if the exact same compatible clip covers multiple contexts, keep one asset and reference it from multiple profile entries. The matrix specifies coverage, not a mandatory export count. Preserve existing empty-handed Idle/Walk/Jog/Run/Crouch/Prone content. Existing UnarmedAttack clips remain where they are until reviewed; do not duplicate or move them merely to satisfy naming.

Item exceptions: use Overrides/Items/Crowbar/A_Attack_Crowbar_Right_Stand_01, for example, then override the exact context on DA_Item_Crowbar. Body-specific files, only if genuinely needed, use Overrides/Bodies/Woman/ and a final _Woman token . A left-only carry/aim case may use an explicitly authored LeftOnly/Left variant; no mirrored right animation is assumed.

Recoil decision — 2026-09-17: all character recoil is procedural. The Fire/_Add names listed here are historical placeholder inventory, not required clip deliveries. Existing assets are retained, unused; no replacement recoil clips or additive reference poses are required. Weapon mechanism clips remain with the weapon asset.

Carry/RightOnly/A_Carry_RightOnly_Stand_Idle
Carry/RightOnly/A_Carry_RightOnly_Crouch_Idle
Carry/RightOnly/A_Carry_RightOnly_Prone_Idle
Carry/DualItems/A_Carry_DualItems_Stand_Idle
Carry/DualItems/A_Carry_DualItems_Crouch_Idle
Carry/DualItems/A_Carry_DualItems_Prone_Idle
Carry/TwoHanded/A_Carry_TwoHanded_Stand_Idle
Carry/TwoHanded/A_Carry_TwoHanded_Crouch_Idle
Carry/TwoHanded/A_Carry_TwoHanded_Prone_Idle
Aim/Unarmed/A_ShoulderAim_Unarmed_Stand
Aim/Unarmed/A_ShoulderAim_Unarmed_Crouch
Aim/Unarmed/A_ShoulderAim_Unarmed_Prone
Aim/Melee1H/A_ShoulderAim_Melee1H_Right_Stand
Aim/Melee1H/A_ShoulderAim_Melee1H_Right_Crouch
Aim/Melee1H/A_ShoulderAim_Melee1H_Right_Prone
Aim/Melee1H/A_ShoulderAim_Melee1H_Dual_Stand
Aim/Melee1H/A_ShoulderAim_Melee1H_Dual_Crouch
Aim/Melee1H/A_ShoulderAim_Melee1H_Dual_Prone
Aim/Melee2H/A_ShoulderAim_Melee2H_Stand
Aim/Melee2H/A_ShoulderAim_Melee2H_Crouch
Aim/Melee2H/A_ShoulderAim_Melee2H_Prone
Aim/Pistol/A_ShoulderAim_Pistol_Supported_Stand
Aim/Pistol/A_ShoulderAim_Pistol_Supported_Crouch
Aim/Pistol/A_ShoulderAim_Pistol_Supported_Prone
Aim/Pistol/A_ShoulderAim_Pistol_Unsupported_Stand
Aim/Pistol/A_ShoulderAim_Pistol_Unsupported_Crouch
Aim/Pistol/A_ShoulderAim_Pistol_Unsupported_Prone
Aim/Pistol/A_ShoulderAim_Pistol_Dual_Stand
Aim/Pistol/A_ShoulderAim_Pistol_Dual_Crouch
Aim/Pistol/A_ShoulderAim_Pistol_Dual_Prone
Aim/Firearm2H/A_ShoulderAim_Firearm2H_Stand
Aim/Firearm2H/A_ShoulderAim_Firearm2H_Crouch
Aim/Firearm2H/A_ShoulderAim_Firearm2H_Prone
Attack/Unarmed/A_Attack_Unarmed_Stand_01
Attack/Unarmed/A_Attack_Unarmed_Crouch_01
Attack/Unarmed/A_Attack_Unarmed_Prone_01
Attack/Melee1H/A_Attack_Melee1H_Right_Stand_01
Attack/Melee1H/A_Attack_Melee1H_Right_Crouch_01
Attack/Melee1H/A_Attack_Melee1H_Right_Prone_01
Attack/Melee1H/A_Attack_Melee1H_Dual_Stand_01
Attack/Melee1H/A_Attack_Melee1H_Dual_Crouch_01
Attack/Melee1H/A_Attack_Melee1H_Dual_Prone_01
Attack/Melee2H/A_Attack_Melee2H_Stand_01
Attack/Melee2H/A_Attack_Melee2H_Crouch_01
Attack/Melee2H/A_Attack_Melee2H_Prone_01

22.9 Per-item hand pose — owner confirmed 2026-09-17

[CONFIRMED] Shared family Carry/ShoulderAim is not enough for visual contact. Each held item needs its own finger pose. Canonical contract: TBD-INVENTORY-GRIP-003. This is a P09 requirement, not a later polish pass.

Keep the existing three layers: family clips for arms/torso, item transforms for mesh placement, Two Bone IK for the support wrist. Add character Pose Assets for fingers. Do not create per-item locomotion, per-item AnimBP subclasses, a second WeaponAnimationData class, or item-mesh Grip_L sockets as a Static Mesh requirement. The guide’s left-hand IK role is already SupportHandTarget.

Native + ABP wiring, 2026-09-17: item fields and AnimInstance RightHeldHandPose / RightHeldHandPoseName / RightHeldHandPoseAlpha and the left equivalents exist. Alpha is 1 only for a Pose Asset on the actual player skeleton that contains at least one pose; the published name is that first pose. Null, empty, or wrong-skeleton assets keep family fingers and do not set bMissingHeldPose. MCP compiled and saved ABP_Player with Layered Blend Per Bone on hand_r after Control Rig / before Two Bone IK, and on hand_l after IK. Each blend evaluates the Pose Asset via Evaluate Pose, with Modify Curve setting the first pose name to weight 1. Closed-Editor native build and headless Lambeer.HUD 26/26 passed. No Pose Assets are bound, so no visual curl is claimed.

Proposed first-slice assets, not created: /Game/Lambeer/Characters/Player/Animation/HandPoses/{Item}/PA_{Item}_RH and PA_{Item}_LH for Crowbar, FireAxe, Sledgehammer, WoodenMallet and L1810. Owner authors/retargets; agent may bind supplied assets. Trigger-finger Safe/Trigger and item-switch blend times are not this pass.

23. Editor calibration → item Data Asset

Purpose: measure a mesh placement relative to the character's hand socket, then store that measured location/rotation on the item definition. Changing a shared socket to fit one weapon would change every weapon attached there. This is an owner-operated authoring workflow; the proposed preview helper does not exist yet. An agent can inspect/save supported operations through Unreal MCP, but may not use computer-use or retarget clips.

Current limitations: two-handed items consume SupportHandTarget as before. A one-handed firearm needs bHasSupportHandTarget, ShoulderAim or ADS, and an empty left hand. Support target Rotation still does not control the wrist; IK keeps the incoming pose twist instead of rolling the chain. Finger curl requires bound Pose Assets and ABP hand blends; native publish alone does not pose fingers. SupportHandIK curves can release contact, but cannot make an occupied hand available. InspectPreviewRelative is unrelated to grip calibration.

Owner validation after saving: in Dedicated Server + two clients, inspect idle, movement, the permitted aim modes, draw/stow/drop and the available actions on both bodies, locally and remotely. Check correct size, wrist/finger contact, no one-frame support lag, no elbow flip/overextension and no support IK on an occupied hand. Report results before ROAD-P09-04 is accepted. There are no invented offset numbers or claimed PIE results in this guide.

24. Owner-authorized placeholder sequences — 2026-09-16

The owner now explicitly permits copying the matching Stand sequence to missing stances. If there is no Stand source, use A_INP_Idle for Carry and melee aim, the supplied supported-pistol ShoulderAim for pistol aim and Fire, and A_Attack_Unarmed_Stand_01 for unarmed/melee attacks. This is an authoring exception for temporary assets, not approval of final poses. The runtime still uses explicit profile entries; it does not silently fall back between stances.

Historical file preparation completed with 69 sequences. The 2026-09-17 shared-action cleanup deleted nine unused Carry *_Move sequences, and the subsequent procedural-recoil cleanup deleted 15 unused A_Recoil_* placeholders, leaving 45 of that original inventory; the active delivery list excludes all 24 deleted files. Created/saved 65 placeholder copies through Unreal MCP, retained three correctly named existing sequences and renamed the owner's Pistol_Pistol_Dual_Stand to Pistol_Dual_Stand (old asset path no longer exists; no duplicate original retained). Owner confirmed Unarmed aim uses Idle and Firearm2H aim uses the supported-pistol pose. This was a file-preparation snapshot; the profiles have since been populated and consolidated as recorded in the current shared Aim contract. No retarget, asset export, gameplay change, numeric grip calibration or PIE was performed.

Every new copy carries asset metadata Lambeer.Placeholder=true, Lambeer.PlaceholderSource and Lambeer.PlaceholderNote. All inspected sources use the MetaHuman base skeleton. New Fire assets retain AAT_None: their existing planned _Add names are placeholders only and do not prove additive content. Do not pass them to Apply Additive or regard them as firing/recoil animation. Replacing a placeholder includes reviewing its notifies, curves, root motion, skeleton and additive settings, not only its name.