Skip to content

Getting Started

sajad0131 edited this page Aug 7, 2025 · 1 revision

Getting Started

This guide will walk you through the basic setup of UGAS in your project.

1. Installation

  1. Download the latest UGAS by Sajad Amiri.unitypackage from the Releases page.
  2. Open your Unity project.
  3. Go to Assets > Import Package > Custom Package... and select the downloaded file.

2. Setting Up a Character

  1. Create a GameObject for your player.
  2. Add the following components to it:
    • AttributeSet
    • GameplayEffectRunner
    • AbilitySystem
    • TagSystem
  3. Create your AttributeDefinition assets (e.g., "Health," "Mana").
  4. On the AttributeSet component, add your attributes to the Initial Attributes list.

3. Creating Your First Ability

  1. Create a GameplayEffect for what the ability will do (e.g., an InstantModifierEffect for damage).
  2. Create an AbilityDefinition and configure it.
  3. Add the GameplayEffect to the ability's Effects list.
  4. Add the AbilityDefinition to the Initial Abilities list on your character's AbilitySystem component.

4. Activating the Ability

Use a script to call TryActivateAbility on the AbilitySystem.

public AbilitySystem abilitySystem;
public AbilityDefinition myAbility;

void Activate()
{
    abilitySystem.TryActivateAbility(myAbility);
}
Clone this wiki locally