Skip to main content

LEAVE_QUEUE

Triggered when one or more players leave a queue.

Example Payload

{
"action": "LEAVE_QUEUE",
"queue": "valorant",
"channel": "1234567890123456789",
"guild": "9876543210987654321",
"players": [
{
"name": "Player1#1234",
"id": "111222333444555666",
"mmr": 1500,
"role": "Duelist",
"team_num": -1,
"top_role_index": 0,
"ign": "PlayerIGN1",
"timestamp": 1707523200.0,
"pulled_from": null
}
],
"players_removed": [
{
"name": "Player2#5678",
"id": "222333444555666777",
"mmr": 1450,
"role": "Controller",
"team_num": -1,
"top_role_index": 1,
"ign": "PlayerIGN2",
"timestamp": 1707523250.0,
"pulled_from": null
}
]
}

Payload Fields

FieldTypeDescription
actionstringAlways "LEAVE_QUEUE"
queuestringThe name/identifier of the queue
channelstringDiscord channel ID where the event occurred
guildstringDiscord guild (server) ID
playersPlayer[]Remaining players in the queue
players_removedPlayer[]The player(s) who left

When This Event Fires

This webhook is sent when:

  • A player manually leaves the queue
  • A player is removed by a moderator
  • A player is kicked for AFK
  • Multiple players are removed simultaneously

Use Cases

  • Track when players abandon queues
  • Monitor AFK kick rates
  • Alert moderators when key players leave
  • Update queue status displays
  • Analyze peak dropout times

Implementation Example

def handle_leave_queue(data):
queue_name = data['queue']
removed_players = data['players_removed']
remaining_count = len(data['players'])

for player in removed_players:
print(f"{player['name']} left {queue_name}")
print(f"{remaining_count} players remaining")

# Example: Alert if queue drops below threshold
if remaining_count < 5:
send_alert("Queue needs more players!")