UE5蓝图仿刺客信条跑酷：检测、决策与Motion Warping对齐的代码实现

USTRUCT(BlueprintType)
struct FTraversalResult {
    GENERATED_BODY()
    UPROPERTY(BlueprintReadOnly) bool bValid = false;
    UPROPERTY(BlueprintReadOnly) float WallHeight = 0.f;
    UPROPERTY(BlueprintReadOnly) float StandDepth = 0.f;
    UPROPERTY(BlueprintReadOnly) FVector TargetLocation = FVector::ZeroVector;
    UPROPERTY(BlueprintReadOnly) FRotator TargetRotation = FRotator::ZeroRotator;
};

UFUNCTION(BlueprintCallable, Category="Parkour")
static FTraversalResult ComputeTraversalHit(AActor* Avatar, FVector Forward, float Radius) {
    FTraversalResult Out;
    if (!Avatar) return Out;
    UWorld* World = Avatar->GetWorld();
    FVector Origin = Avatar->GetActorLocation();
    FCollisionQueryParams P; P.AddIgnoredActor(Avatar);

    TArray<FHitResult> Hits;
    FVector Start = Origin + Forward * 50.f;
    World->SweepMultiByChannel(Hits, Start, Start + Forward * 150.f, FQuat::Identity,
        ECC_GameTraceChannel1, FCollisionShape::MakeSphere(Radius), P); // Parkour 通道
    if (Hits.IsEmpty()) return Out;

    const FHitResult* Highest = &Hits[0];
    for (const FHitResult& H : Hits)
        if (H.ImpactPoint.Z > Highest->ImpactPoint.Z) Highest = &H;

    FVector WallNormal = Highest->ImpactNormal;
    FHitResult TopHit;
    FVector TopStart = Highest->ImpactPoint + WallNormal * 2.f + FVector(0, 0, 200.f);
    World->LineTraceSingleByChannel(TopHit, TopStart, TopStart - FVector(0, 0, 400.f),
        ECC_GameTraceChannel1, P);
    Out.WallHeight = Origin.Z - TopHit.ImpactPoint.Z;

    FHitResult DepthHit;
    FVector DepthEnd = TopHit.ImpactPoint - WallNormal * 120.f;
    World->SweepSingleByChannel(DepthHit, TopHit.ImpactPoint, DepthEnd, FQuat::Identity,
        ECC_GameTraceChannel1, FCollisionShape::MakeSphere(15.f), P);
    Out.StandDepth = FVector::Dist(TopHit.ImpactPoint, DepthHit.ImpactPoint);
    Out.TargetLocation = DepthHit.ImpactPoint;
    Out.TargetRotation = (-WallNormal).Rotation();
    Out.bValid = true;
    return Out;
}

// 蓝图事件图表（文本化）
OnParkourInputPressed:
  Result = ComputeTraversalHit(Self, GetActorForwardVector(), 40)
  Branch (Result.bValid)
    True:
      Type = ParkourData->ResolveType(Result.WallHeight, Result.StandDepth)
      PlayParkourAction(Type, Result)
    False: Do Nothing

void AMyCharacter::PlayParkourAction(EParkourType Type, const FTraversalResult& Hit) {
    UAnimMontage* Montage = ParkourData->GetMontage(Type);
    if (!Montage || !MotionWarping) return;

    MotionWarping->AddOrUpdateWarpTargetFromLocationAndRotation(
        TEXT("FrontLedge"), Hit.TargetLocation, Hit.TargetRotation);

    // 栏杆/箱体需要后缘目标，让蒙太奇后段身体对齐
    if (Type == EParkourType::ThinVault || Type == EParkourType::MidVault) {
        FVector BackLedge = Hit.TargetLocation + Hit.TargetRotation.Vector() * 80.f;
        MotionWarping->AddOrUpdateWarpTargetFromLocationAndRotation(
            TEXT("BackLedge"), BackLedge, Hit.TargetRotation);
    }
    PlayAnimMontage(Montage);
}