WoW:API CheckInteractDistance: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(corrected Follow distance)
m (1.12 info, formatting)
Line 1: Line 1:
<center>'''CheckInteractDistance''' </center>
{{wowapi}}


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


----
----
Line 9: Line 9:


:;unit : The unit to query (e.g. "target", "party1", "pet", "player")
:;unit : The unit to query (e.g. "target", "party1", "pet", "player")
:;distIndex : A value 1-4  
:;distIndex : A value 1-4:
:1 = Inspect, 5.55 yards
:::1 = Inspect, 5.55 yards (as of Patch 1.12, this will double)
:2 = Trade, 11.11 yards
:::2 = Trade, 11.11 yards
:3 = Duel, 10 yards
:::3 = Duel, 10 yards
:4 = Follow, ~28 yards
:::4 = Follow, ~28 yards


----
----
;''Returns''
;''Returns''


:Boolean canInteract
:;canInteract : If in range to perform the action, 1 (true).  Otherwise, nil (false).
1
 
nil
 
:;canInteract : True if in range to perform the action.  Otherwise, false.


----
----
Line 38: Line 33:
  else
  else
   -- we're too far away to follow the target
   -- we're too far away to follow the target
  end;
  end
 
 
----
{{WoW API}}

Revision as of 15:47, 17 July 2006

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, 5.55 yards (as of Patch 1.12, this will double)
2 = Trade, 11.11 yards
3 = Duel, 10 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