---
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