WoW API: UnitPlayerControlled

Reference e
AddOns WoW API Widget API XML UI Event API WoW Lua Macro API CVars Battle.net HOWTOs Snippets UI tech Categories

→ WoW API

← WoW API < UnitPlayerControlled

Return whether the "unit" is controlled by a player or an NPC.

UnitIsPlayerControlled = UnitPlayerControlled("unit")

Parameters

Arguments

("unit")

unit

String - The UnitId to select as a target. Using a unit's name as the unit ID only works if the unit is a member of your party.

Returns

UnitIsPlayerControlled

UnitIsPlayerControlled

Boolean - Returns true if the "unit" is controlled by a player.
Returns false if the "unit" is an NPC.

Example

if (UnitPlayerControlled("target")) then
  DEFAULT_CHAT_FRAME:AddMessage("Your selected target is a player.",1,1,0)
else
  DEFAULT_CHAT_FRAME:AddMessage("Your selected target is an NPC.",1,1,0)
end

Info

DEFAULT_CHAT_FRAME:AddMessage("text",r,g,b)

ScrollingMessageFrame:AddMessage("text",r,g,b,id)

Valid Frame names:
DEFAULT_CHAT_FRAME
ChatFrame1 - ChatFrame7