GetBattlefieldStatus

From Warcraft Wiki
Jump to navigation Jump to search
Flavors
Links
Info
Added in 1.4.0 / 1.13.2

Returns the status of the battlefield the player is either queued for or inside.

status, mapName, teamSize, registeredMatch, suspendedQueue, queueType, gameType, role, asGroup, shortDescription, longDescription = GetBattlefieldStatus(index)

Arguments

index
number - Index of the battlefield you wish to view, in the range of 1 to GetMaxBattlefieldID()

Returns

status
string - Battlefield status, one of:
  • queued - Waiting for a battlefield to become ready, you're in the queue
  • confirm - Ready to join a battlefield
  • active - Inside an active battlefield
  • none - Not queued for anything in this index
  • error - This should never happen
mapName
string - Localized name of the battlefield (eg. Warsong Gulch or Blade's Edge Arena)
teamSize
number - Team size of the battlefields queue (2, 3 or 5 in an arena queue, or 0 in other queue types)
registeredMatch
number - 1 in a registered arena queue, or 0 in a skirimish or non-arena queue; use teamSize to check for arenas.
suspendedQueue
unknown - (used to determine whether the eye icon on the LFG minimap button should animate, presumed boolean or 1/nil)
queueType
string - The type of battleground, one of:
  • ARENA
  • BATTLEGROUND
  • WARGAME
gameType
string - ??? (displayed as-is to the user on the queue ready dialog, so presumed localized; can be an empty string)
role
string - The role assigned to the player (TANK, DAMAGER, HEALER) in a non-rated battleground, or nil for other queue types.
asGroup
unknown
shortDescription
string
longDescription
string

Patch changes

Mists of Pandaria Patch 5.2.0 (2013-03-05): Return values changed. Removed instanceID, lowestLevel and highestLevel. Added suspendedQueue, queueType, gameType and role.