Maintenance script: UI Lua API import (WAR 1.4.8)

2026-10-16T19:45:55Z

UI Lua API import (WAR 1.4.8)

New page

{{LuaApi|group=Ability}}
Checks the player's current target against an ability.

<pre>
isTargetValid, hasTarget = IsTargetValid(abilityId)
</pre>

== Arguments ==
;abilityId : <code>number</code> – Id of the ability. It is converted to a 16-bit integer.

== Returns ==
;isTargetValid : <code>boolean</code> – <code>true</code> if the ability can be used on the current target.
;hasTarget : <code>boolean</code> – <code>true</code> if the target slot the ability uses (hostile or friendly) holds an object.

== Details ==
* Which target slot is used depends on the ability's <code>targetType</code> (see [[API:GetAbilityData|GetAbilityData]]): target types 0, 2, 3 and 5 use the friendly target, all others the hostile target.
* The first value comes from the client's target check: it looks at the target's state and type and at the ability's range. Abilities with target type 0 always pass.
* Both values are <code>false</code> for an unknown ability and when there is no player object.
* The stock morale bar shows the ability text in red only when a target exists and is not valid: <code>isTargetValid or (hasTarget == false)</code>.

== Errors ==
None besides the generic ''Invalid Parameters'' message when the argument is missing or not a number.

== Example ==
From <code>ea_moralewindow/source/moralewindow.lua</code>:
<pre>
local isTargetValid, hasRequiredUnitTypeTargeted = IsTargetValid (abilityId)

local isTargetValid = (isTargetValid or (hasRequiredUnitTypeTargeted == false))
</pre>

== See also ==
* [[API:IsAbilityEnabled|IsAbilityEnabled]]
* [[API:GetAbilityRanges|GetAbilityRanges]]
* [[API:GetUpdatedTargets|GetUpdatedTargets]]

API:IsTargetValid - Revision history

Maintenance script: UI Lua API import (WAR 1.4.8)