Skip to content

Random List Item Commands

Introduction

Random List Item commands allow you to create interactive elements that select and display random items from a custom text file. This feature is particularly useful for:

  • Selecting random games from your collection
  • Choosing films for movie nights
  • Picking winners from chatter lists
  • Sharing speedrun statistics
  • Creating interactive giveaways

Initial Setup Process:

  • Access your dashboard’s Commands tab
  • Click the green “Add New Command” button
  • Select ‘Random List Item Command’ from the options

Important File Requirements

Before setting up your command, ensure your list meets these specifications:

  • File must be in .txt format
  • Each item must be on a separate line
  • Microsoft Word formats are not supported
  • File should be properly formatted and checked
  • Content should be appropriate for your stream

Setup Process

1. Command Name Configuration

  • Choose a memorable, relevant name
  • Remember all commands require an exclamation mark (!) prefix
  • Examples:
    • !pickgame
    • !movienight
    • !winner
    • !speedrun

2. Permission Level Selection

Choose who can use the command from these options:

  • Anyone
  • Followers
  • VIPs
  • Subscribers
  • Moderators
  • Broadcasters

3. Text File Upload

Two methods available for file upload:

  • Drag and drop file into the grey box
  • Browse local directory using the file selector

File Requirements:

  • Must be .txt format
  • Each item on a new line
  • No Word document formats (.doc, .docx)
  • Clear, readable content
  • Properly formatted lists

4. AI Response Configuration

Toggle AI responses on/off:

  • When enabled:
    • Uses AI to craft unique responses
    • Requires AI text tokens per use
    • Must include {selected_list_item} in instructions
    • Can create more dynamic interactions
  • When disabled:
    • Uses static response text
    • No token consumption
    • More predictable output

5. Response Setup

Configure how the bot announces the selected item:

Static Response:

  • AI toggle must be off
  • Enter fixed message template
  • Use {selected_list_item} to show selection
  • Keep messages clear and consistent

AI Response:

  • AI toggle must be on
  • Provide clear instructions
  • Include {selected_list_item} merge field
  • Consider token usage

Additional merge fields available for customisation

6. Cooldown Settings

  • Set appropriate delay between uses
  • Measured in seconds
  • Prevents command spam
  • Consider:
    • Stream pace
    • List size
    • Usage frequency
    • Chat activity level

Best Practices

File Preparation

  • Keep lists organised and up-to-date
  • Check formatting before upload
  • Maintain backup copies
  • Regular content reviews
  • Clear, consistent formatting

Response Configuration

  • Keep messages clear and engaging
  • Test responses before going live
  • Consider audience engagement
  • Use appropriate tone
  • Include context when needed

Usage Guidelines

  • Set appropriate cooldowns
  • Monitor command usage
  • Keep lists current
  • Regular testing
  • Backup important lists

Common Applications

Stream Integration

  • Game selection streams
  • Movie night picks
  • Giveaway winner selection
  • Speedrun highlight sharing
  • Community engagement tools

Content Management

  • Maintain separate lists for different purposes
  • Regular updates to keep content fresh
  • Backup files regularly
  • Monitor usage patterns
  • Adjust settings as needed

Troubleshooting

Common Issues

  • File not uploading: Check format (.txt only)
  • Items not displaying: Verify line formatting
  • Response errors: Check merge field syntax
  • Performance issues: Review file size
  • Display problems: Verify text formatting

Solutions

  • Confirm file format
  • Check line breaks
  • Verify merge fields
  • Test offline first
  • Keep backup copies

Video Tutorial

For more information on how to create random list item commands, please refer to the Random List Item Commands Tutorial or watch the video below: