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 | 已补充 |
阅读顺序
| 顺序 | 笔记 | 为什么先读这个 |
|---|---|---|
| 1 | Actor 生命周期 | 不知道"哪个阶段能访问什么",后面全是玄学 |
| 2 | Pawn / Controller / PlayerState | 框架的核心分工 |
| 3 | AGameModeBase + 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 回调 |
许可协议:CC BY
作者:Davids
本文链接:https://hustjjd.github.io/21270d9e.html
更新于:2026年11月16日