原生 UE 角色移动同步全流程
主控端 → DS → 3P 模拟端

00一句话总览

UE 的角色移动不是"服务器算好位置发给所有人"，而是三端各自承担不同职责的一条闭环流水线：主控端不等服务器、先按输入自己动并保存每次移动的"存档"；DS 收到输入后在权威世界里重放同一段移动，判断客户端算得对不对；3P 端只接收 DS 定期广播的权威快照，用网格偏移把离散快照补成连续画面。

01动画沙盘：一次移动的三端旅程

下面的动画按真实调用顺序逐步演示一帧输入从主控端出发、经过 DS、最终落在 3P 与角色动画上的全过程。点击「单步」逐阶段观察；调大「位置误差」会触发服务器纠正分支；切换「平滑模式」可看到 3P 曲线的变化。

02三端角色与设计动机

先厘清一个最容易混淆的点：Role 描述的是"某台机器上这一份 Actor 副本的权限"，不是"这个角色属于谁"。同一个玩家角色，在 owning client、DS、以及另外 9 个客户端上各有一份独立的 Actor 实例，三份实例的 GetLocalRole() 完全不同，因此同一个 UCharacterMovementComponent::TickComponent 会走进三个不同的分支。

2.1 一帧之内，三份副本各自走哪个分支

入口都是 UCharacterMovementComponent::TickComponent（CharacterMovementComponent.cpp:1663）。它先 ConsumeInputVector() 取输入，再按 LocalRole 分流：

// CharacterMovementComponent.cpp:1745-1808（节选，行为概述）
if (CharacterOwner->GetLocalRole() > ROLE_SimulatedProxy)      // Authority 或 AutonomousProxy
{
    const bool bIsClient = (LocalRole == ROLE_AutonomousProxy && IsNetMode(NM_Client));
    if (bIsClient && ClientData && ClientData->bUpdatePosition)
        ClientUpdatePositionAfterServerUpdate();               // 收到纠正后，回滚 + 重放

    if (bShouldPerformControlledCharMove)                       // 本地受控
        ControlledCharacterMove(InputVector, DeltaTime);        // → ReplicateMoveToServer → PerformMovement
    else if (RemoteRole == ROLE_AutonomousProxy)
        ServerAutonomousProxyTick(DeltaTime);                   // DS 上远程客户端角色的中间帧补偿
}
else if (CharacterOwner->GetLocalRole() == ROLE_SimulatedProxy) // 3P
{
    SimulatedTick(DeltaTime);                                   // 跟随快照 / 有限外推 / RootMotion
}

2.2 为什么必须这样设计

2.3 一次输入的完整数据流（文字版）

[主控端 / AutonomousProxy]                         [DS / Authority]                     [其他客户端 / SimulatedProxy]
 输入 → ConsumeInputVector                          
   │                                                 
   ├─ ControlledCharacterMove                         
   │    └─ ReplicateMoveToServer                      
   │         ├─ UpdateTimeStampAndDeltaTime           
   │         ├─ CreateSavedMove / SetMoveFor          
   │         ├─ (可合并) CombineWith(PendingMove)     
   │         ├─ PerformMovement  ← 本端立即动        
   │         ├─ PostUpdate → SavedMoves.Push          
   │         └─ CallServerMovePacked                  
   │              └─ ClientFillNetworkMoveData         
   │                   └─ ServerMovePacked ───▶ ACharacter::ServerMovePacked_Implementation
   │                        (unreliable RPC)     └─ ServerMovePacked_ServerReceive
   │                                               ├─ MoveDataContainer.Serialize（反序列化）
   │                                               └─ ServerMove_HandleMoveData
   │                                                    └─ ServerMove_PerformMovement（Old/Pending/New）
   │                                                         ├─ VerifyClientTimeStamp
   │                                                         ├─ GetServerMoveDeltaTime
   │                                                         ├─ MoveAutonomous → PerformMovement
   │                                                         └─ ServerMoveHandleClientError（仅 NewMove）
   │                                                              ├─ OK  → ServerSendMoveResponse → ClientAckGoodMove
   │                                                              └─ 超限 → ClientAdjustPosition → 回滚 + 重放
   │                                           （独立通道）GatherCurrentMovement → ReplicatedMovement
   │                                             (属性复制, NetUpdateFrequency) ──────▶ OnRep_ReplicatedMovement
   │                                                                                                    ├─ PostNetReceiveVelocity
   │                                                                                                    ├─ PostNetReceiveLocationAndRotation
   │                                                                                                    │    └─ SmoothCorrection
   │                                                                                                    ├─ SmoothClientPosition（逐帧）
   │                                                                                                    └─ SimulatedTick / 动画更新

注：Listen Server 上本机玩家的 Actor 同时是 Authority 且本地受控，属于特殊路径（TickComponent:1773 的 bIsaListenServerAutonomousProxy 分支）；本文以 Dedicated Server 为主线。

03主控端：本地预测与 SavedMove

主控端（ROLE_AutonomousProxy）的唯一目标：不等服务器，本帧就把按键变成位移，同时把这次移动完整地"存档"，以便服务器说"你算错了"时能回滚重来。全部逻辑集中在 TickComponent → ControlledCharacterMove → ReplicateMoveToServer。

3.1 一帧内的调用链

Tick 依赖（决定顺序的前提）：AController::AddPawnTickDependency（Controller.cpp:495-517，关键 :503）把 Pawn 移动组件的 Tick 排在 PlayerController 之后，保证「先采集输入、后 ConsumeInputVector 消费」；ACharacter 又把 Mesh 的 Tick 排在移动组件之后（Character.cpp:152-156），保证动画读到的是本帧已更新的速度。

APlayerController::PlayerTick / ProcessPlayerInput / UpdateRotation
  └─ ACharacter::AddMovementInput → PendingMovementInputVector
       └─ UCharacterMovementComponent::TickComponent                    :1663
            ├─ ConsumeInputVector()                                     :1676
            ├─ [AutonomousProxy && NM_Client] bUpdatePosition ?
            │    └─ ClientUpdatePositionAfterServerUpdate()             :1753（见第 8 章）
            └─ ControlledCharacterMove(InputVector, DeltaTime)          :1771 → :6481
                 ├─ CheckJumpInput / ScaleInputAcceleration /
                 │    ConstrainInputAcceleration / ComputeAnalogInputModifier :6488-6492
                 └─ ReplicateMoveToServer(DeltaTime, Acceleration)       :6501 → :8968
                      ├─ UpdateTimeStampAndDeltaTime                     :8999 → :8922
                      ├─ 找 OldMove（IsImportantMove）                    :9001-9017
                      ├─ CreateSavedMove / SetMoveFor                     :9020-9027
                      ├─ CanCombineWith → CombineWith(PendingMove)        :9032-9071
                      ├─ Acceleration 钳制（与服务器一致）                :9084
                      ├─ PerformMovement(NewMove->DeltaTime)  ← 本端立即动 :9090
                      ├─ PostUpdate → SavedMoves.Push                     :9092-9098
                      ├─ CanDelaySendingMove / GetClientNetSendDeltaTime  :9100-9113
                      └─ CallServerMovePacked 或 CallServerMove            :9150-9157

3.2 逐步详解

3.3 FSavedMove_Character 里到底存了什么

3.4 三条容易忽略的规则

3.5 关键代码（可直接对照源码）

// CharacterMovementComponent.cpp:6495-6502 —— 三端分流的起点
if (CharacterOwner->GetLocalRole() == ROLE_Authority)
{
    PerformMovement(DeltaSeconds);
}
else if (CharacterOwner->GetLocalRole() == ROLE_AutonomousProxy && IsNetMode(NM_Client))
{
    ReplicateMoveToServer(DeltaSeconds, Acceleration);
}

// :9083-9098 —— 钳加速度 → 本地预测 → 存档
Acceleration = NewMove->Acceleration.GetClampedToMaxSize(GetMaxAcceleration());
AnalogInputModifier = ComputeAnalogInputModifier();
CharacterOwner->ClientRootMotionParams.Clear();
CharacterOwner->SavedRootMotion.Clear();
PerformMovement(NewMove->DeltaTime);          // ← 本端画面立即响应
NewMove->PostUpdate(CharacterOwner, FSavedMove_Character::PostUpdate_Record);
if (CharacterOwner->IsReplicatingMovement())
{
    ClientData->SavedMoves.Push(NewMovePtr);
}

04上行：ServerMove 家族与打包

UE 5.8 有两套并存的移动 RPC。默认（p.NetUsePackedMovementRPCs = 1）走 Packed 路径；把它设为 0 才会回退到已标记 DEPRECATED 的老接口。看代码时若只盯着 ServerMove，会以为参数就是那 9 个固定字段——实际上现在的载荷是一个可序列化的位流容器，项目也正是在这一层做扩展的。

4.1 两条路径对照

4.2 Packed 路径：从 SavedMove 到网络位流

4.3 FCharacterNetworkMoveData 字段速查

4.4 冗余设计：为什么一个包里装三段 move

// CharacterMovementComponent.cpp:9825-9860（节选，序列化顺序）
NewMoveData->Serialize(...);                    // 本次 move，必发
Ar.SerializeBits(&bHasPendingMove, 1);          // 节流暂存的上一帧 move
if (bHasPendingMove) { ...PendingMoveData->Serialize(...); }
Ar.SerializeBits(&bHasOldMove, 1);              // 未确认的"重要 move"，丢包冗余
if (bHasOldMove)     { ...OldMoveData->Serialize(...); }
Ar.SerializeBits(&bDisableCombinedScopedMove, 1);

05DS：校验、重放与纠错

DS（ROLE_Authority）不信任客户端的位置，只信任客户端的输入：它用同一套 PerformMovement 在自己的世界里把这段输入重放一遍，再拿重放结果与客户端自报位置比对，决定"通过"还是"纠正"。

5.1 收包与反序列化

5.2 时间戳校验（第一道闸门）

ServerMove_PerformMovement:10033 先取出 TimeStamp / Acceleration / CompressedMoveFlags / ControlRotation，把 base 相对加速度转回世界空间（:10045-10053），然后调用 VerifyClientTimeStamp（:10061 → :9442）：

• IsClientTimeStampValid 判断是否过期 / 乱序 / 超前；不合法直接 return，只打日志（:9450, :9486-9501, :10063-10073）。
• 检测到时间戳重置时同步扣减 MinTimeBetweenTimeStampResets，并把重置应用到活跃的 RootMotion（:9453-9465）。
• 合法且非重置时进入 ProcessClientTimeStampForTimeDiscrepancy（:9483 → :9504）：用 ClientDelta - ServerDelta 累积时间漂移，配合 AGameNetworkManager 的 MovementTimeDiscrepancy* 参数做检测与"偿还"，防止客户端改时钟加速（默认关闭，见第 11 章）。
• PC->NotifyServerReceivedClientData 判定服务器是否就绪；未就绪则把加速度清零（:10076-10085）。

5.3 权威重放（第二道闸门：物理一致性）

// :10088-10119（节选）
const float DeltaTime = ServerData->GetServerMoveDeltaTime(ClientTimeStamp, ...);
ServerData->CurrentClientTimeStamp = ClientTimeStamp;
ServerData->ServerAccumulatedClientTimeStamp += DeltaTime;
ServerData->ServerTimeStamp = MyWorld->GetTimeSeconds();
CharacterController->SetControlRotation(ClientControlRotation);
PC->UpdateRotation(DeltaTime);
MoveAutonomous(ClientTimeStamp, DeltaTime, ClientMoveFlags, ClientAccel);  // :10119

// :10743-10758 —— MoveAutonomous 内部
UpdateFromCompressedFlags(CompressedFlags);
CharacterOwner->CheckJumpInput(DeltaTime);
Acceleration = ConstrainInputAcceleration(NewAccel);
Acceleration = Acceleration.GetClampedToMaxSize(GetMaxAcceleration());   // 与客户端 :9084 对称
PerformMovement(DeltaTime);                                             // 权威世界里重放

GetServerMoveDeltaTime（调用点 :10208 / :10088，实现 :12695-12710，含时间差异 override 与 p.NetServerMaxMoveDeltaTimeScalar = 1.75 的放宽）用相邻客户端时间戳之差而不是服务器帧长来还原 DeltaTime，这样即使包到达不均匀，服务器重放的物理步长也与客户端本地预测一致。MoveAutonomous（:10730）在 PerformMovement 之后还会 TickCharacterPose(DeltaTime)（:10766-10787），让服务器上的动画事件、状态机与客户端保持同步；Listen Server 上还会对远端角色调用 SmoothCorrection（:10791-10797）。

5.4 误差判定：Good Move 还是 Correction

ServerMoveHandleClientError（:10254，由 :10130 调用）把客户端自报位置从 base 相对坐标还原到世界坐标（:10279-10288），与服务器重放后的 ServerLoc（:10290）比较。中间还有一段"落地/离地信任窗口"逻辑：由 p.ClientAuthorityThresholdOnBaseChange 与 p.MaxFallingCorrectionLeash 控制，在跳跃离开/落回移动平台时允许暂时信任客户端，避免突兀纠正（:10307-10458）。

另外 ServerMoveHandleClientError 开头有更新频率节流（WithinUpdateDelayBounds，:10270-10277），SendClientAdjustment 里还有 NetworkMinTimeBetweenClientAdjustments* 节流，避免每个包都触发纠正风暴。

5.5 响应如何发出（第 8 章的入口）

SendClientAdjustment（:11121）并非在误差判定里立即发送：ServerMoveHandleClientError 只把裁决写入 ServerData->PendingAdjustment，真正的下发在服务器帧末复制阶段，由 APlayerController::SendClientAdjustment()（PlayerController.cpp:1924-1937）转发到移动组件。进入后：若 PendingAdjustment.TimeStamp <= 0 直接 return；bAckGoodMove = true 走确认节流后 ServerSendMoveResponse（:10887）或老 ClientAckGoodMove；否则走纠正节流，packed 路径同样 ServerSendMoveResponse，老路径则按 RootMotion 状态分派到 ClientAdjustPosition / ClientAdjustRootMotionPosition / ClientAdjustRootMotionSourcePosition（:11166-11215）。无论哪条路径，最终都是一个 FClientAdjustment 结构被打包送回 owning client。

06下行：ReplicatedMovement 属性复制

这一章是最容易被忽略、却决定 3P 表现的一环：DS 对主控端的 Ack/纠正走的是 RPC，而对所有客户端（含主控端自己）的权威状态走的是属性复制。两条通道彼此独立、节拍不同、载荷不同。

6.1 服务器如何生成复制数据

6.2 FRepMovement 里装了什么

6.3 谁会收到这份数据

6.4 随包附带的"平滑时间基准"

除了位置本身，ACharacter 还复制 ReplicatedServerLastTransformUpdateTimeStamp（Character.h:555-557），由 p.NetUseClientTimestampForReplicatedTransform 决定用客户端时间戳还是服务器 tick 时间生成（CMC.cpp:211-218）。3P 的 SmoothCorrection 把它写入 SmoothingServerTimeStamp（:8344-8349），让插值进度基于服务器时间，从而抵抗包到达间隔抖动。Linear 模式下还会强制每帧更新时间戳（Character.cpp:2111）。

6.5 上行 RPC 与下行复制的对照

073P 模拟端：接收与网络平滑

3P 模拟端（ROLE_SimulatedProxy）没有输入、没有 SavedMove，只有一串离散的权威位置快照。UE 的做法是：Capsule 立即跳到权威位置（保证逻辑位置正确），Mesh 留在原来的视觉位置（保证画面连续），再把两者的差值记进 MeshTranslationOffset，逐帧衰减到 0。

7.1 收包 → RepNotify → OnRep 的完整链条

UActorChannel / FObjectReplicator 收到属性 bunch
  ├─ AActor::PreNetReceive() / PostNetReceive()          ActorReplication.cpp:152
  │    └─ ACharacter::PreNetReceive / PostNetReceive    Character.cpp:1639 / :1646
  │         └─ 比较 MovementMode / GravityDirection 变化
  │              → bNetworkMovementModeChanged / bNetworkGravityDirectionChanged
  │              → bNetworkUpdateReceived = true          :1650-1652
  └─ RepNotify: ACharacter::OnRep_ReplicatedMovement    Character.cpp:1754
       └─ 若没有在播 RootMotion Montage / Source → Super::OnRep_ReplicatedMovement()
            └─ AActor::OnRep_ReplicatedMovement          ActorReplication.cpp:186
                 ├─ IsReplicatingMovement() 守卫           :191-194
                 ├─ SyncReplicatedPhysicsSimulation（bRepPhysics 变化时）
                 ├─ RootComponent->OnReceiveReplicatedState :237
                 └─ [LocalRole == ROLE_SimulatedProxy && 无 AttachParent]
                      ├─ PostNetReceiveVelocity(LinearVelocity)   :277
                      └─ PostNetReceiveLocationAndRotation()      :278
                           └─ ACharacter::PostNetReceiveLocationAndRotation  Character.cpp:2004
                                ├─ bNetworkSmoothingComplete = false       :2019
                                ├─ bJustTeleported |= 位置变化              :2020
                                ├─ SmoothCorrection(OldLoc, OldRot, NewLoc, NewRot) :2021
                                ├─ OnUpdateSimulatedPosition(...)          :2022
                                └─ bNetworkUpdateReceived = true           :2024

7.2 SmoothCorrection：一次快照到来时做什么

CMC.cpp:8245。开头断言只应跑在客户端代理上（checkSlow(GetNetMode() != NM_DedicatedServer)，:8254），并置 bNetworkSmoothingComplete = false。

7.3 SmoothClientPosition：之后每帧做什么

CMC.cpp:8426 = SmoothClientPosition_Interpolate（:8450）+ SmoothClientPosition_UpdateVisuals（:8600）。

// :8654-8657 —— Exponential 模式把偏移写回 Mesh（Capsule 不动）
const FVector NewRelTranslation =
    (UpdatedComponent->GetComponentToWorld().InverseTransformVectorNoScale(
         ClientData->MeshTranslationOffset) / MeshParentScale)
    + CharacterOwner->GetBaseTranslationOffset();
const FQuat NewRelRotation =
    ClientData->MeshRotationOffset * CharacterOwner->GetBaseRotationOffset();
Mesh->SetRelativeLocationAndRotation(NewRelTranslation, NewRelRotation, ...);

Linear 模式的 UpdateVisuals（:8607-8642）还会直接改写 Capsule 的相对旋转，使旋转插值与 Mesh 位移协调。这份引擎源码在 :8623-8633 有一段 PX 项目的性能优化注释（绕过胶囊子类的异步物理覆写），属于插桩/优化，不改变上述语义。

7.4 SimulatedTick / SimulateMovement：帧间怎么"活起来"

两次快照之间，3P 也不能完全静止。TickComponent:1798-1808 走 SimulatedTick（:1898），常规情况下进入 SimulateMovement（:2208）：

• bNetworkUpdateReceived 门控：仅在收到新更新的那一帧应用 ReplicatedGravityDirection、ApplyNetworkMovementMode(GetReplicatedMovementMode())（:2249-2265, :2262），否则只处理 bForceNextFloorCheck 的地面刷新。
• 使用复制来的 FRepMovement::LinearVelocity 做有限外推；若 bSimGravityDisabled 或"在地面且复制速度为零"（:2292-2300），直接把 Velocity 清零，避免在没有后续更新时越滑越远。
• 与主控端不同：这里不消费输入、不生成 SavedMove、不调用 PerformMovement，也不做完整的预测重放；p.NetEnableSkipProxyPredictionOnNetUpdate 还能让收到网络更新的那一帧干脆跳过预测（CMC.cpp:143-150）。
• RootMotion 是例外分支：SimulatedTick:1903-1968 先 TickCharacterPose 再 SimulateRootMotion，并在需要时调用 SimulatedRootMotionPositionFixup（Character.cpp:1821）做位置修正。

7.5 网络平滑关键变量速查

08闭环：Ack / 纠正与回滚重放

到这里，流水线要闭环回到主控端：DS 的裁决（"这次预测对了"或"错了"）必须送回主控端，主控端据此丢弃存档、或回滚后重放。这一步决定了"客户端预测"是否真的自洽。

8.1 两条响应路径

两条路径都受节流保护：确认有 NetworkMinTimeBetweenClientAckGoodMoves（:11140），纠正有 NetworkMinTimeBetweenClientAdjustments*（:11157-11163）；大纠正用更短的间隔。

8.2 Good Move：丢弃已确认的存档

// :11706-11737
void UCharacterMovementComponent::ClientAckGoodMove_Implementation(float TimeStamp)
{
    FNetworkPredictionData_Client_Character* ClientData = GetPredictionData_Client_Character();
    int32 MoveIndex = ClientData->GetSavedMoveIndex(TimeStamp);
    if (MoveIndex == INDEX_NONE) return;   // 找不到（已过期）就忽略
    ClientData->AckMove(MoveIndex, *this); // :12620 —— 把该 move 及之前全部移出 SavedMoves
}

AckMove（:12620）把 SavedMoves 中时间戳 ≤ 本次 Ack 的全部 move 移入 FreeMoves 复用池，并更新 LastAckedMove。此后客户端的预测队列只保留服务器尚未确认的部分，这既控制了内存，也让 IsImportantMove / OldMove 的选取始终有意义。

8.3 Correction：接受权威状态，标记"下帧回滚"

ClientAdjustPosition_Implementation（:11295）做的事情按顺序是：

1. 守卫 HasValidData / IsActive（:11308）；若 bClientIgnoreMovementCorrections 为真，只 AckMove 修剪队列而不改位置（:11313-11329）。
2. 解析 movement base；若 base 在本端尚未生成且位置是相对坐标，忽略这次纠正（:11334-11343）。
3. 按时间戳找到对应 move 并 AckMove（:11361）——纠正也会先丢弃已确认的旧存档，剩下的才是需要重放的。
4. 把服务器的 NewLoc / NewVel / MovementMode / Base / Rotation 应用到角色（接受权威状态），最后 ClientData->bUpdatePosition = true（:11451）。

8.4 回滚 + 重放：ClientUpdatePositionAfterServerUpdate

// :8667-8752（结构节选）
if (!ClientData->bUpdatePosition) return false;
ClientData->bUpdatePosition = false;
if (ClientData->SavedMoves.Num() == 0) { /* 无需重放 */ return false; }

// 备份会被重放改写的状态
const float SavedAnalogInputModifier = AnalogInputModifier;
const FRootMotionMovementParams BackupRootMotionParams = RootMotionParams;
const bool bRealPressedJump = CharacterOwner->bPressedJump; ...
CharacterOwner->bClientUpdating = true;
bForceNextFloorCheck = true;
FScopedMeshMovementUpdate ScopedMeshUpdate(...);   // 合并所有 Mesh 变换，避免抖动

for (int32 i = 0; i < ClientData->SavedMoves.Num(); i++)
{
    FSavedMove_Character* const CurrentMove = ClientData->SavedMoves[i].Get();
    SetCurrentReplayedSavedMove(CurrentMove);
    CurrentMove->PrepMoveFor(CharacterOwner);        // 恢复该 move 的输入状态
    if (ShouldUsePackedMovementRPCs()) { ...ClientFillNetworkMoveData(*CurrentMove, NewMove); }
    MoveAutonomous(CurrentMove->TimeStamp, CurrentMove->DeltaTime,
                   CurrentMove->GetCompressedFlags(), CurrentMove->Acceleration);  // :8747
    CurrentMove->PostUpdate(CharacterOwner, PostUpdate_Replay);
}
// 之后恢复备份的输入 / Jump / Crouch / RootMotion 状态（:8760+）

函数还会备份/恢复 AnalogInputModifier、RootMotion、bPressedJump、bWantsToCrouch、bForceMaxAccel 等状态（:8709-8717, :8760+），并给 PendingMove 打上 bForceNoCombine（:8755-8758），防止重放后的 move 被错误合并。若无 SavedMoves 可重放则直接返回（:8691-8707）。

8.5 完整闭环（把三端连起来）

① 1P 输入 → 本地预测（领先）
② SavedMove 存档 + ServerMovePacked 上行
③ DS 校验/重放 → ④ 判定 Good / Correction
        ┌───────────────┴────────────────┐
        ▼                                ▼
⑤A Ack → 丢弃已确认 SavedMoves     ⑤B ClientAdjustPosition → 置 bUpdatePosition
                                        ▼
                          ⑥ 下帧 ClientUpdatePositionAfterServerUpdate
                             回滚到权威位置 + 重放剩余 SavedMoves
        └──────────────────────┬───────────────────────────┘
                               ▼
              ⑦ DS 同时按 NetUpdateFrequency 广播 ReplicatedMovement
              ⑧ 3P 收 OnRep → SmoothCorrection → 逐帧平滑 → 动画更新

09动画系统：3P 角色姿态从哪来

「动画支持」在这份文档里有两层含义，本章讲的是第二层：
(a) 文档动画：第 1 章的交互式沙盘用 SVG/JS 动画演示数据流动、纠正分支与平滑衰减；(b) 引擎动画系统：3P 上的角色动画蓝图如何拿到移动数据并正确播放走/跑/跳/RootMotion。两层都覆盖，避免歧义。

9.1 动画蓝图能读到哪些"网络来的"数据

动画蓝图并不直接读网络包。它读的是本端 ACharacter / UCharacterMovementComponent 上的运行时状态，而这些状态在 3P 上由复制属性与 SimulateMovement 填充：

9.2 Tick 顺序：先动 Capsule，再更新骨骼

1. UCharacterMovementComponent::TickComponent（CMC.cpp:1663）用 FScopedMeshMovementUpdate（:1801）把 Mesh 的子更新推迟到所有移动完成之后，避免一阵抖动。
2. 3P 分支调 SimulatedTick（:1898）；常规路径 SimulateMovement 更新 Velocity / MovementMode / 位置。
3. SmoothClientPosition 在每帧把 MeshTranslationOffset 写成 Mesh 的相对变换（:8600-8663）。
4. 动画更新与 Tick 依赖：ACharacter 在构造时用 Mesh->PrimaryComponentTick.AddPrerequisite(CharacterMovement, ...) 强制动画在移动组件之后 tick（Character.cpp:152-156，注释原文 "force animation tick after movement component updates"），因此动画蓝图读到的是本帧已经更新过的 Velocity / MovementMode。USkeletalMeshComponent::TickPose → TickAnimation → UAnimInstance::UpdateAnimation（AnimInstance.cpp:671）依次执行 NativeUpdateAnimation(:795) 与 BlueprintUpdateAnimation(:800)，AnimBP 在后者通过 TryGetPawnOwner() 自行读取 Pawn 的速度与状态——引擎内并没有 UCharacterAnimInstance，也没有内建的 Velocity / IsFalling 属性。播放 RootMotion 时，SimulatedTick 会显式先 TickCharacterPose(DeltaSeconds) 再 SimulateRootMotion（:1909-1929），保证动画先产生根运动位移、物理再消费它。DS 重放时 MoveAutonomous 也会 TickCharacterPose（:10766-10787），让两端动画事件/状态机同步。
5. ACharacter::PostNetReceive（Character.cpp:1646）在收到 bunch 时预置 bNetworkMovementModeChanged 等标志，供下一帧 SimulateMovement 消费。

9.3 RootMotion：一条独立的位置通道

RootMotion 由动画驱动位置，无法靠"加速度 + 速度"还原，因此 UE 单独复制：

• 服务器 ACharacter::PreReplication（Character.cpp:2028+）在 CurrentRootMotion.HasActiveRootMotionSources() 或播放网络 RootMotion Montage 时填充 FRepRootMotionMontage（位置、是否相对 base、Montage 位置、AuthoritativeRootMotion 等）。
• 3P 端 OnRep_RootMotion（Character.cpp:1786）把快照压入 RootMotionRepMoves 队列（:1800+）。
• SimulatedTick 在 root motion 分支里 TickCharacterPose → SimulateRootMotion → SimulatedRootMotionPositionFixup（CMC.cpp:1903-1955、Character.cpp:1821），用服务器快照修正本地动画推进的位置，并清空已消费队列（CMC.cpp:2000-2002）。
• 有网络 RootMotion 时，ACharacter::OnRep_ReplicatedMovement 跳过标准位置修正（Character.cpp:1756-1763），避免两套位置源打架；ACharacter::PostNetReceiveLocationAndRotation 也在 UseRelativeLocation 时跳过 SmoothCorrection（:2012）。
• 纠正包也区分 RootMotion：ClientHandleMoveResponse 按 bRootMotionSourceCorrection / bRootMotionMontageCorrection 分派到不同的 ClientAdjust*_Implementation（CMC.cpp:11050-11096）；Linear 平滑下 SimulatedTick:1957-1967 还会修正 MeshRotationTarget，防止旋转插值与根运动旋转冲突。

9.4 动画与网络平滑的边界

9.5 本文档提供的"动画支持"清单

10端到端时序与延迟构成

把一次按键放到时间轴上，就能看清"为什么 1P 和 3P 看到的永远不是同一帧"。下面所有时间点都以主控端采到输入为 t0，RTT 指主控端到 DS 的往返时延，NetUpdateInterval = 1 / NetUpdateFrequency。

10.1 端到端时间线

10.2 延迟构成（谁晚了多少）

10.3 三套时间戳，各管一段

10.4 丢包、乱序与抖动怎么被消化

1. 上行不可靠，但自带冗余：ServerMovePacked 是 unreliable RPC；ReplicateMoveToServer 在同一个容器里同时装 NewMove / PendingMove / OldMove（OldMove 取自未确认的"重要 move"，:9001-9017），丢一个包也能靠后续包补齐。
2. 合并与节流：CanCombineWith 允许把连续的相似 move 合成一个（:9032-9071）；CanDelaySendingMove + GetClientNetSendDeltaTime 把发送频率钳在 1/120 ~ 1/5 秒之间（:9100-9113），避免 60fps 每帧一个包。引擎还内置模拟丢包的调试 CVar（:9126-9144）。
3. DS 侧乱序：时间戳过期直接丢弃（:10175-10188），并用累积时间戳而不是到达顺序推进，避免"晚到的包把位置拉回去"。
4. 3P 侧抖动：平滑缓冲吸收到达间隔的波动；但当单次位移超过 MaxSmoothNetUpdateDist / NoSmoothNetUpdateDist 时（:8288-8298），会限制或清零 MeshTranslationOffset，宁可瞬移也不做长距离拉扯。

10.5 三个常见误解

11关键 CVar / 配置速查

以下取值均来自 F:\PX_Trunk\UE\Engine\Source\Runtime\Engine 源码中的定义（非记忆值），行号为该 CVar / 变量的定义处。标 Cheat 的只在非 Shipping 包可用，主要用于复现与调试本文描述的流程。

11.1 RPC 与打包（决定上行形态）

11.2 复制与平滑（组件 / Actor 属性，不是 CVar）

11.3 误差判定 / 时间漂移

11.4 调试 / 复现流程用的 Cheat CVar

12PX 项目落地差异

前 11 章讲的是引擎原生流程。PX 项目在 F:\PX_Trunk\PX\Source\GPFramework\GPGameplay\Character\Movement\ 下用 UGPCharacterMovementComponent : UCharacterMovementComponent 做了深度定制。本章只列与「主控端 → DS → 3P」链路直接相关的差异，便于读者把本文结论映射到本项目的实际代码。

12.1 五个最实质的差异

12.2 自定义网络数据结构（PXCharacterMovementTypes.h/.cpp）

12.3 3P 链路为什么被重写（与本文第 7 章对照读）

12.4 与链路相关的项目配置

Config 中未找到独立的 NetUpdateFrequency / MinNetUpdateFrequency / NetworkSmoothingMode / p.Net* 配置项：这些值走引擎默认或 C++ 构造函数 / CVar；Iris 侧的轮询频率由上述 net.* 开关与 ForceNetUpdate 决定。

12.5 项目内可继续深挖的资料

• PX\Docs\MovementSystem\01_GPMoveComp_Optimization_Analysis.md —— 网络同步优化 / SavedMove 扩展 / 模拟端优化（部分行号与性能数字已过时）。
• PX\Docs\MovementSystem\03_Movement_Technical_Whitepaper.md §4~§6 —— 数据流简图、技能预测窗口、NewSmoothCorrection、客户端权威位置；含示意代码，需与现网代码核对。
• PX\Docs\PerfExplore\3p-movesmooth-sweep-skip\ —— 最有价值的 3P 专题：01-clarify.md 关键事实 #1~#5、03-plan.md 结论台账、04-conclusion.md 水平扫掠对照结论，以及 README.md 标注的「未正式启用、未接生产 GP」状态。
• PX\Docs\MovementSystem\02_Mover_Migration_Plan.md —— 明确记录「自定义 CMC 预测 + 模拟端优化与 NetworkPrediction 插件不兼容，不建议迁移」，可解释项目为何坚持在这条原生链路上做扩展。

13附录：函数索引与代码位置

本章是全文的"代码地图"：所有行号均取自 F:\PX_Trunk\UE\Engine\Source\Runtime\Engine 的实际文件，便于对照源码逐行复核。缩写：CMC.cpp = Private\Components\CharacterMovementComponent.cpp，CMC.h = Classes\GameFramework\CharacterMovementComponent.h。

13.1 端到端函数索引

13.2 关键数据结构速查

13.3 涉及的主要源码文件

13.4 版本与口径说明