UE 原生贴地移动逻辑
1P 预测 → DS 重放 → 3P 跟随

00一句话总览

UE 的"贴地"不是把角色直接放在地面上，而是允许胶囊底部悬浮在一个很窄的区间（1.9 ~ 2.4 cm）内，靠每帧 FindFloor 向下探测 + AdjustFloorHeight 把这个距离拉回区间中点。1P 和 DS 跑的是同一套完整 PhysWalking 物理；3P 没有输入，只按复制速度做 MoveSmooth 外推，再用精简版的 FindFloor + AdjustFloorHeight 贴地，最终高度由服务器快照兜底。

01动画沙盘：地形剖面与三端

上半部分是地形剖面（平地 → 台阶 → 高台 → 下坡），三个胶囊分别代表 1P / DS / 3P 的位置；下半部分是三泳道时序。切换「实现模式」可对比 原生 UE（3P 有本地 FindFloor/AdjustFloorHeight）与 PX 项目（3P 移除本地贴地，Z 完全继承）。

02贴地的物理模型

UE 的 walking 角色不是"贴"在地面上，而是浮在地面上方 1.9~2.4 cm。这个区间由两个常量定义，所有贴地逻辑都围绕它展开。

// CharacterMovementComponent.cpp:99-100
const float UCharacterMovementComponent::MIN_FLOOR_DIST = 1.9f;
const float UCharacterMovementComponent::MAX_FLOOR_DIST = 2.4f;
// :799  构造函数中默认每帧都做地面检测
bAlwaysCheckFloor = true;

2.1 FFindFloorResult 与 CurrentFloor

2.2 FindFloor 到底做了什么

FindFloor:7261 先算探测距离，再决定是否真的发射检测：

// :7275-7291（节选）
const float HeightCheckAdjust = (IsMovingOnGround() ? MAX_FLOOR_DIST + UE_KINDA_SMALL_NUMBER : -MAX_FLOOR_DIST);
float FloorSweepTraceDist = FMath::Max(MAX_FLOOR_DIST, MaxStepHeight + HeightCheckAdjust);
...
if ( bAlwaysCheckFloor || !bCanUseCachedLocation || bForceNextFloorCheck || bJustTeleported )
{
    MutableThis->bForceNextFloorCheck = false;
    ComputeFloorDist(CapsuleLocation, FloorLineTraceDist, FloorSweepTraceDist,
                     OutFloorResult, CapsuleRadius, DownwardSweepResult);   // :7290
}
else if ( ... 有有效 MovementBase 且无需强制 ... )
{
    OutFloorResult = CurrentFloor;    // :7313 直接复用缓存，省一次物理查询
    bNeedToValidateFloor = false;
}

ComputeFloorDist（:7110）用缩短并缩窄的胶囊向下做 FloorSweepTest（:7177），命中点必须在胶囊底部半球范围内（IsWithinEdgeTolerance），否则缩小半径重试；sweep 不可用才回退 line trace。之后 FindFloor 还会做 Perch 判定（:7326-7360）：站在边缘时用一个更小的"栖息半径"再探一次，决定能不能继续站在沿上。

2.3 AdjustFloorHeight：把距离拉回区间中点

// :6335-6399（节选）
void UCharacterMovementComponent::AdjustFloorHeight()
{
    if (!CurrentFloor.IsWalkableFloor()) return;                 // :6340
    float OldFloorDist = CurrentFloor.FloorDist;
    if (CurrentFloor.bLineTrace) { ... OldFloorDist = CurrentFloor.LineDist; }   // :6346-6358

    if (OldFloorDist < MIN_FLOOR_DIST || OldFloorDist > MAX_FLOOR_DIST)       // :6362
    {
        const float AvgFloorDist = (MIN_FLOOR_DIST + MAX_FLOOR_DIST) * 0.5f;   // 2.15
        const float MoveDist = AvgFloorDist - OldFloorDist;                    // :6367
        SafeMoveUpdatedComponent(MoveDist * -GetGravityDirection(), ..., true, AdjustHit);  // :6368
        ...
        bJustTeleported |= !bMaintainHorizontalGroundVelocity || (OldFloorDist < 0.f);  // :6392
        if (CharacterOwner && CharacterOwner->GetLocalRole() != ROLE_SimulatedProxy)
            bForceNextFloorCheck = true;                                        // :6395-6397
    }
}

注意 :6395：SimulatedProxy 不会因高度修正置 bForceNextFloorCheck——这是原生代码里就存在的 1P/3P 差异，因为 3P 的地面状态本来就要靠下一个网络包刷新。

031P：完整 PhysWalking 循环

主控端的贴地是完整的、带输入的物理模拟，每帧本地执行，不等服务器。

3.1 调用链

APlayerController::PlayerTick → ProcessPlayerInput / UpdateRotation
  └─ ACharacter::AddMovementInput
       └─ UCharacterMovementComponent::TickComponent                 :1663
            └─ ControlledCharacterMove(InputVector, DeltaTime)        :6481
                 └─ ReplicateMoveToServer(DeltaTime, Acceleration)    :8968
                      └─ PerformMovement(NewMove->DeltaTime)          :9090 → :2790
                           └─ StartNewPhysics(DeltaSeconds, 0)       :3057 → :3554
                                └─ case MOVE_Walking: PhysWalking() :3579 → :5692

3.2 PhysWalking 一帧内逐步

04台阶与边缘：StepUp / CheckFall

4.1 StepUp 三步

StepUp:7613 在 MoveAlongFloor 撞到可跨越障碍时被调用（:5642）。它用 FScopedCapsuleMovementUpdate（:7675）把三次移动合并成一次 transform 更新，中间态不会触发 overlap 回调：

// :7642-7654  上台高度按实际 FloorDist 扣减
float StepTravelUpHeight   = MaxStepHeight;
float StepTravelDownHeight = (MaxStepHeight + MAX_FLOOR_DIST * 2.f);
...
// :7680  ① 向上
MoveUpdatedComponent(-GravDir * StepTravelUpHeight, PawnRotation, true, &SweepUpHit);
// :7691  ② 向前
MoveUpdatedComponent(Delta, PawnRotation, true, &Hit);
// ③ 向下扫回地面（StepTravelDownHeight），并计算 StepDownResult.FloorResult
// 任一步 bStartPenetrating 或失败 → ScopedStepUpMovement.RevertMove() 回到 OldLocation (:7685/:7699)

成功后 MoveAlongFloor 会用 StepDownResult.bComputedFloor 把新的 CurrentFloor 交给 PhysWalking，跳过重复 FindFloor（:5808-5811）。若 StepUp 失败则 HandleImpact + SlideAlongSurface 沿墙滑行（:5645-5646）。

4.2 走出边缘 → 转成 Falling

CheckFall（:5432）在 PhysWalking 检测到 !CurrentFloor.IsWalkableFloor() 时调用；bMustJump 或 CanWalkOffLedges() 为真则 HandleWalkingOffLedge + StartFalling。StartFalling（:5458）把剩余时间退还给 StartNewPhysics，并 SetMovementMode(MOVE_Falling)（:5474）。反方向由 ProcessLanded（:6413）/ SetPostLandedPhysics（:6452）把 Falling 转回 Walking。

05DS：权威世界重放

服务器不信任客户端上报的位置，只信任输入。它用同一套 PerformMovement → PhysWalking 在自己的世界里把这段输入重放一遍，因此贴地结果与 1P 同源但更权威。

ServerMovePacked_ServerReceive                          :9949
  └─ ServerMove_HandleMoveData                           :9994
       └─ ServerMove_PerformMovement (Old/Pending/New)   :10033
            ├─ VerifyClientTimeStamp                     :10061 → :9442
            ├─ GetServerMoveDeltaTime                    :10088
            ├─ MoveAutonomous(TimeStamp, DeltaTime, Flags, Accel)  :10119 → :10730
            │    └─ PerformMovement(DeltaTime)          :10758 → :2790
            │         └─ StartNewPhysics → PhysWalking  :3057 / :3554 / :5692
            └─ ServerMoveHandleClientError (仅 NewMove) :10130 → :10254

换句话说：1P 与 DS 跑的是同一个 PhysWalking 函数、同一组 FindFloor/AdjustFloorHeight 常量。差别只在两端世界的碰撞/其它角色状态不同，所以结果会有偏差——这正是 ServerMoveHandleClientError 要仲裁的东西。

服务器每帧的 GatherCurrentMovement（ActorReplication.cpp:438）把当前 ReplicatedMovement.Location 写进复制属性，其中 Z 就是服务器 AdjustFloorHeight 之后的权威贴地高度。ACharacter::GatherCurrentMovement（Character.cpp:1734）还会按需追加 Acceleration。这份数据以 COND_SimulatedOrPhysics 推给 3P（ActorReplication.cpp:593-596），主控端收不到它。

063P：SimulateMovement 贴地外推

3P 没有输入、没有 SavedMove。它先收服务器快照把 Capsule 放到权威位置，包间再用复制速度做有限外推，并用精简版的 FindFloor + AdjustFloorHeight 尽量贴地。

6.1 收包帧：先接受权威 Z

AActor::OnRep_ReplicatedMovement                  ActorReplication.cpp:186
  └─ ACharacter::PostNetReceiveLocationAndRotation  Character.cpp:2004
       ├─ bNetworkSmoothingComplete = false          :2019
       ├─ bJustTeleported |= (OldLocation != NewLocation)  :2020
       ├─ SmoothCorrection(Old, New)                  :2021 → CMC.cpp:8245
       └─ bNetworkUpdateReceived = true               :2024

SmoothCorrection 把 Capsule 直接 SetWorldLocationAndRotation(NewLocation, NewRotation)（:8326），差值记进 MeshTranslationOffset；Capsule 的 Z 此刻就是服务器贴地后的权威 Z。同帧 bNetworkUpdateReceived = true，下一帧 SimulateMovement 会据此处理 MovementMode / 重力 / Floor 刷新（:2249-2269）。

6.2 包间帧：SimulateMovement 的贴地链路

SimulateMovement:2208 的核心在 :2304-2417：

07网络快照与 Z 的关系

7.1 SmoothCorrection 如何不破坏贴地

SmoothCorrection:8245 用 FScopedPreventAttachedComponentMove 阻止 Mesh 跟随，只把 Capsule 移到 NewLocation（:8315 / :8326），把 OldLocation - NewLocation 累加到 MeshTranslationOffset（:8279-8297）。位移超过 MaxSmoothNetUpdateDist 会限幅、超过 NoSmoothNetUpdateDist 直接放弃平滑（:8289-8293）。所以贴地判定用的 Capsule 始终是权威位置，玩家眼睛看到的 Mesh 是被平滑后的视觉位置。

7.2 动画怎么读到这些

动画蓝图通过 TryGetPawnOwner() 读 Velocity / MovementMode（ReplicatedMovementMode → ApplyNetworkMovementMode）/ IsFalling()；ACharacter 用 Mesh->PrimaryComponentTick.AddPrerequisite(CharacterMovement, ...)（Character.cpp:152-156）保证动画在移动组件之后更新。贴地修正带来的小幅 Z 抖动不会改变 MovementMode，动画状态机因此保持稳定。

081P vs 3P 贴地对照表

09关键变量与 CVar 速查

10PX 项目差异

本文前 9 章讲的是引擎原生。PX 项目在 UGPCharacterMovementComponent 里对贴地链路做了明显的性能化改造，其中最重要的一条是：3P 的本地贴地被整体移除。

口径提醒：白皮书 03_Movement_Technical_Whitepaper.md §5.1/§5.2 含示意性伪代码（如 PhysUpdateOnSimulatedProxy、InterpolatePosition），不能当引擎实现引用；本文一律以 F:\PX_Trunk\UE 的源码行号为准。项目侧文件在分析期间被并发编辑，行号以函数名为准。

11函数索引与代码位置

除特别注明外，行号均位于 F:\PX_Trunk\UE\Engine\Source\Runtime\Engine\Private\Components\CharacterMovementComponent.cpp（14103 行）。