The queue system tracks whose turn it is. Viewers join with a command, you advance the line, the bot announces who's up, and there's a public page showing the list.
What it solves
When you play with viewers, the thing that eats your attention usually isn't the game — it's keeping track of the order: who asked first, who already played, who just arrived. Scrolling back through chat for names falls apart the first time it gets busy. The queue hands that bookkeeping to the machine: the order is recorded, turns are announced, and you just hit next.
Getting started
- Enable the queue module and set the
waiting list limit. - Open the queue in chat with
!qstart(!qstopcloses it). - Viewers join with the join command; you advance from the dashboard or with control commands.
- Optionally bind a Twitch custom reward so redeeming it joins the queue automatically.
Common misconceptions
-
Opening and closing are chat commands, not the module toggle.
Enabling the module only makes the feature available; each actual session starts with
!qstart. That's what lets you open and close it repeatedly during one stream without going back to the dashboard. - At the limit, joining is declined rather than queued behind. The limit counts people waiting, not the total — advancing someone frees a slot.
- If the bound reward accepts text input, that text becomes the queue note. Handy for collecting "what do you want to play" or an in-game ID without asking separately.
- Command cooldowns, aliases and permissions aren't configured here. This page governs the queue rules; command details live on the Commands page.
- The public list page is for viewers, not for managing. Viewers check their position there; advancing, reordering and removing all happen in the dashboard.
Settings
Leave blank to use the bot's default message. Available variables are listed under the "Insert variable" button beside each input.
The text below is taken from the in-app help, so it stays in sync with the actual interface.
| Setting | What it does |
|---|---|
| Queue status | Open/stop the queue with !qstart / !qstop in chat. |
| Queue mode | Controls ordering and whether re-joining is allowed |
| Custom loyalty reward name | When a viewer redeems the chosen Channel Points reward, they are added to the queue automatically; if the reward allows text input, that text becomes their queue note. Leave blank to unbind. |
| Panel title | Shown at the top of the panel; leave blank to hide |
| Show now playing | Show members currently called up |
| Waiting list size | How many of the waiting list to show (0 = hide waiting list) |
| Show play count | Show how many times each member has been called up |
| Panel width | Fixed width in px; 0 = auto to content |
Chat commands
These are the default command names; they can be renamed or given aliases in the dashboard.
!qjoin— Join the queue, use !join <nickname> to add a nickname to the queue list!qleave— Use this command to leave the queue!qlist— Show Queue List URL!qinfo— Query queue-related information!qstart— Start allow join the queue!qstop— Stop new join request!qnext— Call a new round queue!qclear— Clear queue records
Other notes
- Once the waiting list is full, !qjoin is declined (max 200)
- Viewers use these to join or check the queue; mods use the control commands to manage it. Fine-tune cooldown, aliases and permissions on the Commands page.
- note
- Viewers join with !qjoin or by redeeming the reward; manage the queue live here. Auto-refreshes every 12s.
- Show queue note
- Show the note passed with !qjoin (e.g. game ID) after the name
Other settings
These settings have no additional help text in the dashboard; only their names are listed here.
- Open
- Stopped
- Max participants
- In order of join request (FIFO)
- Only join one time
- Fewer join times go first
- Queue rules
- Chat commands
- Viewer commands
- Mod commands
- MOD only
- Go to command settings
- count
- Query
- Join
- Leave
- Control
- Joined
- Already in queue
- No longer accepting
- Already participated
- Queue full
- Left queue
- Not in queue
- Queue list
- Queue info
- Call next round
- Queue cleared
- Invalid number
- Reply when a viewer asks for the queue list page link.
- Reply when a viewer checks the current and next round (mode and open status are appended automatically).
- Reply after successfully joining the queue (includes the position).
- Shown when a viewer already in the queue tries to join again.
- Shown when the queue is closed to new joins.
- Shown in join-once mode when the viewer has already participated.
- Shown when the waiting list has reached its limit.
- Reply after successfully leaving the queue.
- Shown when a viewer not waiting in the queue tries to leave.
- Announces the current and next round in chat after a MOD calls the next round (the dashboard list button triggers it too).
- Reply after a MOD clears the queue.
- Shown when the !qnext amount is not a valid number.
- Default:
- Reset to default
- Queue position
- Max participants
- Channel login
- Current round list
- Next round list
- Count
- Call next
- Refresh
- Clear queue
- Now playing
- Waiting
- No one is playing yet
- The queue is empty
- Set playing
- Pin
- Unpin
- Remove
- Pinned
- Content
- Appearance
- Font
- Font size
- Text color
- Title / now-playing color
- Panel background
- Channel Points reward trigger
- Add to queue
- User not found — check the Twitch username or URL