Auto-sync: 2026-04-26 12:02

wiki/concepts/GAS-Gameplay-Ability-System.md

@@ -0,0 +1,65 @@
+---
+title: "GAS (Gameplay Ability System)"
+type: concept
+tags: [unreal-engine, networking, multiplayer, ue5, abilities]
+sources: ["unreal-multiplayer-architect", "unreal-systems-engineer"]
+last_updated: 2026-04-26
+
+## Additional Sources
+Gameplay Ability System（GAS）是 UE5 的可扩展技能与属性框架，通过 UGameplayAbility、UAttributeSet、UAbilitySystemComponent 实现网络就绪的技能系统。[[UnrealSystemsEngineer]] 补充：所有 Tick 逻辑必须 C++；FGameplayTag 优于字符串标识符；通过 UPROPERTY(ReplicatedUsing=OnRep_Health) + GAMEPLAYATTRIBUTE_REPNOTIFY 宏实现属性复制。
+
+## Core Components
+- **UAbilitySystemComponent**：GAS 核心组件，管理技能和属性，必须正确配置网络复制
+- **UGameplayAbility**：可激活的技能类，支持网络预测和复制
+- **FGameplayEffectContext**：技能效果上下文，携带命中结果、来源和自定义数据
+- **FPredictionKey**：预测键，标记可预测的能力和属性变更，支持服务器确认或回滚
+- **UAttributeSet**：属性集，包含可复制的游戏属性（生命值、能量等）
+
+## Network Integration (Dual Init Path)
+GAS 在多人游戏中必须实现双路径初始化：
+
+```cpp
+// 服务器路径 — PossessedBy 在 Actor 被 Controller 拥有时调用
+void AMyCharacter::PossessedBy(AController* NewController)
+{
+    Super::PossessedBy(NewController);
+    AbilitySystemComponent->InitAbilityActorInfo(GetPlayerState(), this);
+}
+
+// 客户端路径 — OnRep_PlayerState 在 PlayerState 复制到达时调用
+void AMyCharacter::OnRep_PlayerState()
+{
+    Super::OnRep_PlayerState();
+    AbilitySystemComponent->InitAbilityActorInfo(GetPlayerState(), this);
+}
+```
+
+## Network Prediction in GAS
+- `FPredictionKey`：标记所有预测变更，服务器确认后生效
+- 客户端预测技能激活和属性变更
+- 服务器验证并广播 `GameplayEffect` 到所有客户端
+- 验证失败时服务器回滚客户端预测
+
+## Best Practices
+- **双路径初始化**：必须在 `PossessedBy` 和 `OnRep_PlayerState` 两个入口点初始化 GAS
+- **AttributeSet 复制**：使用 `UPROPERTY(Replicated)` 让属性在服务器和客户端同步
+- **预测管理**：高频技能必须正确设置 `NetDeltaFrequency` 避免带宽爆炸
+- **预测键作用域**：`FPredictionKey` 必须在能力激活时生成并传递给所有子操作
+
+## Connection to Other Concepts
+- [[Actor Replication]] — GAS 依赖 Actor 复制机制同步属性和状态
+- [[Network Prediction]] — GAS 内置网络预测支持（FPredictionKey）
+- [[Server-Authoritative Model]] — 服务器权威验证技能激活请求
+
+## Relationship to Agent
+[[UnrealMultiplayerArchitect]] 强调：GAS 网络集成必须从双路径初始化开始，测试必须在 150ms 模拟延迟下验证技能激活，"Profile GAS replication overhead" 是网络优化的关键步骤。
+
+[[UnrealSystemsEngineer]] 补充：系统架构师负责 UGameplayAbility/UAttributeSet C++ 实现和 BlueprintCallable 暴露；Tick 依赖逻辑必须 C++（即使是技能冷却检查）；AttributeSet 使用 FGameplayAttributeData + GAMEPLAYATTRIBUTE_REPNOTIFY 宏保证复制安全。
+
+## Aliases
+- Gameplay Ability System
+- UE5 GAS
+- AbilitySystemComponent
+- FPredictionKey
+- GameplayEffect
+- AttributeSet