Viewer Queue Module

The Viewer Queue module allows streamers to create and manage a queue where viewers can join and be selected. This feature is particularly useful for organizing viewer interactions, such as game participation, Q&A sessions, or giveaways during live streams.

Usage

Streamers and moderators manage the queue with !queue subcommands, while viewers join and check their place with their own set of subcommands. See the !queue command reference for the full syntax of every subcommand.

Examples

1. Opening a queue for viewers to join a game:

   Example chat

   ModUser:!queue open Viewer games

   StreamElements:The Viewer games queue is now open! Viewers can type !queue join to enter.

   Viewer1:!queue join

   StreamElements:@Viewer1, you have been added to the queue in position #1.

   Viewer2:!queue join

   StreamElements:@Viewer2, you have been added to the queue in position #2.

2. Picking a viewer from the queue:

   Example chat

   ModUser:!queue pick random

   StreamElements:@Viewer1 has been picked from the queue!

Related Commands

Viewer subcommands:

• !queue join: Enter the open queue.
• !queue position: Check your current position in the queue.
• !queue list: List the next viewers waiting in the queue.

Moderator subcommands:

• !queue open <title>: Open a queue with the given title for viewers to join.
• !queue close: Close the queue, preventing new entries.
• !queue pause: Temporarily stop viewers from joining.
• !queue unpause: Resume allowing viewers to join.
• !queue pick <username|random>: Select a specific user, or a random one, from the queue.
• !queue remove <username>: Remove a specific user from the queue.

Configuration

The Viewer Queue module has two settings in the StreamElements dashboard:

• Whether the module is enabled
• The start message posted in chat when a queue opens

Queue size and eligibility limits (such as who is allowed to join) are managed by the queue service through the dashboard, not by the chatbot module settings.

FAQ

Q: Can viewers join the queue multiple times? A: Viewers can only join the queue once.

Q: How long does a queue last? A: The queue remains active until it’s manually closed by a moderator, or until the stream ends.