122 lines
5.3 KiB
Markdown
122 lines
5.3 KiB
Markdown
# PvPDemo
|
||
|
||
基于 Unreal Engine 5.7 的第三人称 PvP 对战 Demo，玩家与 AI Bot 在场景中拾取道具并相互攻击。项目以 **GAS（Gameplay Ability System）** 为核心战斗框架，结合行为树驱动 AI、MVVM 驱动 UI、DataTable 驱动配置，采用 C++ 与蓝图混合开发。
|
||
|
||
## 技术栈
|
||
|
||
- **引擎**：Unreal Engine 5.7
|
||
- **语言**：C++ / Blueprint
|
||
- **核心框架**：
|
||
- GameplayAbilities（GAS）
|
||
- AIModule + Behavior Tree
|
||
- StateTree / GameplayStateTree
|
||
- UMG + ModelViewViewModel（MVVM）
|
||
- EnhancedInput
|
||
- **第三方插件**：AdvancedSessions
|
||
|
||
## 目录结构
|
||
|
||
```
|
||
PvPDemo/
|
||
├── Config/ # 引擎与项目配置
|
||
├── Source/PvPDemo/ # C++ 源码模块
|
||
│ ├── Public/ Private/
|
||
│ │ ├── PvPDemoCharacter.* # 玩家角色（含 ASC / AttributeSet）
|
||
│ │ ├── BotCharacter.* # AI Bot 角色（含 ASC / AttributeSet）
|
||
│ │ ├── MainAttributeSet.* # 属性集
|
||
│ │ ├── MainAbilitySystemComponent.*
|
||
│ │ ├── MainGameState.* MainPlayerState.* MainHUD.*
|
||
│ │ ├── MainMVVMViewModelBase.*
|
||
│ │ ├── Item/ItemActor.* # 道具 Actor 基类
|
||
│ │ ├── GAS/Effect/ # GameplayEffect 相关
|
||
│ │ ├── UMG/MainUI.*
|
||
│ │ ├── TestFireBall.* TestGameplayEffect.*
|
||
│ │ └── Variant_Combat / Variant_Platforming / Variant_SideScrolling
|
||
│ └── PvPDemo.Build.cs
|
||
├── Content/
|
||
│ ├── PvPDemo/
|
||
│ │ ├── Asset/ # 元素材质（Fire / Water / Thunder / Dark / Heal）
|
||
│ │ ├── Blueprints/
|
||
│ │ │ ├── AI/ # BB_AI / BT_AI / BP_AIController / BP_Bot + Tasks
|
||
│ │ │ ├── GAS/ # GA_UseFirstItem + Effect/GE_*
|
||
│ │ │ ├── Item/ # BP_Item / BP_ItemManager / BP_ItemSpawner / BP_Item_*
|
||
│ │ │ ├── UMG/ # WBP_LoginUI / WBP_MainUI / Widget/*
|
||
│ │ │ └── Data/ # MVVM_Main / S_GameModeDifficulty / S_ItemInfo
|
||
│ │ └── Data/ # DT_GameMode / DT_ItemInfo
|
||
│ └── ThirdPerson/ # GameMode / PlayerController / GameInstance / Maps
|
||
├── Plugins/
|
||
│ └── AdvancedSessions/
|
||
└── PvPDemo.uproject
|
||
```
|
||
|
||
## 核心系统
|
||
|
||
### GAS（Gameplay Ability System）
|
||
- `APvPDemoCharacter` 与 `ABotCharacter` 均实现 `IAbilitySystemInterface`，持有 `AbilitySystemComponent` 与 `MainAttributeSet`。
|
||
- `BotCharacter` 在 `PossessedBy` 时初始化 ASC、授予默认 Abilities、应用默认属性 Effect。
|
||
- 元素道具对应一组 GameplayEffect：`GE_Fireball / GE_Waterball / GE_Thunderball / GE_Darkball / GE_Heal`。
|
||
- `GA_UseFirstItem` 处理使用背包首位道具的能力。
|
||
|
||
### AI
|
||
- `BP_Bot`（继承自 `ABotCharacter`）+ `BP_AIController` 驱动行为。
|
||
- 行为树 `BT_AI` / 黑板 `BB_AI`，自定义任务：
|
||
- `BTTask_FindNearestItem`：搜寻最近道具
|
||
- `BTTask_PickupItem`：拾取
|
||
- `BTTask_FindTargetPlayer`：锁定玩家
|
||
- `BTTask_AttackTarget`：攻击
|
||
|
||
### Item 系统
|
||
- `AItemActor`（C++ 基类）暴露 `ApplyEffectToTarget` 用于对目标施加 GameplayEffect。
|
||
- 蓝图侧：`BP_Item` 基类 → 元素球 / 治疗 / 射击道具变体。
|
||
- `BP_ItemSpawner` 负责场景生成，`BP_ItemManager` 统一管理。
|
||
- `APvPDemoCharacter::HeldItem` 通过 `AddHeldItemTag` / `RemoveHeldItemTag` 维护持有道具的 GameplayTag。
|
||
|
||
### UI（MVVM）
|
||
- 启用 `ModelViewViewModelModule` + `FieldNotification`。
|
||
- `MainMVVMViewModelBase` 作为 ViewModel 基类，`MVVM_Main` 资产承载主界面数据。
|
||
- 主界面：`WBP_MainUI`，子部件包含 `Widget_HealthBar` / `Widget_Backpack` / `Widget_ItemIcon`。
|
||
- 登录界面：`WBP_LoginUI`。
|
||
|
||
### 数据驱动
|
||
- `DT_GameMode`（行结构 `S_GameModeDifficulty`）：游戏模式难度配置。
|
||
- `DT_ItemInfo`（行结构 `S_ItemInfo`）：道具信息。
|
||
|
||
## 入口配置
|
||
|
||
`Config/DefaultEngine.ini` 中：
|
||
- `GameDefaultMap` / `EditorStartupMap`：`/Game/ThirdPerson/L_TestMap`
|
||
- `GlobalDefaultGameMode`：`BP_ThirdPersonGameMode`
|
||
- `GameInstanceClass`：`BP_GameInstance`
|
||
- 渲染：DX12 + SM6、Lumen、Substrate、虚拟阴影、光线追踪开启
|
||
|
||
## 模块依赖
|
||
|
||
`Source/PvPDemo/PvPDemo.Build.cs`：
|
||
|
||
```
|
||
Core, CoreUObject, Engine, InputCore, EnhancedInput,
|
||
AIModule, StateTreeModule, GameplayStateTreeModule,
|
||
UMG, Slate,
|
||
GameplayAbilities, GameplayTags, GameplayTasks,
|
||
ModelViewViewModel, FieldNotification
|
||
```
|
||
|
||
`PvPDemo.uproject` 启用插件：
|
||
`ModelingToolsEditorMode`（仅 Editor）、`StateTree`、`GameplayStateTree`、`GameplayAbilities`、`ModelViewViewModel`。
|
||
|
||
## 构建与运行
|
||
|
||
1. 安装 Unreal Engine **5.7**。
|
||
2. 右键 `PvPDemo.uproject` → **Generate Visual Studio project files**。
|
||
3. 用 `PvPDemo.sln` 编译 `Development Editor | Win64`。
|
||
4. 双击 `PvPDemo.uproject` 启动编辑器，默认进入 `L_TestMap`。
|
||
|
||
## 开发约定
|
||
|
||
项目根目录的 `CLAUDE.md` 与 `AGENTS.md` 描述了协作约束，要点：
|
||
|
||
- 修改代码前先说明方案，不直接动手。
|
||
- 默认不做编译检查，除非主动要求。
|
||
- 简洁优先：不引入未被要求的特性、抽象与配置项。
|
||
- 改动外科手术式：只改必要的行，不顺手"优化"周边代码。
|