Actions

Blueprint API

From Able Ability System Wiki

Revision as of 01:34, 3 September 2020 by ExtraLifeMatt (talk | contribs) (Created page with "This page lists all the blueprint functions available in the plugin = Ability = == Context == === Create Ability Context === https://able.extralifestudios.com/wiki/Blueprin...")
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

This page lists all the blueprint functions available in the plugin

Contents

Ability

Context

Create Ability Context

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CreateAbilityContext.png

Creates an Ability Context with the provided information.

Ability            Abl Ability Object Reference        The Ability to execute.
Ability Component  Ability Component Object Reference  The Ability Component that will be running this Context.
Owner              Actor Object Reference              The "owner" to set as the Owner Target Type.
Instigator         Actor Object Reference              The "Instigator" to set as the Instigator Target Type.
Return Value  Abl Ability Context Object Reference  the Ability Context [1].

Clear Target Actors

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_ClearTargetActors.png

Clear all entries from the Target Actors.

Target  Abl Ability Context Object Reference  None

Get Ability Scratch Pad

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityScratchPad.png

Returns the Ability Scratchpad allocated for this context, if requested.

Target  Abl Ability Context Object Reference  None
Return Value  Abl Ability Scratch Pad Object Reference  the Ability Scratchpad [2]

Get Ability Start Location

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityStartLocation.png

Returns the start location of this Ability.

Target  Abl Ability Context Object Reference  None
Return Value  Vector  the start location of this Ability.

Get Current Stack Count

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetCurrentStackCount.png

Returns the Stack count of this Ability.

Target  Abl Ability Context Object Reference  None
Return Value  Integer  the Stack count of this Ability.

Get Current Time

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetCurrentTime.png

Returns the current time of this Ability.

Target  Abl Ability Context Object Reference  None
Return Value  Float  the current time of this Ability.

Get Current Time Ratio

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetCurrentTimeRatio.png

Returns the current time of this Ability as a ratio between 0.0 and 1.0.

Target  Abl Ability Context Object Reference  None
Return Value  Float  the current time of this Ability as a ratio between 0.0 and 1.0.

Get Instigator

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetInstigator.png

Returns the Instigator Context Target Actor, if it exists. This is set when creating the context.

Target  Abl Ability Context Object Reference  None
Return Value  Actor Object Reference  the Instigator Context Target Actor.

Get Last Delta Time

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetLastDeltaTime.png

Returns the last Delta time (time between frames) used to update this Ability.

Target  Abl Ability Context Object Reference  None
Return Value  Float  the last Delta time (time between frames) used to update this Ability.

Get Owner

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetOwner.png

Returns the Owner Context Target Actor, if it exists. This is set when creating the context.

Target  Abl Ability Context Object Reference  None
Return Value  Actor Object Reference  the Owner Context Target Actor.

Get Self Ability Component

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetSelfAbilityComponent.png

Returns the Ability Component executing this Context.

Target  Abl Ability Context Object Reference  None
Return Value  Ability Component Object Reference  the Ability Component executing this Context.

Get Self Actor

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetSelfActor.png

Returns the Actor (Ability Component Owner) executing this Context.

Target  Abl Ability Context Object Reference  None
Return Value  Actor Object Reference  the Actor (Ability Component Owner) executing this Context.

Get Target Actors

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTargetActors.png

Returns an array of all Target Context Target Actors, if they exist.

Target  Abl Ability Context Object Reference  None
Return Value  Array of Actor Object References  Array of all Target Context Target Actors

Set Stack Count

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_SetStackCount.png

Sets the Stack Count of this Ability.

Target  Abl Ability Context Object Reference  None
Stack   Integer                               None

Debug

Get Draw Collision Queries

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetDrawCollisionQueries.png

Returns whether debugging drawing of collision queries is enabled or not.


Return Value  Boolean  true if debug drawing is enabled.

Set Draw Collision Queries

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_SetDrawCollisionQueries.png

Toggles the viewing of collision queries within Able. Returns the new value.

Enable  Boolean  whether to enable or disable debug drawing.
Return Value  Boolean  whether or not debug drawing is now enabled.

Nodes

Always Refresh Duration

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_AlwaysRefreshDuration.png

Returns true if the duration is always refreshed, regardless if a new stack is added or fails.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if the duration is always refreshed, regardless if a new stack is added or fails.

Get Cooldown

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CalculateCooldownBP.png

Called when determining the cooldown for this Ability.

If you have any special logic that increases/decreases the cooldown amount, you can do it here.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [3]
Return Value  Float  The amount of time, in seconds, to use for the cooldown. By default, returns GetBaseCooldown.

Calculate Damage For Actor

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CalculateDamageForActorBP.png

Called by the Apply Damage Task to calculate how much damage to apply to an Actor.

NOTE: This method should always be thread safe, so only read data from actors - never write/change values of an actor.

Target       Abl Ability Object Reference          None
Context      Abl Ability Context Object Reference  The Ability Context [4]
Event Name   Name (by ref)                         A simple identifier to distinguish this Event from other possible Damage Events you may have in your Timeline.
Base Damage  Float                                 The flat damage value provided by the Task properties.
Actor        Actor Object Reference                The Actor we are going to damage.
Return Value  Float  The final damage value to apply to the Actor.

Can Interrupt Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CanInterruptAbilityBP.png

Called when this Ability is attempting to interrupt another ability.

Target           Abl Ability Object Reference          None
Context          Abl Ability Context Object Reference  The Ability Context [5]
Current Ability  Abl Ability Object Reference          The Ability we are attempting to interrupt.
Return Value  Boolean  True if the Actor can be a Target, false if they should be removed.

Custom Channel Conditional

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CheckCustomChannelConditionalBP.png

Called by the Custom Channeling Condition to apply whatever channeling check you wish to do.

Target      Abl Ability Object Reference          None
Context     Abl Ability Context Object Reference  The Ability Context [6]
Event Name  Name (by ref)                         A simple identifier to distinguish this Event from other possible Custom Channeling Events you may have in your Timeline.
Return Value  Boolean  True if the check succeeded, false if we should break the channeling.

Check Custom Condition

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CheckCustomConditionEventBP.png

Callback for a Custom Event that can be used to block dependent Task execution until some provided criteria is met.

Target      Abl Ability Object Reference          None
Context     Abl Ability Context Object Reference  The Ability Context [7]
Event Name  Name (by ref)                         A simple identifier to distinguish this Event from other possible Custom Condition Event you may have in your Timeline.
Return Value  Boolean  Whether or not the condition is satisfied and should allow any dependent Tasks to execute.

Check Tags

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CheckTags.png

Returns true if the Ability passes a series of Gameplay Tags Queries.

Target        Abl Ability Object Reference               None
Includes Any  Gameplay Tag Container Structure (by ref)  The tags to check if any of these tags are in our container.
Includes All  Gameplay Tag Container Structure (by ref)  The tags to check if all of these tags are in our container.
Excludes Any  Gameplay Tag Container Structure (by ref)  The tags to check if any of these tags are not in our container.
Return Value  Boolean  true if the our containers passed the series of Gameplay Tags queries.

Can Ability Execute

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CustomCanAbilityExecuteBP.png

Called when checking if an Ability is valid to be started. You can use this event to execute

any custom logic beyond the normal targeting/channeling checks (e.g.; resources, time of day, etc).

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [8]
Return Value  Boolean  True if the ability should be allowed to start, false if not.

Can Branch To

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CustomCanBranchToBP.png

Called by the Branch Ability Task to verify we are allowed to branch to this new Ability.

Target          Abl Ability Object Reference          None
Context         Abl Ability Context Object Reference  The Ability Context [9]
Branch Ability  Abl Ability Object Reference          The Ability we want to branch to.
Return Value  Boolean  True if we should allow the branch, false otherwise.

Can Loop Execute

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CustomCanLoopExecuteBP.png

Called by the Looping logic of an Ability to apply whatever additional check(s) you wish to do.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [10]
Return Value  Boolean  True if should allow another loop iteration, false if we should break the looping.

Custom Filter Condition

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CustomFilterConditionBP.png

Called by the Custom Filter for each actor that is a candidate to be acted upon by this Ability.

Target      Abl Ability Object Reference          None
Context     Abl Ability Context Object Reference  The Ability Context [11]
Event Name  Name (by ref)                         A simple identifier to distinguish this Event from other possible Custom Filter Events you may have in your Timeline.
Actor       Actor Object Reference                The Actor we are testing as valid or not.
Return Value  Boolean  True if the Actor can be a Target, false if they should be removed.

Find Targets

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CustomTargetingFindTargetsBP.png

Called by the Custom Targeting of an Ability to apply whatever additional custom target logic you wish to do.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [12]
Found Targets  Array of Actor Object References  The Array of Actors to used as Targets for this Ability.

Create Ability ScratchPad

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityScratchPadClassBP.png

Returns the class, if any, to use as the Ability Scratchpad.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [13]
Return Value  Abl Ability Scratch Pad Class Reference  The class of the Ability Scratchpad [14]

Get Ability Tag Container

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityTagContainer.png

Returns the Ability Tag Container.

Target  Abl Ability Object Reference  None
Return Value  Gameplay Tag Container Structure  the Ability Tag Container.

Get Base Cooldown

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetBaseCooldown.png

Returns the Base Cooldown, in seconds, of the Ability.

Target  Abl Ability Object Reference  None
Return Value  Float  the Base Cooldown, in seconds, of the Ability.

Get Base Max Stacks

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetBaseMaxStacks.png

Returns the Base Stacks value of the Ability.

Target  Abl Ability Object Reference  None
Return Value  Integer  the Base Stacks value of the Ability.

Get Base Play Rate

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetBasePlayRate.png

Returns the Base Play rate as set on the Ability.

Target  Abl Ability Object Reference  None
Return Value  Float  the Base Play rate, in seconds.

Get Decay Stack Time

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetDecayStackTime.png

Returns the time, in seconds, a stack will decay automatically. 0.0 will prevent decay.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  None
Return Value  Float  the time, in seconds, a stack will decay automatically.

Get Decrement and Restart on End

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetDecrementAndRestartOnEnd.png

Returns true if we should decrement the stack count and restart the Ability as long as there is more than 0 stacks left.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if we should decrement the stack count and restart the Ability as long as there is more than 0 stacks left.

Get Display Name

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetDisplayName.png

Returns the name of the Ability in a print friendly format (without class identifiers).

Target  Abl Ability Object Reference  None
Return Value  String  the name of the Ability

Get Length

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetLength.png

Returns the Length, in seconds, of the Ability.

Target  Abl Ability Object Reference  None
Return Value  Float  the Length, in seconds, of the Ability.

Get Loop Range

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetLoopRange.png

Returns the Loop range, in seconds, of this Ability. X component is start time, Y component is end time.

Target  Abl Ability Object Reference  None
Return Value  Vector 2D Structure  the Loop range, in seconds, of this Ability. X component is start time, Y component is end time.

Get Max Stacks

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetMaxStacksBP.png

Called when grabbing the Max stack count for this Ability (if it's a passive).

If you have any special logic that increases/decreases the Stack amount, you can do it here.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [15]
Return Value  Integer  The maximum number of stacks to allow, must be greater than zero.

Get Range

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetRange.png

Returns the estimated range of the Ability.

Target  Abl Ability Object Reference  None
Return Value  Float  the estimated range of the Ability.

Get Target Location

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTargetLocationBP.png

Callback that occurs when the Location Target Type is used.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [16]
Return Value  Vector  The location to assign as the Target.

Has Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_HasTag.png

Returns true if we have the supplied tag in our tag container.

Target  Abl Ability Object Reference  None
Tag     Gameplay Tag Structure        The Gameplay Tag to check for.
Return Value  Boolean  true if we have the supplied tag in our tag container.

Is Channeled

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsChanneled.png

Returns if the Ability is channeled.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if channeled, false if not.

Is Looping

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsLooping.png

Returns true if the Ability is set to loop.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if the Ability is set to loop.

Is Passive

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsPassive.png

Returns true if this Ability is a passive Ability.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if this Ability is a passive Ability.

Matches All Tags

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MatchesAllTags.png

Returns true if we have all the tags from the passed in container in our own container.

Target     Abl Ability Object Reference      None
Container  Gameplay Tag Container Structure  The Gameplay Tag Query to run against our container.
Return Value  Boolean  true if we have all the tags from the passed in container in our own container.

Matches Any Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MatchesAnyTag.png

Returns true if we have any tags from the passed in container in our own container.

Target     Abl Ability Object Reference      None
Container  Gameplay Tag Container Structure  The Gameplay Tag Query to run against our container.
Return Value  Boolean  true if we have any tags from the passed in container in our own container.

Must Finish All Tasks

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MustFinishAllTasks.png

Returns whether or not this Task must finish all tasks before being marked as done (e.g., it can ignore the end time if necessary).

Target  Abl Ability Object Reference  None
Return Value  Boolean  True if we need to must finish all tasks, false otherwise.

Must Pass All Channel Conditions

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MustPassAllChannelConditions.png

Returns true if the Ability must pass all channel conditions to continue channeling.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if the Ability must pass all channel conditions to continue channeling.

On Ability Branch

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityBranchBP.png

Callback for when branching to a new Ability

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [17]

On Ability End

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityEndBP.png

Callback for when the Ability successful ends. This is not called if the Ability is branched or interrupted.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [18]

On Ability Interrupt

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityInterruptBP.png

Callback for when this Ability is Interrupted.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [19]

On Ability Stack Added

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityStackAddedBP.png

Callback that occurs when a stack is added from an executing Ability.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [20]

On Ability Stack Removed

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityStackRemovedBP.png

Callback that occurs when a stack is removed from an executing Ability.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [21]

On Ability Start

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnAbilityStartBP.png

Callback for when the Ability successful starts, after passing all required prerequisites.

Target   Abl Ability Object Reference          None
Context  Abl Ability Context Object Reference  The Ability Context [22]

On Collision Event

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnCollisionEventBP.png

Called by the Collision Query Task to allow any specific logic you wish to do with the Overlap results.

Target        Abl Ability Object Reference          None
Context       Abl Ability Context Object Reference  The Ability Context [23]
Event Name    Name (by ref)                         A simple identifier to distinguish this Event from other possible Collision Event you may have in your Timeline.
Hit Entities  Array of Abl Query Result Structures  Array of results from the Overlap Query
Return Value  EAblCallbackResult Enum  The Callback Result, used by the Overlap Watcher Task to stop future overlaps or continue.

On Custom Event

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnCustomEventBP.png

Called by the Custom Event Task; this callback can be used as a generic entry into your Ability Blueprint to do whatever logic you wish.

Target      Abl Ability Object Reference          None
Context     Abl Ability Context Object Reference  The Ability Context [24]
Event Name  Name (by ref)                         A simple identifier to distinguish this Event from other possible Custom Event you may have in your Timeline.

On Raycast Event

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnRaycastEventBP.png

Called by the Raycast Query Task to allow any specific logic you wish to do with the Raycast results.

Target       Abl Ability Object Reference          None
Context      Abl Ability Context Object Reference  The Ability Context [25]
Event Name   Name (by ref)                         A simple identifier to distinguish this Event from other possible Raycast Event you may have in your Timeline.
Hit Results  Array of Hit Result Structures        Array of results from the Raycast
Return Value  EAblCallbackResult Enum  The Callback Result, this is currently ignored for Raycasts. Set it to "Complete" and ignore it for now.

On Spawned Actor

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_OnSpawnedActorEventBP.png

Called by the Spawn Actor Task; this callback can be used to set any fields (location, velocity, etc) on the newly spawned Actor.

Target         Abl Ability Object Reference          None
Context        Abl Ability Context Object Reference  The Ability Context [26]
Event Name     Name (by ref)                         A simple identifier to distinguish this Event from other possible Spawn Actor Event you may have in your Timeline.
Spawned Actor  Actor Object Reference                The Actor spawned by the Task.
Spawn Index    Integer                               The Spawn Index of this Actor, if spawning multiple actors (0 for 1st, 1 for 2nd, etc).

Refresh Duration on New Stack

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_RefreshDurationOnNewStack.png

Returns true if the duration should be reset any time a new stack is applied to the Ability.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if the duration should be reset any time a new stack is applied to the Ability.

Refresh Loop Time Only

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_RefreshLoopTimeOnly.png

Returns true if, when refreshing duration, only the Loop range should be refreshed.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if, when refreshing duration, only the Loop range should be refreshed.

Requires Target

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_RequiresTarget.png

Returns true if the Ability requires a Target.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if the Ability requires a Target.

Reset Loop Count on Refresh

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_ResetLoopCountOnRefresh.png

Returns true if, when refreshing duration, we should reset the loop count as well.

Target  Abl Ability Object Reference  None
Return Value  Boolean  true if, when refreshing duration, we should reset the loop count as well.

Should Cancel Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_ShouldCancelAbilityBP.png

Called by the Cancel Ability Task to do any custom logic to determine whether or not to cancel the passed in Ability on the Task Target.

Target      Abl Ability Object Reference          None
Context     Abl Ability Context Object Reference  The Ability Context [27]
Ability     Abl Ability Object Reference          The Ability we want to cancel.
Event Name  Name (by ref)                         A simple identifier to distinguish this Event from other possible Cancel Ability Event you may have in your Timeline.
Return Value  Boolean  True to cancel the Ability, false to ignore it.

Activate Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_ActivateAbility.png

Activates the Ability using the provided context and returns the result.

Context  Abl Ability Context Object Reference  The Ability Context [28]
Return Value  EAblAbilityStartResult Enum  the start result returned by the Ability.

Get Ability Object from Class

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityObjectFromClass.png

Returns an instance (CDO) of the provided Ability Class.

Class  Abl Ability Class Reference  None
Return Value  Abl Ability Object Reference  the default class instance.

Is Successful Start Result

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsSuccessfulStartResult.png

Returns true if the provided start result is considered successful.

Result  EAblAbilityStartResult Enum  The result enum returned by another Ability method (CanActivate, Activate, etc).
Return Value  Boolean  true if the result was a success, false if it failed for whatever reason.

Activate Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_ActivateAbility.png

Activates the ability (does call into CanActivateAbility to make sure the call is valid).

Target   Ability Component Object Reference    None
Context  Abl Ability Context Object Reference  The Ability Context [29]
Return Value  EAblAbilityStartResult Enum  the Ability Start Result.

Add Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_AddTag.png

Adds a Gameplay Tag to our tag container.

Target  Ability Component Object Reference  None
Tag     Gameplay Tag Structure              The Gameplay Tag to add.

Branch Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_BranchAbility.png

Attempts to Branch to the provided Ability Context.

Target   Ability Component Object Reference    None
Context  Abl Ability Context Object Reference  The Ability Context [30]
Return Value  EAblAbilityStartResult Enum  the result from the attempted branch.

Can Activate Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CanActivateAbility.png

Runs the Ability Context through the activate logic and returns the result, does not actually activate the Ability.

Target   Ability Component Object Reference    None
Context  Abl Ability Context Object Reference  The Ability Context [31]
Return Value  EAblAbilityStartResult Enum  the predicated start result for the given Context.

Cancel Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CancelAbility.png

Cancels the passed in Ability, if it's currently being played. Accepts both active and passive Abilities.

Target         Ability Component Object Reference  None
Ability        Abl Ability Object Reference        The Ability to check for.
Result to Use  EAblAbilityTaskResult Enum          Which result to apply to the Ability when we cancel it (Interrupted, Successful, Branched).

Check Tags

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CheckTags.png

Returns true if the Ability checks pass a series of Gameplay Tags Queries.

Target                       Ability Component Object Reference         None
Includes Any                 Gameplay Tag Container Structure (by ref)  The tags to check if any of these tags are in our container, or the executing Abilities.
Includes All                 Gameplay Tag Container Structure (by ref)  The tags to check if all of these tags are in our container, or the executing Abilities.
Excludes Any                 Gameplay Tag Container Structure (by ref)  The tags to check if any of these tags are not in our container, or the executing Abilities.
Include Executing Abilities  Boolean                                    If true, run these checks against our executing Ability containers as well.
Return Value  Boolean  true if the our container, or the executing Abilities, checks passed the series of Gameplay Tags queries.

Get Ability Cooldown Ratio

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityCooldownRatio.png

Returns a value between 0.0 - 1.0 which represents how far along the cooldown is.

You can multiply this value by the Cooldown total to get the actual cooldown value in seconds.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to grab the Cooldown ratio for.
Return Value  Float  The Cooldown as a ratio of 0.0 - 1.0.

Get Ability Cooldown Total

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityCooldownTotal.png

Returns the Cooldown that was calculated for this Ability when it was executed.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to grab the calculated Cooldown for.
Return Value  Float  The calculated Cooldown value.

Get Ability Current Time

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityCurrentTime.png

Returns the current time of the Ability, if executing. You can also get this from the Context if you cached it.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to grab the current time from.
Return Value  Float  the current time of the Ability, if executing.

Get Ability Current Time Ratio

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetAbilityCurrentTimeRatio.png

Returns the current time ratio of the Ability, if executing. You can also get this from the Context if you cached it.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to grab the Time ratio for.
Return Value  Float  The current Time ratio, between 0.0 and 1.0.

Get Active Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetActiveAbility.png

Returns the current Active Ability (if there is one).

Target  Ability Component Object Reference  None
Return Value  Abl Ability Object Reference  The current Active Ability, or null if there isn't one.

Get Current Passive Abilities

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetCurrentPassiveAbilities.png

Populates the passed in array with all the Passive Abilities currently active on this component.

Target  Ability Component Object Reference  None
Out Passives  Array of Abl Ability Object References  The array to fill with any running Passive Abilities.

Get Current Stack Count for Passive Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetCurrentStackCountForPassiveAbility.png

Returns the specific stack count for the passed in passive ability, or 0 if not found.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to check stacks for.
Return Value  Integer  the stack count for that Ability, or 0 if not found.

GetGameplayTagContainer

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetGameplayTagContainerBP.png

Returns a copy of the Gameplay Tag container.

Target  Ability Component Object Reference  None
Return Value  Gameplay Tag Container Structure  A copy of our Gameplay Tag container.

Get Total Number Of Passives

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTotalNumberOfPassives.png

Returns the total number of active Passive Abilities on this component.

Target  Ability Component Object Reference  None
Return Value  Integer  the total number of active Passive Abilities running on this component.

Has Ability Animation

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_HasAbilityAnimation.png

If you've set up your Animation Blueprint to use the AbilityAnimPlayer Graph Node,

this method will tell you if you have a Play Animation Task requesting you to use transition to that node.

Target  Ability Component Object Reference  None
Return Value  Boolean  true if we have a queued up Ability Animation, false otherwise.

Has Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_HasTag.png

Returns true if we have the supplied tag in our tag container.

Target                       Ability Component Object Reference  None
Tag                          Gameplay Tag Structure              The Gameplay Tag to check for.
Include Executing Abilities  Boolean                             None
Return Value  Boolean  true if we have the supplied tag in our tag container, or the executing Abilities.

Is Ability on Cooldown

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsAbilityOnCooldown.png

Returns whether or not an Ability is marked as being on Cooldown.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to check for cooldown.
Return Value  Boolean  true if that Ability still is on cooldown, false if not.

Is Passive Active

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsPassiveActive.png

Returns true if the passive Ability passed in is currently active, or not.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to check for.
Return Value  Boolean  true if that Ability still is running, false if not (or not marked as Passive).

Is Playing Ability

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_IsPlayingAbility.png

Returns whether or not the component has an active Ability being played.

Target  Ability Component Object Reference  None
Return Value  Boolean  true if we are currently playing an Ability, false otherwise.

Matches All Tags

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MatchesAllTags.png

Returns true if we have all the tags from the passed in container in our own container.

Target                       Ability Component Object Reference  None
Container                    Gameplay Tag Container Structure    The Gameplay Tag Container to compare our own container against.
Include Executing Abilities  Boolean                             If true, compare the container against our executing Ability containers as well.
Return Value  Boolean  true if we have all the tags from the passed in container in our own container, or the executing Abilities.

Matches Any Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MatchesAnyTag.png

Returns true if we have any tags from the passed in container in our own container.

Target                       Ability Component Object Reference  None
Container                    Gameplay Tag Container Structure    The Gameplay Tag container to compare our own container against.
Include Executing Abilities  Boolean                             If true, compare the container against our executing Ability containers as well.
Return Value  Boolean  true if we have any tags from the passed in container in our own container, or the executing Abilities.

Matches Query

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_MatchesQuery.png

Returns true if we match the supplied query with our GameplayTag container.

Target                       Ability Component Object Reference  None
Query                        Gameplay Tag Query Structure        None
Include Executing Abilities  Boolean                             If true, run the query against our executing Ability containers as well.
Return Value  Boolean  true if we have have a match in our own container, or the executing Abilities.

Remove Cooldown

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_RemoveCooldown.png

Removes the Cooldown for a given ability.

Target   Ability Component Object Reference  None
Ability  Abl Ability Object Reference        The Ability to remove the Cooldown for.

Remove Tag

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_RemoveTag.png

Removes a Gameplay Tag from our tag container.

Target  Ability Component Object Reference  None
Tag     Gameplay Tag Structure              The Gameplay Tag to remove.

Set Cooldown

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_SetCooldown.png

Sets the Cooldown for an Ability. If the Ability isn't currently on cooldown, it will add it. The context is only used when adding a new cooldown.

Target   Ability Component Object Reference    None
Ability  Abl Ability Object Reference          The Ability to set the Cooldown for.
Context  Abl Ability Context Object Reference  The Ability Context [32]
Time     Float                                 The time, in seconds, to set this Cooldown for.

Set Passive Stack Count

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_SetPassiveStackCount.png

Sets the Stack Count of the provided passive, if it exists. Optionally resets the duration of the passive. If the Stack Count is 0, the Ability is canceled with the provided result.

Target                   Ability Component Object Reference  None
Ability                  Abl Ability Object Reference        The Ability to set the stacks for.
New Stack Count          Integer                             What to set the Stack count to.
Reset Duration           Boolean                             If we should reset the Ability duration with this new stack value.
Result to Use on Cancel  EAblAbilityTaskResult Enum          If we are setting the stack to 0, then use this result as the cancel result.

Custom Task

Create Custom Scratch Pad

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_CreateCustomScratchPad.png

Creates a ScratchPad based on the UAblCustomScratchPad, for use by Custom Tasks.

Context            Abl Ability Context Object Reference         The Ability Context [33]
Scratch Pad Class  Abl Custom Task Scratch Pad Class Reference  The Task Scratchpad Subclass to instantiate.
Return Value  Abl Custom Task Scratch Pad Object Reference  the created Custom Scratchpad Object.

GetActorsForTask

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetActorsForTaskBP.png

Returns a list of Actors to execute as Targets for this Task.

Target   Abl Custom Task Object Reference      None
Context  Abl Ability Context Object Reference  The Ability Context [34]
Out Actor Array  Array of Actor Object References  The Array to be populated with Actors.

GetScratchPad

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetScratchPad.png

Returns the Scratchpad of this Task.

Target   Abl Custom Task Object Reference      None
Context  Abl Ability Context Object Reference  The Ability Context [35]
Return Value  Abl Custom Task Scratch Pad Object Reference  The Scratchpad of this Task [36]

GetTaskEndTime

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTaskEndTimeBP.png

Returns the end time of this Task.

Target  Abl Custom Task Object Reference  None
Return Value  Float  The end time of this Task.

GetTaskLength

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTaskLengthBP.png

Returns the length (end - start) of this Task.

Target  Abl Custom Task Object Reference  None
Return Value  Float  The length of this Task.

GetTaskStartTime

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_GetTaskStartTimeBP.png

Returns the start time of this Task.

Target  Abl Custom Task Object Reference  None
Return Value  Float  The start time of this Task.

Animation

Play Ability Animation

https://able.extralifestudios.com/wiki/BlueprintAPI/nd_img_UAnimGraphNode_AbilityAnimPlayer.png

Allows for the dynamic playing of animations using the Play Animation task.

Pose  Pose Link Structure  None