WoW:UnitId: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
m (Removed " or <tt>"NPC"</tt>" since tokens are not case sensitive. Added "Others" section. Added stuff under "player".)
m (Move page script moved page UnitId to UnitId without leaving a redirect)
 
(14 intermediate revisions by 12 users not shown)
Line 1: Line 1:
{{wowapitype}}
#REDIRECT [[API TYPE UnitId]]
 
Many of the API functions which act on units in the game world (Players, NPC's, Monsters, etc) refer to the unit in question by an identifier that is related to how the player is accessing the unit.  The following values are available (they are '''not''' case sensitive):
 
== Base Values ==
 
; <tt>"focus"</tt> : The current player's focus target as selected by the /focus command. (Added in 2.0.0)
 
; <tt>"player"</tt> : The current player.
:: It appears that you can also use the current player's proper name in place of "player" (e.g. "[[Server:Cenarion_Circle_US/Treader|Treader]]"). Although; it seems a little unnecessary since "player" requires no effort from the Lua engine. Plus getting the current player's proper name involves passing "player" to [[API_UnitName|UnitName]](), so you might as well just pass "player" to whichever function you are calling.
 
; <tt>"pet"</tt> : The current player's pet
 
; <tt>"party''N''"</tt> : The ''N''th party member excluding the player (1,2,3 or 4)
 
; <tt>"partypet''N''"</tt> : The pet of the ''N''th party member (N is 1,2,3, or 4) (Added in 1.5.0)
 
; <tt>"raid''N''"</tt> : The raid member with [[raidIndex]] ''N'' (1,2,3,...,40).
 
; <tt>"raidpet''N''"</tt> : The pet of the raid member with [[raidIndex]] ''N'' (1,2,3,...,40)  (Added in 1.5.0)
 
; <tt>"target"</tt> : The currently targetted unit. May be overriden in macros by unit specified as a value of respective Secure Button attribute.
 
; <tt>"playertarget"</tt> : The currently targetted unit. Always.
 
; <tt>"mouseover"</tt> : The unit which the mouse is currently (or was most recently) hovering over
 
; <tt>"none"</tt>: A valid unit token that always refers to no unit.
 
==Others==
The following value also appears in some very specific places (Vendor interactions, for example) or functions.
 
; <tt>"npc"</tt> : The NPC with which the player is currently interacting.
 
== Targets ==
 
You can append the suffix <tt>target</tt> to any UnitId to get a UnitId which refers to that unit's target (e.g. <tt>"partypet2target"</tt>). This appending can be repeated indefinitely (e.g. <tt>"playertargettarget"</tt>), though you will observe an attendant performance hit if you overdo it, as the game engine has to jump from target to target.
 
== Notes ==
 
Many of the functions which take a UnitId only provide useful results for a subset of ID's. Other functions will only provide information for friendly targets (or those upon which a power is active).
 
Also, some functions return different values if the target is close enough to be 'visible' to your client (not necessarily in line of sight), as can be determined with [[API UnitIsVisible|UnitIsVisible("unit")]], versus further away.

Latest revision as of 04:49, 15 August 2023

Redirect to:

Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:UnitId&oldid=20721"