# GAS 属性系统实现记录（PHY） > 说明：本文记录在本项目中，为古风游戏（四维：臂力/根骨/内息/身法）搭建 GAS 属性体系、派生属性、职业初始化、以及服务器端定时回复（回血/回内）等功能的实现过程。 > > 本项目模块不对外暴露，因此代码全部放在 `Source/PHY/Private` 内（AttributeSet/GE/MMC/GameplayTags 等）。 --- ## 0. 总体目标 - 基础属性（Primary）： - **Strength（臂力）** - **Constitution（根骨）** - **InnerBreath（内息）** - **Agility（身法）** - 其他属性由四维派生（MMC 计算）或由装备/功法 GE 附加。 - 不对外提供公共模块 API：代码全部在 `Private`。 --- ## 1. GAS 组件挂载位置与初始化 ### 1.1 AbilitySystemComponent 放在 PlayerState - 在 `APHYPlayerState` 的构造函数中创建： - `UAbilitySystemComponent* AbilitySystemComponent` - `UPHYAttributeSet* AttributeSet` - 设置复制： - `AbilitySystemComponent->SetIsReplicated(true)` - `AbilitySystemComponent->SetReplicationMode(EGameplayEffectReplicationMode::Minimal)`（适合 PlayerState） 相关文件： - `Source/PHY/Private/Gameplay/Player/PHYPlayerState.cpp` ### 1.2 Character 初始化 GAS：Owner=PlayerState，Avatar=Character 在 `APHYPlayerCharacter`： - `PossessedBy()`（服务器）调用 `InitializeGAS()` - `OnRep_PlayerState()`（客户端）也调用 `InitializeGAS()` 初始化逻辑（核心）： - `ASC->InitAbilityActorInfo(PlayerState, this)` - 服务器： - Apply `UPHYGE_InitPrimary`（设置四维初值） - Apply `UPHYGE_DerivedAttributes`（无限期派生属性：Override + MMC） - 设置资源/当前值： - `Health = MaxHealth` - `InnerPower = MaxInnerPower` 相关文件： - `Source/PHY/Private/Character/PHYPlayerCharacter.h/.cpp` --- ## 2. AttributeSet（全部在 Private） ### 2.1 AttributeSet 位置 - `Source/PHY/Private/AbilitySystem/Attributes/PHYAttributeSet.h` - `Source/PHY/Private/AbilitySystem/Attributes/PHYAttributeSet.cpp` ### 2.2 属性分组 #### Primary（基础四维） - `Strength` - `Constitution` - `InnerBreath` - `Agility` #### Vitals（生命） - `Health` - `MaxHealth` #### Resource（资源） - `InnerPower` - `MaxInnerPower` #### Derived（示例派生） - `MoveSpeed` - `PhysicalAttack` - `PhysicalDefense` #### Secondary（二级属性） - `Tenacity`（韧性） - `CritChance`（暴击率 0~1） - `CritDamage`（暴击伤害倍率 >=1） - `DodgeChance`（闪避 0~1） - `HitChance`（命中 0~1） - `ParryChance`（招架 0~1） - `CounterChance`（反击 0~1；业务逻辑要求闪避/招架成功后再判定） - `ArmorPenetration`（穿甲 0~1；目前字段存在，数值来源更多偏装备/功法） - `DamageReduction`（免伤 0~1） - `LifeSteal`（吸血 0~1；目前字段存在，数值来源更多偏装备/功法） - `HealthRegenRate`（生命回复/秒） - `InnerPowerRegenRate`（内力回复/秒） ### 2.3 Clamp 与复制 在 AttributeSet 内实现： - `PreAttributeChange`： - `Health` / `InnerPower` clamp 到 `[0, Max]` - 概率类 clamp 到 `[0, 1]` - `CritDamage` clamp `>= 1` - `PostGameplayEffectExecute`： - 对关键属性再兜底 clamp - 完整实现： - `OnRep_XXX` - `GetLifetimeReplicatedProps` + `DOREPLIFETIME_CONDITION_NOTIFY` --- ## 3. 派生属性计算（MMC） ### 3.1 MMC 放置位置 `Source/PHY/Private/AbilitySystem/MMC/` ### 3.2 已实现的 MMC（示例） #### 基础派生 - `UPHY_MMC_MaxHealth`：`MaxHealth = 100 + Constitution * 25` - `UPHY_MMC_MoveSpeed`：`MoveSpeed = 600 + Agility * 2` - `UPHY_MMC_PhysicalAttack`：`PhysicalAttack = 10 + Strength * 2` - `UPHY_MMC_PhysicalDefense`：`PhysicalDefense = 5 + Constitution * 1.5` #### 二级属性派生（示例系数，后续建议数据化） - `UPHY_MMC_MaxInnerPower`：`MaxInnerPower = 100 + InnerBreath * 20` - `UPHY_MMC_Tenacity`：`Tenacity = InnerBreath * 1` - `UPHY_MMC_CritChance`：`CritChance = 0.05 + Agility * 0.002 (clamp 0..1)` - `UPHY_MMC_CritDamage`：`CritDamage = 1.5 + Strength * 0.005 (>=1)` - `UPHY_MMC_DodgeChance`：`DodgeChance = 0.02 + Agility * 0.002` - `UPHY_MMC_HitChance`：`HitChance = 0.9 + Agility * 0.001` - `UPHY_MMC_ParryChance`：`ParryChance = 0.03 + Strength * 0.001` - `UPHY_MMC_CounterChance`：`CounterChance = 0.1 + Agility * 0.001` - `UPHY_MMC_DamageReduction`：`DamageReduction = Constitution * 0.001` - `UPHY_MMC_HealthRegenRate`：`HealthRegenRate = Constitution * 0.1` - `UPHY_MMC_InnerPowerRegenRate`：`InnerPowerRegenRate = InnerBreath * 0.15` > 注：部分属性如穿甲/吸血更适合由装备/功法 GE 直接加成，而非完全从四维硬算。 --- ## 4. GameplayEffect（初始化 + 派生） ### 4.1 初始化四维：`UPHYGE_InitPrimary` - 文件：`Source/PHY/Private/AbilitySystem/Effects/PHYGE_InitPrimary.h/.cpp` - 类型：Instant - 用 `SetByCaller` 写入四维（复用同一个 GE 支持所有职业） SetByCaller Tag（NativeGameplayTags 管理）： - `Data.Init.Primary.Strength` - `Data.Init.Primary.Constitution` - `Data.Init.Primary.InnerBreath` - `Data.Init.Primary.Agility` ### 4.2 派生属性：`UPHYGE_DerivedAttributes` - 文件：`Source/PHY/Private/AbilitySystem/Effects/PHYGE_DerivedAttributes.h/.cpp` - 类型：Infinite - Modifiers：全部使用 `Override + MMC` - 包含 `MaxHealth/MoveSpeed/PhysicalAttack/PhysicalDefense` - 包含新增二级属性/资源上限（如 `MaxInnerPower`、暴击等） --- ## 5. GameplayTags 组织（集中管理，避免硬编码 FName） ### 5.1 Init 属性 Tag - `Source/PHY/Private/GameplayTags/InitAttributeTags.h/.cpp` ### 5.2 Regen Tag - `Source/PHY/Private/GameplayTags/RegenTags.h/.cpp` ### 5.3 ini 配置 - 新增/维护：`Config/DefaultGameplayTags.ini` - 包含 `Data.Init.Primary.*` - 包含 `Data.Regen.*` --- ## 6. 职业/门派初始属性（全局配置） ### 6.1 职业枚举 - `Source/PHY/Private/AbilitySystem/PHYCharacterClass.h` ### 6.2 DataAsset：全局职业默认值表 - `Source/PHY/Private/AbilitySystem/PHYClassDefaults.h` - `UPHYClassDefaults`： - `FallbackPrimary` - `Classes[]`：每个职业对应一套 `FPHYPrimaryAttributes` ### 6.3 配置位置：GameInstance 考虑到 `ClassDefaults` 是全局数据，不应放在每个 Character 上： - `UPHYGameInstance` 增加 `ClassDefaults` 引用 - `GetClassDefaults()` 文件： - `Source/PHY/Private/Gameplay/PHYGameInstance.h/.cpp` 使用方式： - 在编辑器中的项目 GameInstance 蓝图（`DefaultEngine.ini` 指定的 `GameInstance_Default`）里配置 `ClassDefaults` 资产。 --- ## 7. 服务器端定时回复（方案 B：代码驱动） > 选择方案 B：不使用 Period GE，而使用 **服务器 Timer + Instant GE**。 ### 7.1 Regen 每跳 GE：`UPHYGE_RegenTick` - 文件：`Source/PHY/Private/AbilitySystem/Effects/PHYGE_RegenTick.h/.cpp` - 类型：Instant - 使用 SetByCaller： - `Data.Regen.Health`（加到 Health） - `Data.Regen.InnerPower`（加到 InnerPower） ### 7.2 Character 计时器逻辑 在 `APHYPlayerCharacter`： - 属性：`RegenInterval`（默认 1 秒） - 在 `InitializeGAS()` 服务器端启动 Timer： - `SetTimer(RegenTimerHandle, RegenTick, RegenInterval, true)` - `RegenTick()`： - `HealthDelta = HealthRegenRate * RegenInterval` - `InnerPowerDelta = InnerPowerRegenRate * RegenInterval` - Apply `UPHYGE_RegenTick`（SetByCaller 写入本次增量） > 后续可拓展：脱战回复/坐下打坐/战斗中禁回等，均通过 GameplayTag 或状态判断来控制 `RegenTick()` 是否执行。 --- ## 8. 代码风格/工程注意事项 ### 8.1 UTF-8 BOM 引发的编译/IDE 问题 过程中多次遇到文件头 BOM 导致的解析错误（如 `无法解析符号 ''`）。 已对相关文件移除 BOM（例如 PlayerState / PlayerCharacter / GameInstance 等）。 --- ## 9. 下一步建议（可选） - 将二级属性派生系数数据化（DataAsset/CurveTable），减少硬编码常量。 - 装备/功法：用 GE 直接对二级属性加成（穿甲/吸血等更适合走装备词条）。 - 战斗结算库：统一命中/闪避/招架/反击触发顺序与公式。 - Regen 增加“脱战 N 秒后生效”等状态控制（GameplayTag 驱动）。