WoW:API JoinBattlefield: Difference between revisions

← Older edit

WoW:API JoinBattlefield (source)

Revision as of 04:46, 15 August 2023

433 bytes added , 15 August 2023

m

Move page script moved page API JoinBattlefield to WoW:API JoinBattlefield without leaving a redirect

Anonymous user

Move page script

@@ Line 1: / Line 1: @@
-{{wowapi}}
+{{wowapi}} __NOTOC__
-Queues the player, or the players group for a battlefield.
+Queues the player, or the player's group, for a battlefield instance.
+ JoinBattlefield(index[, asGroup[, isRated]])
- JoinBattlefield(index, joinAs, isRated)
+== Arguments ==
+;index : Number - Which battlefield instance to queue for (0 for first available), or which arena bracket to queue for.
+;asGroup : Boolean - If true-equivalent, the player's group is queued for the battlefield, otherwise, only the player is queued.
+;isRated : Boolean - If true-equivalent, and queueing for an arena bracket, the group is queued for a rated match as opposed to a skirmish.
-== Parameters ==
+== Details ==
-=== Arguments ===
+The function requests the player to be added to a queue for a particular instance of the currently selected battleground type, as set by {{api|RequestBattlegroundInstanceInfo}}(index). You CANNOT queue immediately after a {{api|RequestBattlegroundInstanceInfo}} call, and must instead capture the event that indicates that the instance list is available.
-:index, joinAs, isRated
-:;index : Integer - Which battlefield instance to queue for (0 for first available), or which arena bracket to queue for
+== Example ==
-:;joinAs : Integer - Queue as a group
+The following code creates a utility function, JoinBattlegroundType, which allows you to queue for the first available instance of a specific battleground type.
-:;isRated : Integer - Queues for a rated arena
+ do
+  local f, aG, iR = CreateFrame("FRAME");
-----
+  f:SetScript("OnEvent", function(self, event)
-=== Details ===
+   JoinBattlefield(0, aG, iR);
-Queues the player for the current battlefield they have open. When the Arena Battlemaster window is open, index 1 is 2vs2, index 2 is 3vs3 and index 3 is 5vs5, if you pass the "isRated" flag it'll queue for a rated arena, if you don't it'll queue for a Skirmish arena.
+   self:UnregisterEvent("PVPQUEUE_ANYWHERE_SHOW");
+  end);
-[[Patch 2.0.3]] You can no longer queue a group for Alterac Valley, and if the battlefield window is closed it won't queue you for the last opened battlefield. Because of this, it's possible to do send a JoinBattlefield request and then not be queued if you jump away too quickly and close the window.
+  function JoinBattlegroundType(index, asGroup, isRated)
+   if f:IsEventRegistered("PVPQUEUE_ANYWHERE_SHOW") then
-[[Patch 2.4.0]] Queuing for Alterac Valley as a group is back
+    error("A join battleground request is already being processed");
-----
+   end
+   f:RegisterEvent("PVPQUEUE_ANYWHERE_SHOW");
+   aG, iR = asGroup, isRated;
+   RequestBattlegroundInstanceInfo(index);
+  end
+ end
-=== Example ===
-Queue the players group for the battlefield window open.
- if( CanJoinBattlefieldAsGroup() ) then
+The following will queue you for Skirmish 2v2 if not in a group.
-   -- Queue as a group for the first available battleground
-   JoinBattlefield(0, 1);
- else
-   -- Solo queue for the first available battleground
-   JoinBattlefield(0);
- end
-Queue the players group for a rated 3vs3 arena.
+ /script JoinBattlefield(1)
- JoinBattlefield(2, 1, 1);
+== Notes ==
+* When the Arena Battlemaster window is open, index 1 is 2vs2, index 2 is 3vs3 and index 3 is 5vs5.
-__NOTOC__
+== See Also ==
+* {{api|CanJoinBattlefieldAsGroup}}