GetPVPTimer

Main Menu
WoW API Lua API FrameXML Widget API Widget scripts XML schema Events CVars Macro commands Combat Log Escape sequences Hyperlinks API changes HOWTOs wowuidev

Flavors
war within  mainline  cata  wrath  vanilla
Links
Blizzard Docs  Townlong Yak  Offline /api  Wowprogramming  GitHub Search
Info
Added in 2.0.1 / 1.13.2

Returns the time left in milliseconds until the player is unflagged for PvP.

timer = GetPVPTimer()

Returns

timer

number - Amount of time (in milliseconds) until your PVP flag wears off.

Details

• If you are flagged for PVP permanently, the function returns 301000.
• If you are not flagged for PVP the function returns either 301000 or -1.

Example

The following snippet displays your current PVP status:

local sec = math.floor(GetPVPTimer()/1000)
local msg = (not UnitIsPVP("player")) and "You are not flagged for PVP" or 
            (sec==301 and "You are perma-flagged for PVP" or 
             "Your PVP flag wears off in "..(sec>60 and math.floor(sec/60).." minutes " or "")..(sec%60).." seconds")
DEFAULT_CHAT_FRAME:AddMessage(msg)