/lobby
Create private thread rooms for organizing matches with joins, moderation, game IDs, mapinfo, and optional trackers.
Requirements
- Bot can send messages - to post the public lobby card and thread control embed.
- Bot can manage threads - to create, pin, refresh, and clean up the private room.
- Bot can manage messages - to keep the control cards up to date.
- User can use application commands - so that the bot's slash commands are available.
- Server lobbies enabled - the feature can be disabled per server through /config.
What It Does
/lobby creates a private thread-backed room for friends to organize a public match without exchanging IDs up front.
The bot posts a public control card in the parent channel, creates the private thread, adds the creator, and pins a second control card inside the thread.
Lobbies enforce one active lobby per creator per guild, count the creator toward the capacity, and let the creator moderate the room with kick, ban, and unban controls. Banned users cannot rejoin until they are unbanned or the lobby is deleted.
A lobby can also carry a lobby-managed tracker and run an emulated /mapinfo from inside the room.
Game IDs can be set while the lobby is open, and the thread controls update whenever the lobby changes.
Parameters
| Command | Parameter | Required? | Description |
|---|---|---|---|
| /lobby create | |||
title | Text | ✔️ | Lobby title shown in the control cards. |
game | Choice | ✔️ | Game family used for the lobby preview. |
capacity | Integer | Optional | Maximum number of members, including the creator. Default is 10. |
| /lobby list | |||
| No parameters required. | |||
| /lobby lock | |||
lobby | Lobby selector | Optional | Choose the lobby to lock. |
| /lobby close | |||
lobby | Lobby selector | Optional | Archive and freeze the lobby without deleting the record. |
| /lobby delete | |||
lobby | Lobby selector | Optional | Delete the lobby and clean it up completely. |
| /lobby kick | |||
user | Text | ✔️ | Discord name or user ID of the member to remove. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby ban | |||
user | Text | ✔️ | Discord name or user ID of the member to ban from rejoining. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby unban | |||
user | Text | ✔️ | Discord name or user ID of the member to allow back in. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby mapinfo | |||
game_id | Text | Optional | Overrides the lobby's stored live game ID. |
params | Text | Optional | Extra /mapinfo flags to forward through the emulation layer. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby gameid set | |||
game_id | Text | ✔️ | Numeric live game ID for the room. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby gameid show | |||
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby tracker init | |||
lobby | Lobby selector | Optional | Creates the lobby-managed tracker. |
| /lobby tracker configure | |||
lobby | Lobby selector | Optional | Choose the lobby. |
title | Text | Optional | Custom tracker title. |
options | Text | Optional | Map output flags such as --cm --mm. |
publish | Boolean | Optional | Publish updates when the target channel supports it. |
| /lobby tracker test | |||
lobby | Lobby selector | Optional | Tests the attached tracker without starting a real run. |
| /lobby tracker toggle | |||
enabled | Boolean | ✔️ | Enables or disables the lobby tracker. |
lobby | Lobby selector | Optional | Choose the lobby. |
| /lobby tracker remove | |||
lobby | Lobby selector | Optional | Deletes the tracker attached to the lobby. |
Examples
Create a lobby
/lobby createtitle: Friday Roomgame: Supremacy 1914capacity: 10Creates the public control card and the private thread room.
Set the game ID and test the tracker
/lobby gameid setgame_id: 10293847/lobby tracker testThe lobby cards update immediately and the tracker test only validates permissions and map data.
Additional Notes
- The creator counts toward the lobby capacity from the moment the lobby is created.
- Banned users cannot rejoin until they are unbanned or the lobby is deleted.
- The thread control card is pinned and refreshed whenever the lobby changes.
- If the bot cannot maintain the thread controls, the lobby is treated as unhealthy and cleaned up instead of being left half-broken.