Framwork

自动关联目录:Framwork

Gameplay 框架是一套约定好的角色分工。它不强制你用什么,但它的存在感在于网络:哪些类存在于哪些端,直接决定状态该往哪放。

类与存在端

类服务端客户端数量
AGameModeBase✓✗1
AGameStateBase✓✓1
APlayerController✓仅拥有者每玩家 1
APlayerState✓✓每玩家 1
APawn / ACharacter✓✓每角色 1

本目录

笔记内容状态
AGameModeBase规则层:只在服务端已补充
AGameStateBase全局状态层:需要复制已补充
Actor 生命周期与 Tick 顺序各阶段能做什么、Tick 分组与依赖已补充
Pawn 与 Controller 与 PlayerState意图 / 能力 / 身份的分离已补充
组件与世界组件类型选择、注册、World 与 Level 层次已补充
关卡与 World 流转Travel、无缝旅行、Level Streaming已补充

阅读顺序

顺序笔记为什么先读这个
1Actor 生命周期不知道"哪个阶段能访问什么",后面全是玄学
2Pawn / Controller / PlayerState框架的核心分工
3AGameModeBase + AGameStateBase规则与全局状态
4组件与世界写代码时天天用
5关卡与 World 流转做多关卡/大世界时再读

如果只有十分钟:第 2 篇的分工表。它决定了"数据该放哪",而这个决定错了会一路返工。

一次登录发生了什么

客户端连接
  → GameMode::PreLogin(能否登录)
  → GameMode::Login(创建 PlayerController)
  → GameMode::PostLogin(生成 Pawn、初始化)
  → PlayerController::BeginPlay / OnPossess
阶段该做的事
PreLogin校验、拒绝(如满员、封禁)
Login一般不用改
PostLogin生成角色、初始化玩家数据、加入队伍
HandleStartingNewPlayer / RestartPlayer重生/复活流程

常用扩展点

需求改哪里
换角色/换出生点GameMode::ChoosePlayerStart / SpawnDefaultPawnFor
自定义胜负GameMode::CheckMatchState / 自己维护状态机
全局倒计时/比分GameState 里的复制属性
玩家个人信息PlayerState
输入绑定PlayerController::SetupInputComponent + UInputMappingContext(Enhanced Input)
切换操控对象Controller::Possess / UnPossess

实践建议

  • GameMode 只放规则,不放需要显示的数据
  • 所有玩家都能看到的状态放 GameState,只和自己有关的放 PlayerState
  • Controller 负责"我想做什么",Pawn 负责"我做得到吗"——能力判定(能不能开火)应该在 Pawn/Ability 层做,Controller 只发意图
  • 跨端一致性靠复制,不靠双方各算一遍

常见坑

坑说明
在客户端访问 GetGameMode()返回 nullptr,因为 GameMode 不在客户端
在 BeginPlay 里假设 GameState 已就绪顺序不保证,用 OnRep 或延迟初始化
把 HUD 逻辑写在 Pawn 里远程 Pawn 也会跑,应放 Controller 或本地 UI
Possess 后立刻用 Pawn 的成员要等 OnPossess / PawnChanged 回调