Skip to main content

!queue

Twitch YouTube Trovo Kick

Overview​

The !queue command suite helps manage a viewer queue, often used for activities like playing games with the streamer. It allows viewers to join, check their position, and moderators to manage the queue (open, close, pick, remove).

Important: Most subcommands (open, close, pause, unpause, pick, remove) typically require Moderator permission level or higher.

Usage​

The general syntax follows this pattern:

!queue <subcommand> [arguments...]

Examples​

Here's a breakdown of common subcommands:

join​

Allows a viewer to enter the open queue.

  • Syntax: !queue join
  • Example:
    example chat
    ViewerName:!queue join
    partner badgemoderator badgeStreamElements:@User, you have been added to the queue in position #5.

leave​

Allows a viewer to remove themselves from the queue.

  • Syntax: !queue leave
  • Example:
    example chat
    ViewerName:!queue leave
    partner badgemoderator badgeStreamElements:@User, you have been removed from the queue.

position​

Checks the command user's current position in the queue.

  • Syntax: !queue position
  • Example:
    example chat
    ViewerName:!queue position
    partner badgemoderator badgeStreamElements:@User, you are currently position #3 in the queue.

list​

Provides a link to view the full queue.

  • Syntax: !queue list
  • Example:
    example chat
    ViewerName:!queue list
    partner badgemoderator badgeStreamElements:View the queue here: https://streamelements.com/YOUR_CHANNEL/queue

open (Moderator+)​

Opens the queue, allowing viewers to join.

  • Syntax: !queue open
  • Example:
    example chat
    moderator badgeModUser:!queue open
    partner badgemoderator badgeStreamElements:@Moderator, The queue is now open! Viewers can type !queue join to enter.

close (Moderator+)​

Closes the queue, preventing new viewers from joining.

  • Syntax: !queue close
  • Example:
    example chat
    moderator badgeModUser:!queue close
    partner badgemoderator badgeStreamElements:@Moderator, The queue is now closed.

pause (Moderator+)​

Temporarily stops viewers from joining the queue (similar to close, but implies temporary).

  • Syntax: !queue pause
  • Example:
    example chat
    moderator badgeModUser:!queue pause
    partner badgemoderator badgeStreamElements:@Moderator, The queue is paused.

unpause (Moderator+)​

Resumes allowing viewers to join the paused queue.

  • Syntax: !queue unpause
  • Example:
    example chat
    moderator badgeModUser:!queue unpause
    partner badgemoderator badgeStreamElements:@Moderator, The queue is no longer paused.

pick [random | <username>] (Moderator+)​

Selects the next participant from the queue.

  • Syntax:
    • !queue pick random (Selects randomly)
    • !queue pick <username> (Selects a specific user)
    • !queue pick (Often defaults to picking the user at position #1)
  • Example (random):
    example chat
    moderator badgeModUser:!queue pick random
    partner badgemoderator badgeStreamElements:@LuckyViewer has been randomly selected from the queue!
  • Example (specific):
    example chat
    moderator badgeModUser:!queue pick SpecificUser
    partner badgemoderator badgeStreamElements:@SpecificUser has been picked from the queue!

remove <username> (Moderator+)​

Removes a specific user from the queue.

  • Syntax: !queue remove <username>
  • Example:
    example chat
    moderator badgeModUser:!queue remove ProblemUser
    partner badgemoderator badgeStreamElements:@Moderator, ProblemUser has been removed from the queue.

Configuration​

  • The Queue module must be enabled in your StreamElements Dashboard under Chatbot -> Modules.
  • Queue settings (like max size, subscriber luck, messages) are configured within the module settings on the Dashboard.
  • Permission levels for subcommands can be adjusted under Chatbot -> Chat Commands -> Default Commands.
  • This command is self-contained for queue management.