WoW API: CheckInteractDistance

From AddOn Studio
Revision as of 02:18, 25 August 2007 by WoWWiki>Balyn
Jump to navigation Jump to search

WoW API < CheckInteractDistance

Returns 1 if you are in range of the specified unit to perform the action specified by distIndex (returns nil otherwise).


Arguments
(String unit, Int distIndex)
unit
The unit to query (e.g. "target", "party1", "pet", "player")
distIndex
A value 1-4:
1 = Inspect, ~28 yards (prior to Patch 2.1 this was 11.11 yards)
2 = Trade, ~7 yards
3 = Duel, ~7 yards
4 = Follow, ~28 yards

Returns
canInteract
If in range to perform the action, 1 (true). Otherwise, nil (false).

Notes
If "unit" is a hostile unit, the return values are the same. But you obviously won't be able to do things like Trade.
There may also be more values for distIndex that we don't know about.

Example
if ( CheckInteractDistance("target", 4) ) then
  FollowUnit("target");
else
  -- we're too far away to follow the target
end