跳至正文
OpenAgentSkill
浏览已开放 · 目录记录日期 2026-11-21 · 自动更新和账户服务暂时关闭。
开发与测试

unreal-gas

Expert guide for Unreal Engine 5.x Gameplay Ability System (GAS) C++ development. Covers AbilitySystemComponent, GameplayAbilities, GameplayEffects, Attributes/AttributeSets, GameplayTags, GameplayCues, AbilityTasks, prediction/replication, and common patterns. Use when the user asks about GAS, gameplay abilities, gameplay effects, attribute sets, ability system component, gameplay tags in the context of GAS, gameplay cues, ability tasks, or any UAbilitySystemComponent / UGameplayAbility / UGameplayEffect / UAttributeSet related C++ code. Also triggers for questions about ability prediction, ability replication, combo systems using GAS, cooldowns, costs, stacking, or damage/healing pipelines built on GAS.

maystudios · 已有静态检查记录

安装与使用

运行命令前先阅读来源与依赖说明。复制命令不会自动安装或执行。

npx skills add maystudios/claude-skills --skill unreal-gas

技能说明


name: unreal-gas description: > Expert guide for Unreal Engine 5.x Gameplay Ability System (GAS) C++ development. Covers AbilitySystemComponent, GameplayAbilities, GameplayEffects, Attributes/AttributeSets, GameplayTags, GameplayCues, AbilityTasks, prediction/replication, and common patterns. Use when the user asks about GAS, gameplay abilities, gameplay effects, attribute sets, ability system component, gameplay tags in the context of GAS, gameplay cues, ability tasks, or any UAbilitySystemComponent / UGameplayAbility / UGameplayEffect / UAttributeSet related C++ code. Also triggers for questions about ability prediction, ability replication, combo systems using GAS, cooldowns, costs, stacking, or damage/healing pipelines built on GAS.

Unreal Engine Gameplay Ability System (GAS) -- C++ Guide

Official Documentation (always consult for latest details)

These are the authoritative sources. Reference them for up-to-date API details, as GAS evolves across engine versions:

SourceURL
Epic GAS Landing Pagehttps://dev.epicgames.com/documentation/en-us/unreal-engine/gameplay-ability-system-for-unreal-engine
Understanding GAS (Overview)https://dev.epicgames.com/documentation/en-us/unreal-engine/understanding-the-unreal-engine-gameplay-ability-system
ASC & Attributeshttps://dev.epicgames.com/documentation/en-us/unreal-engine/gameplay-ability-system-component-and-gameplay-attributes-in-unreal-engine
Gameplay Abilitieshttps://dev.epicgames.com/documentation/en-us/unreal-engine/using-gameplay-abilities-in-unreal-engine
Attributes & Attribute Setshttps://dev.epicgames.com/documentation/en-us/unreal-engine/gameplay-attributes-and-attribute-sets-for-the-gameplay-ability-system-in-unreal-engine
Gameplay Effectshttps://dev.epicgames.com/documentation/en-us/unreal-engine/gameplay-effects-for-the-gameplay-ability-system-in-unreal-engine
Ability Taskshttps://dev.epicgames.com/documentation/en-us/unreal-engine/gameplay-ability-tasks-in-unreal-engine
Community GAS Docs (tranek)https://github.com/tranek/GASDocumentation

The community docs by tranek are the most comprehensive single resource for GAS. They cover advanced topics (prediction internals, optimization, replication modes, pitfalls) that Epic's official docs do not. Always check them for edge cases and production patterns.

The Lyra Sample Project is Epic's recommended working reference implementation for GAS.

Plugin Setup

  1. Enable Gameplay Abilities plugin in the editor
  2. Add to Build.cs:
    PublicDependencyModuleNames.AddRange(new string[] {
        "GameplayAbilities", "GameplayTags", "GameplayTasks"
    });
    
  3. UE 5.2 and earlier: call UAbilitySystemGlobals::Get().InitGlobalData() in your AssetManager or GameInstance. UE 5.3+ does this automatically.

Core Architecture

See references/core-classes.md for the full class reference, setup patterns, and C++ code snippets.

System overview:

Actor
  +-- UAbilitySystemComponent (ASC) --- manages everything below
        +-- UGameplayAbility instances (granted abilities)
        |     +-- UAbilityTask instances (async execution)
        +-- UAttributeSet instances (numeric data)
        +-- Active UGameplayEffect specs (modifiers)
        +-- FGameplayTag container (status/state)
        +-- GameplayCue triggers (cosmetic FX)

Key relationships:

  • ASC is the central hub; one per Actor (place on Pawn or PlayerState)
  • Abilities create/apply Effects to modify Attributes and Tags on targets
  • Effects auto-trigger Cues when their tags match GameplayCue.* tags
  • Tags control ability activation, blocking, and cancellation systemically
  • AbilityTasks handle async work (montages, delays, targeting) within abilities

Gameplay Effects Quick Reference

See references/effects-and-attributes.md for detailed GE patterns, modifier math, stacking, cooldowns, and attribute handling.

Duration types:

  • Instant -- modifies BaseValue permanently, never tracked as active
  • Duration -- modifies CurrentValue, auto-reverts on expiry
  • Infinite -- persists until explicitly removed

Modifier aggregation: ((Base + Additive) * Multiplicative) / Division

  • Multiply/Divide uses 1 + Sum(Mods - 1) -- two +50% multipliers = +100%, not +125%

Ability Lifecycle

GiveAbility() -> TryActivateAbility() -> CanActivateAbility()
  -> ActivateAbility() [override this] -> CommitAbility() [apply cost/cooldown]
  -> ... do work (AbilityTasks) ... -> EndAbility()

Four activation methods: explicit handle, GameplayEvent, GameplayEffect tags, Input codes.

Instancing policies:

  • InstancedPerActor -- recommended default; one instance reused per actor
  • InstancedPerExecution -- new instance each activation; simplest but heaviest
  • NonInstanced -- uses CDO; best performance, C++ only, no state/delegates/RPCs

Networking & Prediction

See references/networking.md for replication modes, prediction details, and multiplayer patterns.

Net Execution Policies: LocalPredicted, LocalOnly, ServerOnly, ServerInitiated.

Key rules:

  • ASC replicates Attributes and Tags to all clients, but NOT abilities/effects (bandwidth optimization)
  • Non-instant GEs support prediction rollback; instant GEs (damage) do NOT
  • Cues use unreliable replication -- cosmetic only, never gameplay logic
  • ASC's owning Actor must be locally controlled for remote activation to work
  • For PlayerState-based ASC: use Mixed replication for players, Minimal for AI

Common Patterns & Pitfalls

See references/patterns-and-pitfalls.md for implementation recipes and known issues.

Critical pitfalls:

  • PreAttributeChange clamping does NOT permanently change modifiers -- clamp BaseValue in `PostGameplayE
阅读完整来源 ↗