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。

构建与运行

安装 Unreal Engine 5.7。
右键 PvPDemo.uproject → Generate Visual Studio project files。
用 PvPDemo.sln 编译 Development Editor | Win64。
双击 PvPDemo.uproject 启动编辑器，默认进入 L_TestMap。

开发约定

项目根目录的 CLAUDE.md 与 AGENTS.md 描述了协作约束，要点：

修改代码前先说明方案，不直接动手。
默认不做编译检查，除非主动要求。
简洁优先：不引入未被要求的特性、抽象与配置项。
改动外科手术式：只改必要的行，不顺手"优化"周边代码。

5.3 KiB Raw Blame History Unescape Escape