WoW:API IsSpellInRange - Revision history

Move page script: Move page script moved page API IsSpellInRange to WoW:API IsSpellInRange without leaving a redirect

2023-08-15T04:46:46Z

Move page script moved page API IsSpellInRange to API IsSpellInRange without leaving a redirect

← Older revision

Revision as of 04:46, 15 August 2023

WoWWiki>DrStorm: IsVisible (no longer?) exists. Only UnitIsVisible

2010-09-17T20:10:28Z

IsVisible (no longer?) exists. Only UnitIsVisible

← Older revision		Revision as of 20:10, 17 September 2010
Line 23:		Line 23:
	local inRange = 0		local inRange = 0
	local unit = "party1"		local unit = "party1"
	if UnitExists(unit) and ~~IsVisible~~(unit) and UnitIsFriend(unit) then		if UnitExists(unit) and UnitIsVisible(unit) and UnitIsFriend(unit) then
	inRange = IsSpellInRange("Heal",unit)		inRange = IsSpellInRange("Heal",unit)
	end		end

WoWWiki>Hobinheim: upgraded code block

2007-05-16T16:09:03Z

upgraded code block

← Older revision		Revision as of 16:09, 16 May 2007
Line 1:		Line 1:
	{{wowapi}} ~~__NOTOC__~~		{{wowapi}}

	~~{{Code/Begin}}~~		inRange = IsSpellInRange(spellID, spellType, unit)
	inRange = IsSpellInRange(spellID, spellType, unit)		inRange = IsSpellInRange(spellName, unit)

	inRange = IsSpellInRange(spellName, unit)
	~~{{Code/End}}~~

	== Parameters ==		== Parameters ==

WoWWiki>Ozymandius at 22:16, 25 January 2007

2007-01-25T22:16:50Z

New page

{{wowapi}} __NOTOC__

{{Code/Begin}}
inRange = IsSpellInRange(spellID, spellType, unit)

inRange = IsSpellInRange(spellName, unit)
{{Code/End}}

== Parameters ==

<big>'''Arguments'''</big>

:(spellID, spellType, unit) OR (spellName, unit)

:;spellID : Number , the number of the spell in the spell book
:;spellType : String, "spell" or "pet" to identify the spellbook the spell refers to
:;spellName : String, Alternative (since 2.0), just give the spell name with no rank (e.g. "Heal")
:;unit: String, the unitID of the target

<big>'''Returns'''</big>


:;inRange : '0' if out of range, '1' if in range, or 'nil' if the unit is invalid.
== Example ==

local inRange = 0
local unit = "party1"
if UnitExists(unit) and IsVisible(unit) and UnitIsFriend(unit) then
inRange = IsSpellInRange("Heal",unit)
end
if inRange==1 then
Print("party1 is in healing range!")
else
Print("Cannot heal party1")
end

==Details==
This takes into account talents etc. but watch out for the 'nil' return.

You will get a 'nil' if:
#The spell cannot be cast on the unit. i.e. attempting to check range using 'Frostbolt' on a party member will always return 'nil', similarly testing 'Heal' against an enemy target will also return nil.
#If the unit is not 'visible' (see [[API UnitIsVisible]]) then you will get a nil, and not a '0' as you might expect.
#The unit doesnt exist (e.g. 'target' when you have nothing targetted)
#The current player does not know this spell (so you cannot use 'Heal' to test 40 yard range for anyone other than a priest)

It can be used for scanning raid members distances, but just take care what spell you use. For example scanning heal range will start throwing out 'nil' if a raid member is mind controlled.