Gameplay Ability System
WHY YOU'LL LIKE IT ... FEATURES - Gameplay Tags: a child tag matches its parents. ... - Attribute Reactions: "when Health reaches 0, apply Dead and send an event", with no ... REQUIREMENTS
by Supercachola
Price History +
Key features
- Hierarchical Gameplay Tags (integer ids, bitset containers) with a Tag Manager window
- Attributes with min/max, dynamic maximum and Add / Multiply / Override modifiers
- Gameplay Effects: instant, duration, infinite, periodic, stacking, immunity, executions
- Gameplay Abilities with cost, cooldown, event triggers and waits
- Gameplay Events with hierarchical listeners
- Pooled Gameplay Cues (prefab and audio)
- Attribute Reactions (threshold-driven effects and events)
- Ability Debugger window
- Optional Input System binder
Code
- Full C# source with assembly definitions (runtime, editor, tests)
- Namespace: supercachola.AbilitySystem
- 40+ EditMode tests
- No managed allocations while ticking, applying an instant effect or removing an effect
Compatibility
- Unity 6000.0 or newer (tested on 6000.0 and 6000.6)
- Sample tested in URP and HDRP; the runtime code is render pipeline independent
- Tested in Mono and IL2CPP builds
Dependencies
- None required
- Optional: Input System (input binder and sample)
Documentation
- Getting Started guide and one page per system, included in the package and online
Build abilities, buffs, damage and status effects without hardcoding them.
Ability System is a clean, data-driven gameplay framework inspired by the Gameplay Ability System concept. You define abilities, effects, attributes and cues as ScriptableObjects and share them between any number of characters. Each character keeps its own runtime state, so a hundred enemies can use the same poison effect without interfering with each other.
Designers tweak numbers in the Inspector. Programmers extend behaviour in small, testable C# classes.
WHY YOU'LL LIKE IT
- Tags instead of strings: hierarchical gameplay tags are integers, queried with bit operations.
- One asset, many characters: definitions are shared; only small runtime state is per character.
- Decoupled feedback: effects request a cue by tag, and a cue library decides the particles and sounds.
- Easy to debug: a live Debugger window shows attributes, effects, tags, cues and abilities while the game runs.
- Fast by design: ticking, applying an instant effect and removing an effect allocate no managed memory.
FEATURES
- Gameplay Tags: a child tag matches its parents. Tag Manager window and Inspector pickers.
- Attributes: base and current values, min and max, a maximum that follows another attribute (Health never exceeds MaxHealth), Add / Multiply / Override modifiers, attribute sets as assets.
- Gameplay Effects: Instant, Duration and Infinite; periodic execution; fixed, attribute-based or caller-set magnitudes; custom executions for damage formulas; granted, required and blocked tags; immunity; cleanse; ongoing requirements; stacking policies.
- Gameplay Abilities: cost and cooldown are effects; activation tags; cancel-by-tag; event triggers; waits for a delay, an event or a tag that clean up when the ability ends.
- Gameplay Events: tagged events with instigator, target, magnitude and payload. Listening to a parent tag also receives its children.
- Gameplay Cues: pooled particle and audio cues, shared between effects, with prewarming.
- Attribute Reactions: "when Health reaches 0, apply Dead and send an event", with no code.
- Optional Input System binder to trigger abilities from input actions.
- 40+ automated EditMode tests.
WHAT'S INCLUDED
- Full C# source code with assembly definitions.
- Basic Combat sample: a player, an enemy, an attack ability with cooldown, damage, a buff, a poison zone, death handling and cues. Works in URP and HDRP.
- Documentation: a Getting Started guide that rebuilds the sample step by step, plus a page for each system.
REQUIREMENTS
- Unity 6000.0 or newer.
- The Input System package is optional: it is only needed for the input binder and the sample.
GIT
-This project has a github public page: https://github.com/EduardoLopezPalomo/GameplayAbilitySystem
Ability System is inspired by the Gameplay Ability System concept. It is an independent work and is not affiliated with, or endorsed by, Epic Games.