自动关联目录：关卡与 World 流转

"切场景"在 UE 里不是一个动作，而是两类机制：换 World（Travel）与在当前 World 里加载/卸载子关卡（Level Streaming）。选错会出现"玩家数据丢了"或"卡顿"。

一句话定位：要换规则换玩家 → Travel；要无感地拼接大世界 → Streaming。而 Travel 又分"无缝"和"硬切"，区别是玩家对象是否保留。

三种手段

非无缝 Travel

UGameplayStatics::OpenLevel(GetWorld(), FName("/Game/Maps/Forest"));     // 单机/客户端
GetWorld()->ServerTravel(TEXT("/Game/Maps/Forest?listen"));              // 服务端带所有客户端走

流程：断开 → 卸载 World → 加载新 World → 重新登录（走一遍 PreLogin / PostLogin）。

所有玩家状态都会丢，除非你自己写到 GameInstance 或存档里。

无缝 Travel

// GameMode 开启
AMyGameMode::AMyGameMode()
{
    bUseSeamlessTravel = true;
}

// 触发
GetWorld()->ServerTravel(TEXT("/Game/Maps/Forest"), /*bAbsolute=*/false, /*bShouldSkipGameNotify=*/false);

关键回调：

// GameMode：玩家在新关卡就位
virtual void HandleSeamlessTravelPlayer(AController*& C) override;

// PlayerController：跨关卡保留的数据
virtual void GetSeamlessTravelActorList(bool bToEntry, TArray<AActor*>& ActorList) override;

默认除了 Controller 和 PlayerState，其它 Actor 都不会跟着走。想带上某个 Actor（比如玩家的背包实体），要在 GetSeamlessTravelActorList 里显式加入。

Transition Map

无缝 Travel 中间会加载一个过渡关卡（TransitionMap，默认是个空场景）来顶住加载时间。

[/Script/EngineSettings.GameMapsSettings]
TransitionMap=/Game/Maps/Transition

忘了配 TransitionMap，无缝 Travel 会退化成硬切，表现为"说好的保留玩家数据怎么没了"。

Level Streaming

// 蓝图/C++ 加载子关卡
UGameplayStatics::LoadStreamLevel(GetWorld(), FName("Forest_East"), true, false, FLatentActionInfo());
UGameplayStatics::UnloadStreamLevel(GetWorld(), FName("Forest_East"), FLatentActionInfo());

Streaming 是异步的，加载完成前不能假设关卡里的 Actor 存在——要等回调或 OnLevelLoaded。

后台加载与卡顿

UGameplayStatics::LoadStreamLevel(World, Name, /*bMakeVisibleAfterLoad=*/true,
                                  /*bShouldBlockOnLoad=*/false, LatentInfo);

客户端-服务端一致性

// 客户端回到主菜单
PC->ClientTravel(TEXT("/Game/Maps/MainMenu"), ETravelType::TRAVEL_Absolute);

排查

常见坑