2026-10-28 15:39:06 +02:00
|
|
|
extends RefCounted
|
|
|
|
|
var failures=[]
|
|
|
|
|
func check(ok,label):
|
|
|
|
|
if not ok and not label in failures:failures.append(label);push_error("GAIT QA: "+label)
|
|
|
|
|
func run(g):
|
|
|
|
|
await g.get_tree().create_timer(.3).timeout
|
|
|
|
|
g.start_game();g.set_process(false);g.avatar.set_process(false)
|
|
|
|
|
g.workshop.add_helper();g.workshop.add_helper();g.workshop.add_helper()
|
|
|
|
|
for h in g.workshop.helpers:h.model.set_process(false)
|
|
|
|
|
var actors=[g.avatar]
|
|
|
|
|
for h in g.workshop.helpers:actors.append(h.model)
|
|
|
|
|
for actor in actors:
|
2026-10-28 23:30:37 +02:00
|
|
|
actor.reset_gait()
|
|
|
|
|
for frame in range(10):actor._process(1.0/60)
|
|
|
|
|
var hand_start=actor.gait.point("wrist.L")
|
|
|
|
|
var feet_start=[actor.gait.point("foot.L"),actor.gait.point("foot.R")]
|
|
|
|
|
var idle_motion=0.0
|
|
|
|
|
for frame in range(240):
|
|
|
|
|
actor._process(1.0/60)
|
|
|
|
|
idle_motion=maxf(idle_motion,actor.gait.point("wrist.L").distance_to(hand_start))
|
2026-10-28 23:52:50 +02:00
|
|
|
check(idle_motion>.012,"visible idle breathing and relaxed arm motion")
|
|
|
|
|
for side in ["L","R"]:
|
|
|
|
|
var upper=actor.gait.point("lowerarm01."+side)-actor.gait.point("upperarm01."+side)
|
|
|
|
|
var forearm=actor.gait.point("wrist."+side)-actor.gait.point("lowerarm01."+side)
|
|
|
|
|
check(upper.normalized().dot(Vector3.DOWN)>.96,"retargeted idle arms remain near vertical")
|
|
|
|
|
check(upper.angle_to(forearm)>deg_to_rad(8) and upper.angle_to(forearm)<deg_to_rad(30),"relaxed elbow bend")
|
2026-10-28 23:30:37 +02:00
|
|
|
for i in range(2):check(actor.gait.point("foot."+actor.gait.feet[i].side).distance_to(feet_start[i])<.003,"idle feet stay grounded")
|
|
|
|
|
var idle_time=actor.gait.idle_time
|
|
|
|
|
g.paused=true;actor._process(.05);check(is_equal_approx(actor.gait.idle_time,idle_time),"pause freezes idle animation");g.paused=false
|
2026-10-28 15:39:06 +02:00
|
|
|
for speed in [1.0,2.5,3.3,4.375,5.775]:
|
|
|
|
|
actor.get_parent().position=Vector3.ZERO;actor.rotation=Vector3.ZERO;actor.striking=false;actor.refresh();actor.animator.advance(0);actor.reset_gait()
|
|
|
|
|
var max_slide=0.0;var max_error=0.0;var max_lift=0.0;var min_contact=10.0;var planted_frames=0
|
2026-10-28 23:52:50 +02:00
|
|
|
var hand_min=Vector2(INF,INF);var hand_max=Vector2(-INF,-INF);var cross_sum=0.0
|
2026-10-28 23:56:19 +02:00
|
|
|
var hand_sum=Vector2.ZERO;var samples=0;var elbow_min=INF;var elbow_max=0.0
|
2026-10-28 23:59:10 +02:00
|
|
|
var forward_angles=0.0;var back_angles=0.0;var forward_samples=0;var back_samples=0
|
2026-10-28 15:39:06 +02:00
|
|
|
for frame in range(240):
|
|
|
|
|
var before=[]
|
|
|
|
|
for f in actor.gait.feet:before.append({"grounded":f.grounded,"anchor":f.anchor,"position":actor.gait.point("foot."+f.side)})
|
|
|
|
|
var direction=Vector3.BACK if frame<120 else Vector3.RIGHT
|
|
|
|
|
actor.get_parent().position+=direction*speed/60
|
|
|
|
|
actor.rotation.y=lerp_angle(actor.rotation.y,atan2(direction.x,direction.z),.16)
|
|
|
|
|
actor._process(1.0/60)
|
2026-10-28 23:52:50 +02:00
|
|
|
if frame>30 and frame<110:
|
|
|
|
|
var hand_offsets=Vector2.ZERO
|
|
|
|
|
for side_index in range(2):
|
|
|
|
|
var side="L" if side_index==0 else "R"
|
|
|
|
|
hand_offsets[side_index]=(actor.gait.point("wrist."+side)-actor.gait.point("upperarm01."+side)).dot(actor.global_basis.z.normalized())
|
|
|
|
|
hand_min[side_index]=minf(hand_min[side_index],hand_offsets[side_index]);hand_max[side_index]=maxf(hand_max[side_index],hand_offsets[side_index])
|
2026-10-28 23:56:19 +02:00
|
|
|
var upper=actor.gait.point("lowerarm01."+side)-actor.gait.point("upperarm01."+side)
|
|
|
|
|
var forearm=actor.gait.point("wrist."+side)-actor.gait.point("lowerarm01."+side)
|
|
|
|
|
var angle=upper.angle_to(forearm);elbow_min=minf(elbow_min,angle);elbow_max=maxf(elbow_max,angle)
|
2026-10-28 23:59:10 +02:00
|
|
|
var swing_direction=upper.normalized().dot(actor.global_basis.z.normalized())
|
|
|
|
|
if swing_direction>.12:forward_angles+=angle;forward_samples+=1
|
|
|
|
|
if swing_direction<-.12:back_angles+=angle;back_samples+=1
|
2026-10-28 23:56:19 +02:00
|
|
|
cross_sum+=hand_offsets.x*hand_offsets.y;hand_sum+=hand_offsets;samples+=1
|
2026-10-28 15:39:06 +02:00
|
|
|
for i in range(2):
|
|
|
|
|
var f=actor.gait.feet[i];var actual=actor.gait.point("foot."+f.side)
|
|
|
|
|
max_error=maxf(max_error,actual.distance_to(f.target))
|
|
|
|
|
max_lift=maxf(max_lift,actual.y-actor.gait.ground_height(f))
|
|
|
|
|
min_contact=minf(min_contact,actual.y-actor.gait.ground_height(f))
|
|
|
|
|
if f.grounded and before[i].grounded and f.anchor.is_equal_approx(before[i].anchor) and frame>1:
|
|
|
|
|
max_slide=maxf(max_slide,actual.distance_to(before[i].position));planted_frames+=1
|
|
|
|
|
check(max_error<.003,"IK reach "+str(actor.scale.x)+" "+str(speed))
|
|
|
|
|
check(max_slide<.003,"stance slip "+str(actor.scale.x)+" "+str(speed))
|
|
|
|
|
check(min_contact>-.002,"ground clearance")
|
|
|
|
|
check(max_lift>.08 and planted_frames>150,"alternating lift/support")
|
2026-10-28 23:52:50 +02:00
|
|
|
check(hand_max.x-hand_min.x>.12 and hand_max.y-hand_min.y>.12,"both hands swing during locomotion")
|
2026-10-28 23:56:19 +02:00
|
|
|
check(cross_sum/samples-(hand_sum.x/samples)*(hand_sum.y/samples)<0,"opposing left/right arm swing")
|
2026-10-28 23:59:10 +02:00
|
|
|
check(elbow_min<deg_to_rad(23) and elbow_max>deg_to_rad(50) and elbow_max<deg_to_rad(68),"elbows extend beside body and flex on forward swing")
|
|
|
|
|
check(forward_samples>0 and back_samples>0 and forward_angles/maxi(1,forward_samples)>back_angles/maxi(1,back_samples)+deg_to_rad(20),"elbow flexion follows actual forward/backward shoulder swing")
|
2026-10-28 15:39:06 +02:00
|
|
|
print("GAIT_METRICS ",JSON.stringify({"scale":actor.scale.x,"speed":speed,"max_slide":max_slide,"max_target_error":max_error,"max_lift":max_lift,"min_contact":min_contact}))
|
|
|
|
|
var phase=actor.gait.phase
|
|
|
|
|
for frame in range(30):actor._process(1.0/60)
|
|
|
|
|
check(is_equal_approx(actor.gait.phase,phase),"no steps when blocked/stopped")
|
|
|
|
|
for f in actor.gait.feet:check(f.grounded and absf(actor.gait.point("foot."+f.side).y-actor.gait.ground_height(f))<.04,"stop settles to floor")
|
|
|
|
|
actor.strike(.45)
|
|
|
|
|
for frame in range(40):actor._process(1.0/60)
|
|
|
|
|
check(not actor.striking,"whip returns to idle")
|
|
|
|
|
g.paused=true;var root=actor.gait.point("root");actor._process(.05);check(actor.gait.point("root").is_equal_approx(root),"pause freezes pose");g.paused=false
|
|
|
|
|
actor.get_parent().position+=Vector3(10,0,0);actor._process(.016)
|
|
|
|
|
check(actor.gait.last_speed==0,"teleport resets anchors")
|
|
|
|
|
print("GAIT_FAILURES: ",failures)
|
|
|
|
|
if failures.is_empty():print("ALL GAIT TESTS PASSED: heroine and three helpers, five speeds, turns, ground contact, stopping, whip, pause, teleport")
|
|
|
|
|
g.get_tree().quit(0 if failures.is_empty() else 1)
|