Abilities manager component

First, add the Abilities Manager component to your actor.

💡You can also create your own component by extending the Base Abilities Manager.

Change Ability

Then you can change the actor's current ability like this, provided the ability is accessible. To override accessibility checks and force the ability change, enable Force Change.

💡Learn how to create an ability here.

Useful dispatchers

Some dispatchers are availible in abilities manager component.

Initial ability

In the component details, choose the default ability this actor will have.

Network replication

⚠️To replicate this system on a player pawn with inputs, the initial ability must be selected during possession to ensure the inputs are correctly activated within the ability.

1.1 - Create an Ability

Right click in content browser, select Modular Abilities -> Ability.

1.2 - Select ability class

Choose your base class for this ability. MA_Ability is the mother class of all abilities, so if you don't need inheritance between your capabilities, you should use it.

💡Only abilities with "bIsBaseAbilityClass" checked are listed. Learn more.

1.3 - Class defaults

• Tick: If checked, Event Tick will trigger every specified number of seconds or every tick if set to ≤ 0.
• Replicates: If checked, the ability will be network replicated, allowing RPC calls and ensuring that replicated variables synchronize across the network.
• Auto Enable Input: If checked, inputs will be automatically enabled when the ability is entered and disabled when the ability is exited (only if the ability's owner has a controller). This should be enabled for player abilities and disabled for NPCs or world actors.

1.4 Is Accessible

You can override the IsAccessible function to implement your own accessibility logic. For example, for a sprint ability, you could use:

bool UYourAbility::IsAccessible() const override
{
    return Stamina > 0;
}

1.5 - Base events

• Event Initialize: Triggers when the ability is created (not when entered), making it useful for efficiently setting references to casted objects, for example.
• Event Destroyed: Called when the owner actor is destroyed (the owner of the Abilities Manager Component). If you have any dispatcher bindings to unbind, this is the appropriate place to do so!
• Event Tick: Triggers every specified number of seconds set in the Tick Interval (secs) or every tick if set to ≤ 0.

1.6 - Ability change events

• Event Enter Ability: Triggers when the ability is entered (when ChangeAbility is called with this ability selected and if IsAccessible returns true).
• Event Exit Ability: Called when the ability is exited (when ChangeAbility is called to switch to another accessible ability).
• Event Failed Access Ability: Triggers when someone tries to change to this ability, but the ability is not accessible.

2.1 - Change Ability

Change Ability is the same as the Change Ability in the Abilities Manager Component. It automatically calls the Change Ability function of its manager. Learn more.

2.2 - Getters

In the Class Defaults of an ability, if "Is Base Ability Class" is checked, this ability will be included as a possible parent class for creating a new ability. 

Create an Abilies Manager

Right click in content browser, select Modular Abilities -> Abilities Manager.

 Getter

Returns the currently active ability.

Events

• Event Ability Entered: Triggered each time an ability is entered, providing the entered ability as a parameter.
• Event Ability Exited: Triggered each time an ability is exited, providing the exited ability as a parameter.
• Event Ability Access Failed: Triggered each time an ability fails to be accessed, providing the inaccessible ability as a parameter.