This is the full developer documentation for StreamElements Docs # StreamElements Documentation > Everything you need to set up, customize, and build on StreamElements. ## Explore the docs [Section titled “Explore the docs”](#explore-the-docs) [Chatbot](/chatbot)Commands, variables, timers, spam filters, and interactive modules for your chat. [SE.Live](/selive)Set up SE.Live in OBS Studio and find guides for your stream. [Overlays & Alerts](/overlays)Build stream overlays — from your first AlertBox to fully custom-coded widgets. [Developers](/developers)Build integrations with WebSockets, the HTTP API, and custom widgets. [Changelog](/changelog)New updates and improvements at StreamElements, with RSS feeds per product. [Discord Community](https://discord.gg/se)Get help from the community and the StreamElements team. # StreamElements Chatbot > Documentation for the StreamElements Chatbot for Twitch and YouTube Live: commands, variables, timers, modules, spam filters, quotes, and counters. The StreamElements Chatbot is a chatbot for Twitch and YouTube Live. It provides custom commands, automated timers, spam filters, and interactive modules, all configured from your StreamElements dashboard. [Getting Started](/chatbot/getting-started)Create your first custom command and timer. [Guides](/chatbot/guides)Build useful commands for counters, lurk replies, countdowns, and viewer input. [Commands](/chatbot/commands)Default and custom chatbot commands. [Variables](/chatbot/variables)Dynamic values for command and timer responses. [Modules](/chatbot/modules)Interactive features for your chat. [Spam Filters](/chatbot/filters)Keep your chat clean and safe. [Timers](/chatbot/timers)Automated messages at regular intervals. [Quotes](/chatbot/quotes)Save and share memorable moments from your stream. [Counters](/chatbot/counters)Keep track of deaths, misses, or any other event. [Troubleshooting](/chatbot/troubleshooting)Resolve common chatbot issues. # Commands > Default and custom chat commands for the StreamElements Chatbot, and the variables available in command responses. The StreamElements Chatbot supports two kinds of chat commands. Default commands are pre-configured and ready to use immediately, covering moderation, viewer engagement, and stream information. Custom commands are commands you create yourself, with responses that can include [variables](/chatbot/variables) for dynamic content. [Custom Commands](/chatbot/commands/custom)Create commands tailored to your channel and community. [Default Commands](/chatbot/commands/default)Pre-configured commands that are ready to use immediately. [Variables](/chatbot/variables)Dynamic values for command and timer responses. # Custom Commands > Create and manage custom StreamElements Chatbot commands from the dashboard or directly in chat, with example commands using variables. In addition to the default commands, you can also create your own custom commands. Custom commands allow you to create commands that are tailored to your channel and your community. You can use custom commands to create unique interactions and functionalities that are not possible with the default commands. ## Managing Custom Commands [Section titled “Managing Custom Commands”](#managing-custom-commands) There are two ways to manage custom commands: 1. Through the creator dashboard 2. Directly in chat with the [!command](/chatbot/commands/default/command) command ### Using the dashboard [Section titled “Using the dashboard”](#using-the-dashboard) See [Getting Started](/chatbot/getting-started) for a step-by-step walkthrough of creating a command in the dashboard. ### Using chat [Section titled “Using chat”](#using-chat) | Action | Syntax | Example | | ------- | ------------------------------------------- | -------------------------------------------------------------- | | Add | `!command add ! ` | `!command add !socials Follow me on Twitter @MyHandle!` | | Edit | `!command edit ! ` | `!command edit !socials Check out my links: example.com/links` | | Remove | `!command remove !` | `!command remove !socials` | | Show | `!command show !` | `!command show !socials` | | Options | `!command options ! ` | `!command options !socials -cd 10 -level 500` | Note `!command` is aliased as `!cmd`, so `!cmd add !socials ...` works the same way. For the full subcommand reference, including all available options, permissions, and aliases, read the documentation for the [!command](/chatbot/commands/default/command) command. ## Examples [Section titled “Examples”](#examples) ### Dynamic Greeting Command [Section titled “Dynamic Greeting Command”](#dynamic-greeting-command) This command greets the user and tells them when they last visited the stream. ```streamelements !cmd add !hello $(user), welcome to the stream! You last visited $(user.lastseen) ago. ``` Example chat Viewer123:!hello StreamElements:Viewer123, welcome to the stream! You last visited 2 days 5 hours ago. Variables used: * [$(user)](/chatbot/variables/user#available-variables) - The name of the viewer * [$(user.lastseen)](/chatbot/variables/user#available-variables) - The time the viewer last visited the stream ### Stream Uptime Command [Section titled “Stream Uptime Command”](#stream-uptime-command) This command shows how long the stream has been live, the current game, and viewer count. ```streamelements !cmd add !stream The stream has been live for $(uptime). We're currently playing $(channel.game) for $(channel.viewers) viewers! ``` Example chat Viewer123:!stream StreamElements:The stream has been live for 2 days 5 hours. We're currently playing Fortnite for 1234 viewers! Variables used: * [$(uptime)](/chatbot/variables/uptime) - The time the stream has been live * [$(channel.game)](/chatbot/variables/channel#available-variables) - The game the stream is currently playing * [$(channel.viewers)](/chatbot/variables/channel#available-variables) - The number of viewers currently watching the stream ### Weather Command [Section titled “Weather Command”](#weather-command) This command checks the weather for a location specified by the viewer. ```streamelements !cmd add !weather $(sender), weather in: $(weather ${1:}) ``` Example chat Viewer123:!weather Tokyo StreamElements:Viewer123, weather in: Tokyo, Japan: 🌜 17.7 °C (63.9 °F). Feels like 17.7 °C (63.9 °F). Patchy rain nearby. Wind is blowing from the South at 9.7 km/h (6.0 mp/h). 89% humidity. Visibility: 10 km (6 miles). Air pressure: 1008 hPa. Variables used: * [$(sender)](/chatbot/variables/sender) - The viewer who triggered the command * [${1:}](/chatbot/variables/args) - The arguments passed to the command, here the location to look up * [$(weather)](/chatbot/variables/weather) - The current weather in a specified location ### Shoutout Command [Section titled “Shoutout Command”](#shoutout-command) This command sends a simple shoutout to a specified user. ```streamelements !cmd add !shoutout Check out ${1}, they are playing $(game ${1}) at https://twitch.tv/${1} ``` Example chat Viewer123:!shoutout Styler StreamElements:Check out Styler, they are playing Counter-Strike at https\://twitch.tv/Styler Variables used: * [${1}](/chatbot/variables/args) - The first argument passed to the command, here the name of the user to shout out * [$(game)](/chatbot/variables/game) - The game the user is currently playing # Default Commands > Reference of all default StreamElements Chatbot commands, grouped by category, with usage and configuration links. Default commands are pre-configured chat commands available in the StreamElements Chatbot. These commands provide essential functionality for streamers, moderators, and viewers to interact with the chat and manage the stream. Below is the full list of default commands, grouped by what they do. The **Access** column shows the default permission level required; you can adjust it per command in your dashboard. Click any command for its usage, parameters, and configuration. ## Points & Loyalty [Section titled “Points & Loyalty”](#points--loyalty) | Command | Access | Description | | ------------------------------------------------------- | --------------- | --------------------------------------------------------- | | [`!addpoints`](/chatbot/commands/default/addpoints) | Super Moderator | Add loyalty points to a viewer's balance. | | [`!givepoints`](/chatbot/commands/default/givepoints) | Everyone | Transfer your loyalty points to another user. | | [`!leaderboard`](/chatbot/commands/default/leaderboard) | Everyone | Get a link to the points or watch time leaderboard page. | | [`!points`](/chatbot/commands/default/points) | Everyone | Check your own or another user's points balance and rank. | | [`!setpoints`](/chatbot/commands/default/setpoints) | Super Moderator | Set a user's loyalty points balance. | | [`!top`](/chatbot/commands/default/top) | Everyone | Display the top users by loyalty points or watch time. | | [`!watchtime`](/chatbot/commands/default/watchtime) | Everyone | Check your own or another user's accumulated watch time. | ## Games & Betting [Section titled “Games & Betting”](#games--betting) | Command | Access | Description | | ----------------------------------------------------- | --------- | ------------------------------------------------------------- | | [`!accept`](/chatbot/commands/default/accept) | Everyone | Accept a pending duel challenge. | | [`!bet`](/chatbot/commands/default/bet) | Everyone | Place loyalty points on an active betting contest. | | [`!bingo`](/chatbot/commands/default/bingo) | Moderator | Emote bingo game; viewers guess emotes to win loyalty points. | | [`!cancelduel`](/chatbot/commands/default/cancelduel) | Everyone | Cancel an outgoing duel request you initiated. | | [`!contest`](/chatbot/commands/default/contest) | Everyone | Check the status of the currently active betting contest. | | [`!deny`](/chatbot/commands/default/deny) | Everyone | Reject an incoming duel request. | | [`!duel`](/chatbot/commands/default/duel) | Everyone | Challenge another user to a points duel. | | [`!roulette`](/chatbot/commands/default/roulette) | Everyone | Gamble loyalty points for a chance to win or lose. | | [`!slots`](/chatbot/commands/default/slots) | Everyone | Play a slot machine game with loyalty points. | ## Giveaways & Raffles [Section titled “Giveaways & Raffles”](#giveaways--raffles) | Command | Access | Description | | --------------------------------------------------------- | --------- | -------------------------------------------------------------------------- | | [`!cancelraffle`](/chatbot/commands/default/cancelraffle) | Moderator | Immediately cancel an active raffle. | | [`!giveaway`](/chatbot/commands/default/giveaway) | Everyone | Check the status and link of the active channel giveaway. | | [`!join`](/chatbot/commands/default/join) | Everyone | Enter an active raffle started with !sraffle or !raffle. | | [`!raffle`](/chatbot/commands/default/raffle) | Moderator | Start a multi-winner raffle that splits the pot; viewers enter with !join. | | [`!sraffle`](/chatbot/commands/default/sraffle) | Moderator | Start a single-winner raffle; viewers enter with !join. | | [`!ticket`](/chatbot/commands/default/ticket) | Everyone | Purchase tickets for giveaways and raffles. | ## Song Requests [Section titled “Song Requests”](#song-requests) | Command | Access | Description | | ------------------------------------------------------- | --------- | -------------------------------------------------------- | | [`!next`](/chatbot/commands/default/next) | Everyone | Show the next song in the media request queue. | | [`!pause`](/chatbot/commands/default/pause) | Moderator | Pause media request playback without clearing the queue. | | [`!play`](/chatbot/commands/default/play) | Moderator | Resume paused media request playback. | | [`!removesong`](/chatbot/commands/default/removesong) | Moderator | Remove a song by URL, or all of a user's songs. | | [`!skip`](/chatbot/commands/default/skip) | Moderator | Moderators skip the current song in the queue. | | [`!song`](/chatbot/commands/default/song) | Everyone | Show the currently playing song. | | [`!songqueue`](/chatbot/commands/default/songqueue) | Moderator | Get a link to the current media request queue page. | | [`!songrequest`](/chatbot/commands/default/songrequest) | Everyone | Add YouTube songs or videos to the media request queue. | | [`!srclear`](/chatbot/commands/default/srclear) | Moderator | Clear the entire media request queue. | | [`!volume`](/chatbot/commands/default/volume) | Everyone | Check or set the media request player volume. | | [`!voteskip`](/chatbot/commands/default/voteskip) | Everyone | Let viewers vote to skip the current media request. | | [`!when`](/chatbot/commands/default/when) | Everyone | Check the queue position of your latest song request. | | [`!wrongsong`](/chatbot/commands/default/wrongsong) | Everyone | Remove the last song you added to the queue. | ## Viewer Queue [Section titled “Viewer Queue”](#viewer-queue) | Command | Access | Description | | ------------------------------------------- | -------- | ------------------------------------------------------------------- | | [`!queue`](/chatbot/commands/default/queue) | Everyone | Manage viewer queues for activities like playing with the streamer. | ## Store [Section titled “Store”](#store) | Command | Access | Description | | ----------------------------------------------------- | --------- | ------------------------------------------------------------ | | [`!closestore`](/chatbot/commands/default/closestore) | Moderator | Disable all regular (non-SFX) items in the loyalty store. | | [`!disablesfx`](/chatbot/commands/default/disablesfx) | Moderator | Disable all sound effect (SFX) items in the loyalty store. | | [`!enablesfx`](/chatbot/commands/default/enablesfx) | Moderator | Re-enable all sound effect (SFX) items in the loyalty store. | | [`!items`](/chatbot/commands/default/items) | Everyone | Get a link to the channel's loyalty store page. | | [`!openstore`](/chatbot/commands/default/openstore) | Moderator | Re-enable all regular (non-SFX) items in the loyalty store. | | [`!redeem`](/chatbot/commands/default/redeem) | Everyone | Redeem loyalty store items using points. | ## Stream Management [Section titled “Stream Management”](#stream-management) | Command | Access | Description | | ------------------------------------------------------- | --------------- | ------------------------------------------------------------- | | [`!alerts`](/chatbot/commands/default/alerts) | Moderator | Mute, skip, or pause overlay alerts from chat. | | [`!editcounter`](/chatbot/commands/default/editcounter) | Moderator | Set, increment, or decrement custom counter values from chat. | | [`!hypecup`](/chatbot/commands/default/hypecup) | Super Moderator | Clear the HypeCup overlay contribution list. | | [`!setgame`](/chatbot/commands/default/setgame) | Super Moderator | Update the stream's game category on Twitch. | | [`!settitle`](/chatbot/commands/default/settitle) | Super Moderator | Moderators change the Twitch stream title. | | [`!timer`](/chatbot/commands/default/timer) | Moderator | Enable or disable specific chat timers. | ## Moderation [Section titled “Moderation”](#moderation) | Command | Access | Description | | --------------------------------------------------------- | --------------- | --------------------------------------------------------------- | | [`!filesay`](/chatbot/commands/default/filesay) | Super Moderator | Send multiple lines of text from a URL to chat. | | [`!level`](/chatbot/commands/default/level) | Super Moderator | View and manually override user permission levels. | | [`!nuke`](/chatbot/commands/default/nuke) | Super Moderator | Timeout, ban, or delete recent messages matching text or regex. | | [`!nukeusername`](/chatbot/commands/default/nukeusername) | Super Moderator | Timeout or ban users whose usernames match text or regex. | | [`!permit`](/chatbot/commands/default/permit) | Moderator | Temporarily allow a user to post links without being timed out. | | [`!vanish`](/chatbot/commands/default/vanish) | Everyone | Time yourself out for 1 second to clear your messages. | | [`!votekick`](/chatbot/commands/default/votekick) | Moderator | Start a community vote to temporarily kick a user. | ## Bot & Command Management [Section titled “Bot & Command Management”](#bot--command-management) | Command | Access | Description | | ------------------------------------------------- | --------------- | ------------------------------------------------------ | | [`!bot`](/chatbot/commands/default/bot) | Super Moderator | Mute, unmute, or remove the bot from chat. | | [`!command`](/chatbot/commands/default/command) | Moderator | Add, remove, edit, or alias custom commands from chat. | | [`!commands`](/chatbot/commands/default/commands) | Everyone | Get a link to the channel's public commands list. | | [`!module`](/chatbot/commands/default/module) | Super Moderator | Enable or disable chatbot modules from chat. | ## Fun & Emotes [Section titled “Fun & Emotes”](#fun--emotes) | Command | Access | Description | | ----------------------------------------------------- | --------- | ----------------------------------------------------------- | | [`!8ball`](/chatbot/commands/default/8ball) | Everyone | Receive a random magic 8-ball style answer to a question. | | [`!emotecount`](/chatbot/commands/default/emotecount) | Everyone | Display the usage frequency of a specific emote. | | [`!emotes`](/chatbot/commands/default/emotes) | Everyone | List Twitch, BTTV, FFZ, or 7TV emotes, or reload the cache. | | [`!kappagen`](/chatbot/commands/default/kappagen) | Moderator | Trigger an emote explosion via the Kappagen overlay widget. | | [`!quote`](/chatbot/commands/default/quote) | Everyone | Display random saved quotes or manage the quote list. | ## Stream Info & Utility [Section titled “Stream Info & Utility”](#stream-info--utility) | Command | Access | Description | | ----------------------------------------------------- | -------- | ----------------------------------------------------- | | [`!accountage`](/chatbot/commands/default/accountage) | Everyone | Check the creation date of any Twitch account. | | [`!chatstats`](/chatbot/commands/default/chatstats) | Everyone | Get a link to the channel's chat statistics page. | | [`!followage`](/chatbot/commands/default/followage) | Everyone | Check how long a user has been following the channel. | | [`!tip`](/chatbot/commands/default/tip) | Everyone | Get a link to the channel's tipping page. | | [`!uptime`](/chatbot/commands/default/uptime) | Everyone | Check the current stream's duration. | # !8ball > Ask the StreamElements chatbot a question with the !8ball command and receive a random, magic 8-ball style answer. The `!8ball` command simulates a magic 8-ball toy: ask it a question and it answers with a random verdict. ## Usage [Section titled “Usage”](#usage) To use the command, type `!8ball` followed by an optional question in the chat. The chatbot will respond with a random fortune-like answer. ```streamelements !8ball [question] ``` The `[question]` part is entirely optional and does not influence the random outcome. ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!8ball Will I win my next game? StreamElements:It is decidedly so. Example chat ViewerName:!8ball What should I have for dinner? StreamElements:Cannot predict now. ## Configuration [Section titled “Configuration”](#configuration) Enable the 8ball module under `Chatbot` -> `Modules`, where you can also customize the list of possible responses the command draws from. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!roulette`](/chatbot/commands/default/roulette): Gamble loyalty points for a chance to win or lose. * [`!slots`](/chatbot/commands/default/slots): Play a slot machine game with loyalty points. # !accept > Use the !accept command to accept pending duel challenges initiated with the !duel command in StreamElements chatbot. The `!accept` command allows users to accept pending duel requests initiated by the [`!duel`](/chatbot/commands/default/duel) command. A duel request must be accepted within **2 minutes**, otherwise it expires. Once accepted, the duel resolves immediately: the winner is decided by a 50/50 coin flip, gaining the wagered points while the loser loses them. ## Usage [Section titled “Usage”](#usage) To use the `!accept` command, simply type it in the chat when you have a pending duel request. ```streamelements !accept ``` ## Examples [Section titled “Examples”](#examples) Example chat Challenger:!duel TargetUser 100 StreamElements:@TargetUser, @Challenger wants to duel you for 100 points, you can !accept or !deny within 2 minutes TargetUser:!accept StreamElements:TargetUser won the Duel vs Challenger PogChamp ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!duel`](/chatbot/commands/default/duel): Initiate a duel with another user. * [`!cancelduel`](/chatbot/commands/default/cancelduel): Cancel an outgoing duel request. * [`!deny`](/chatbot/commands/default/deny): Deny an incoming duel request. # !accountage > Check the creation date (age) of any Twitch account using the StreamElements chatbot !accountage command. Useful for moderation and verification. The `!accountage` command shows how old a Twitch account is — a quick way for moderators to spot freshly created accounts. ## Usage [Section titled “Usage”](#usage) To use the command, type `!accountage` followed by an optional username. If no username is provided, it checks the account age of the user running the command. ```streamelements !accountage [username] ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!accountage StreamElements StreamElements:@ModUser, StreamElements was created 10 years 2 months 28 days 7 hours ago. Example chat ViewerBob:!accountage StreamElements:@ViewerBob, your account was created 3 years 5 months 12 days 4 hours ago. ## Parameters [Section titled “Parameters”](#parameters) * `[username]` (Optional): The Twitch username of the account you want to check. If omitted, the command checks the account age of the user who issued the command. ## Configuration [Section titled “Configuration”](#configuration) This command requires a connection to Twitch to fetch the account creation date. Ensure your StreamElements bot account is properly linked to Twitch. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!followage`](/chatbot/commands/default/followage): Checks how long a user has been following the channel. # !addpoints > Moderators can manually add loyalty points to a viewer's balance using the StreamElements !addpoints chatbot command. The `!addpoints` command manually adds loyalty points to a viewer’s balance — for one-off rewards or for correcting a balance. ## Usage [Section titled “Usage”](#usage) To add points to a viewer, use the following syntax in your chat: ```streamelements !addpoints ``` ## Examples [Section titled “Examples”](#examples) Example chat BroadcasterName:!addpoints StreamFan123 1000 StreamElements:@BroadcasterName, added 1000 points to StreamFan123. They now have 5961 points. Example chat ModUser99:!addpoints LoyalViewer 50 StreamElements:@ModUser99, added 50 points to LoyalViewer. They now have 1280 points. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact username of the viewer receiving points. * `` (Required): The number of points (positive integer) to award. ## Configuration [Section titled “Configuration”](#configuration) * Enable the **Loyalty system** in your **StreamElements Dashboard** under **Loyalty** -> **Loyalty Settings**. * The command’s permission level can be adjusted under **Chatbot** -> **Chat Commands** -> **Default Commands**. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!setpoints`](/chatbot/commands/default/setpoints): Set a user’s points to a specific value. * [`!givepoints`](/chatbot/commands/default/givepoints): Allow users to give points to each other. * [`!points`](/chatbot/commands/default/points): Check a user’s current point balance. # !alerts > Control StreamElements overlay alerts (mute, skip, pause) in real-time directly from chat using the !alerts command. Essential for stream management. The `!alerts` command allows streamers and moderators to dynamically manage StreamElements overlay alerts during a live broadcast. This tool helps control alert playback directly from chat for actions like muting, skipping, or pausing. Note The `!alerts` command is **disabled by default**. Enable it under `Chatbot` -> `Chat Commands` -> `Default Commands` before using it. ## Usage [Section titled “Usage”](#usage) To manage overlay alerts, use the `!alerts` command followed by the desired action. ```streamelements !alerts ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!alerts mute StreamElements:Successfully muted alerts Example chat BroadcasterName:!alerts skip StreamElements:Successfully skipped alerts Example chat ModUser:!alerts pause StreamElements:Successfully paused alerts ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The action to perform on the alerts. Valid actions are: * `mute`: Turns off alert sounds. * `unmute`: Turns alert sounds back on. * `skip`: Skips the currently playing alert. * `pause`: Pauses the alert queue; currently playing alerts will finish. * `unpause`: Resumes the alert queue. ## Configuration [Section titled “Configuration”](#configuration) * This command controls alerts within your StreamElements overlays. Ensure your overlays are active. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [Chat Alerts module](/chatbot/modules/chatalerts): Not to be confused with `!alerts` — it posts chat *messages* for events like follows and subscriptions, and does not control overlay alerts. # !bet > Allow viewers to participate in stream betting contests using their loyalty points with the StreamElements chatbot !bet command. The `!bet` command allows viewers to use their loyalty points to bet on the outcome of a contest or event defined by the streamer. This command is used **while a bet is active**, which is initiated through the StreamElements Dashboard. Viewers can check the active contest with [`!contest`](/chatbot/commands/default/contest). ## Usage [Section titled “Usage”](#usage) To place a bet while a betting contest is open, viewers use the following syntax: ```streamelements !bet ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!bet win 100 StreamElements:@ViewerName, you have bet 100 points on Win. Example chat HighRoller:!bet lose 5k StreamElements:@HighRoller, you have bet 5000 points on Lose. Example chat PercentBetta:!bet optionA 25% StreamElements:@PercentBetta, you have bet 750 points on optionA. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The specific betting option the viewer wants to choose (defined by the streamer when starting the bet). * `` (Required): The number of loyalty points to wager. This can be a specific number, a percentage (`50%`), or use `k` for thousands (`5k`), `m` for millions (`1m`). The amount must stay within the minimum and maximum bet configured for the contest. ## Configuration [Section titled “Configuration”](#configuration) * Betting contests can only be **started from the StreamElements Dashboard** — there is no chat command to create one. Streamers define the options, duration, minimum/maximum bet, and other settings there. * Viewers need sufficient loyalty points to place a bet. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!contest`](/chatbot/commands/default/contest): Checks the status and details of the currently active betting contest. * [`!points`](/chatbot/commands/default/points): Checks a user’s current loyalty point balance. # !bingo > Engage viewers with an interactive emote bingo game using the !bingo command in StreamElements chatbot. Award loyalty points for guessing emotes. The `!bingo` command starts an interactive emote bingo game in your chat. It randomly selects an emote from a specified platform (Twitch, BTTV, FFZ, 7TV), and viewers try to guess the correct emote to win loyalty points. ## Usage [Section titled “Usage”](#usage) Use this command to start a new bingo game. ```streamelements !bingo ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!bingo twitch 100 StreamElements:Bingo started! Guess the Twitch emote to win 100 points! viewer1:Kappa viewer2:LUL viewer3:PogChamp StreamElements:Congratulations viewer3! You guessed the correct emote PogChamp and won 100 points! Example chat BroadcasterName:!bingo all 250 StreamElements:Bingo started! Guess the emote (Twitch, BTTV, FFZ, 7TV) to win 250 points! ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The platform(s) to use for emotes. Valid options: * `twitch`: Twitch global and channel emotes. * `bttv`: BetterTTV emotes. * `ffz`: FrankerFaceZ emotes. * `7tv`: 7TV emotes. * `all`: Includes emotes from all supported platforms. * `` (Required): The number of loyalty points to reward the winner. ## Configuration [Section titled “Configuration”](#configuration) * A **Loyalty system** must be active. Enable it under `Loyalty` -> `Loyalty Settings`. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. * You can customize the bingo game by adjusting the reward amount and using different emote platforms to vary the game’s difficulty. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!points`](/chatbot/commands/default/points): Check a user’s current loyalty points balance. * [`!top`](/chatbot/commands/default/top): See the leaderboard for points or watch time. # !bot > Manage your StreamElements chatbot with the !bot command. Control bot behavior, including muting, unmuting, and removing the bot from chat. The `!bot` command allows streamers and moderators to control the behavior of the StreamElements chatbot during a stream. This command provides essential functions for managing the bot’s presence and activity in the chat via several subcommands. ## Usage [Section titled “Usage”](#usage) The `!bot` command uses the following general structure: ```streamelements !bot ``` ## Subcommands [Section titled “Subcommands”](#subcommands) This section details the available subcommands for `!bot`. ### mute [Section titled “mute”](#mute) Temporarily prevents the bot from sending *any* messages (including commands and timers) in the chat. **Syntax** ```streamelements !bot mute ``` **Example** Example chat ModUser:!bot mute StreamElements:@Moderator, I have been muted. ### unmute [Section titled “unmute”](#unmute) Allows the bot to resume sending messages in the chat after being muted. **Syntax** ```streamelements !bot unmute ``` **Example** Example chat BroadcasterName:!bot unmute StreamElements:@Broadcaster, I have been unmuted. ### part [Section titled “part”](#part) Makes the bot leave the chat channel entirely. The bot will need to be invited back manually via the StreamElements dashboard if you wish for it to return. **Syntax** ```streamelements !bot part ``` **Example** Example chat BroadcasterName:!bot part StreamElements has left the channel. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!commands`](/chatbot/commands/default/commands): Lists all available bot commands. * [`!command`](/chatbot/commands/default/command): Manages custom commands. * [`!module`](/chatbot/commands/default/module): Enables or disables chatbot modules. ## FAQ [Section titled “FAQ”](#faq) * **How do I get the bot back after using `!bot part`?** You need to go to your StreamElements dashboard, navigate to the Chatbot settings, and click the button to make the bot join your channel again. * **Does `!bot mute` stop timers?** Yes, muting the bot prevents it from sending timer messages as well as command responses. # !cancelduel > Use the !cancelduel command in StreamElements chatbot to stop an outgoing duel request you initiated. The `!cancelduel` command allows a user to cancel an **outgoing** duel request they initiated with the [`!duel`](/chatbot/commands/default/duel) command *before* the challenged user accepts or denies it. If a request is never answered, it expires on its own after **2 minutes**. ## Usage [Section titled “Usage”](#usage) To cancel your pending outgoing duel request, simply type the command in chat: ```streamelements !cancelduel ``` ## Examples [Section titled “Examples”](#examples) Example chat Challenger:!duel TargetUser 100 StreamElements:@TargetUser, @Challenger wants to duel you for 100 points, you can !accept or !deny within 2 minutes Challenger:!cancelduel StreamElements:@Challenger, Duel request cancelled. Example chat ViewerName:!cancelduel StreamElements:@UserName, You do not have any pending outgoing duel requests. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!duel`](/chatbot/commands/default/duel): Initiate a duel with another user. * [`!accept`](/chatbot/commands/default/accept): Accept an incoming duel request. * [`!deny`](/chatbot/commands/default/deny): Deny an incoming duel request. # !cancelraffle > Immediately cancel an active raffle on your channel using the StreamElements chatbot !cancelraffle command. The `!cancelraffle` command allows streamers and moderators to immediately halt any active raffle or giveaway initiated by [`!raffle`](/chatbot/commands/default/raffle) or [`!sraffle`](/chatbot/commands/default/sraffle) on their channel. ## Usage [Section titled “Usage”](#usage) To cancel an ongoing raffle, use the following command in chat: ```streamelements !cancelraffle ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!cancelraffle StreamElements:The raffle was canceled! Example chat BroadcasterName:!cancelraffle StreamElements:There is no active raffle to cancel. ## Configuration [Section titled “Configuration”](#configuration) * The `!cancelraffle` command requires the **Raffle module** to be active. Enable it in your **StreamElements Dashboard** under `Chatbot` -> `Modules`. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!raffle`](/chatbot/commands/default/raffle): Starts a multi-winner raffle that splits the points pot among the winners. * [`!sraffle`](/chatbot/commands/default/sraffle): Starts a single-winner raffle where one winner takes the full pot. # !chatstats > Use the !chatstats command in StreamElements chatbot to view a link to the channel's detailed chat statistics page. The `!chatstats` command provides a direct link to the streamer’s detailed chat statistics page on StreamElements. This allows anyone in chat to easily access information about chat activity, top chatters, command usage, and more. ## Usage [Section titled “Usage”](#usage) To get the link to the chat statistics page, simply type the command in chat: ```streamelements !chatstats ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!chatstats StreamElements:Chat stats can be found here: https\://stats.streamelements.com/c/YOUR\_CHANNEL\_NAME PogChamp ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!top`](/chatbot/commands/default/top): Displays the top chatters or point leaders directly in chat. * [`!emotecount`](/chatbot/commands/default/emotecount): Checks how many times a specific emote has been used in chat. * [`!uptime`](/chatbot/commands/default/uptime): Shows how long the current stream has been live. * [`!followage`](/chatbot/commands/default/followage): Tells a user how long they’ve been following the channel (Twitch only). * [`!watchtime`](/chatbot/commands/default/watchtime): Shows how long a user has been watching the stream (requires Loyalty module). # !closestore > Use the !closestore command in StreamElements chatbot to quickly disable all regular (non-SFX) items in your loyalty store. The `!closestore` command allows streamers and moderators to quickly disable all **regular** (non-sound effect) items in the StreamElements loyalty store. This is useful for temporarily preventing viewers from redeeming items while making updates or during specific stream segments. ## Usage [Section titled “Usage”](#usage) To disable all regular store items, use the following command in chat: ```streamelements !closestore ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!closestore StreamElements:@Moderator, successfully updated 15 items. ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!openstore`](/chatbot/commands/default/openstore): Re-enables all regular items in the loyalty store. * [`!disablesfx`](/chatbot/commands/default/disablesfx): Disables only sound effect (SFX) items in the loyalty store. * [`!enablesfx`](/chatbot/commands/default/enablesfx): Enables only sound effect (SFX) items in the loyalty store. * [`!redeem`](/chatbot/commands/default/redeem): Allows viewers to redeem store items. # !command > Manage StreamElements chatbot custom commands directly from chat using the !command (!cmd) functions: add, remove, edit, alias, show, options. The `!command` (aliased as `!cmd`) command suite allows streamers and moderators with the appropriate permissions to manage custom chat commands directly from the chat interface. It provides subcommands to add, remove, edit, view aliases, show details, and configure advanced options for any custom command. ## Usage [Section titled “Usage”](#usage) The general syntax follows this pattern: ```streamelements !command [arguments...] ``` Or using the alias: ```streamelements !cmd [arguments...] ``` Replace `` with one of the functions listed below and `[arguments...]` with the required parameters for that specific subcommand. ## Subcommands [Section titled “Subcommands”](#subcommands) Here are the available subcommands for `!command`: ### add [Section titled “add”](#add) Creates a new custom command. **Syntax:** ```streamelements !command add ! ``` **Example:** Example chat ModUser:!command add !socials Follow me on Twitter @MyHandle! StreamElements:@Moderator, successfully added command !socials. ### remove [Section titled “remove”](#remove) Deletes an existing custom command. **Syntax:** ```streamelements !command remove ! ``` **Example:** Example chat ModUser:!command remove !socials StreamElements:@Moderator, successfully removed command !socials. ### edit [Section titled “edit”](#edit) Changes the response text of an existing custom command. **Syntax:** ```streamelements !command edit ! ``` **Example:** Example chat ModUser:!command edit !socials Check out my links: example.com/links StreamElements:@Moderator, successfully updated command !socials. ### alias [Section titled “alias”](#alias) Shows the aliases associated with a specific command, or adds/removes an alias. **Syntax:** ```streamelements !command alias ! !command alias add ! ! !command alias remove ! ! ``` Note Listing aliases only works with the original command name, not with one of its aliases. **Example (listing aliases):** Example chat ModUser:!command alias !socials StreamElements:@Moderator, Command !socials has aliases: !links, !connect **Example (adding an alias):** Example chat ModUser:!command alias add !socials !links StreamElements:@Moderator, successfully added alias !links to command !socials. **Example (removing an alias):** Example chat ModUser:!command alias remove !socials !links StreamElements:@Moderator, successfully removed alias !links from command !socials. ### show [Section titled “show”](#show) Displays the full response text and configuration details (level, cost, cooldowns) of a command. **Syntax:** ```streamelements !command show ! ``` **Example:** Example chat ModUser:!command show !socials StreamElements:@Moderator, Command !socials: Check out my links: example.com/links (Level: Everyone, Cost: 0, Cooldown: 5s, User Cooldown: 15s) ### options [Section titled “options”](#options) Configures advanced settings like cooldowns, cost, permission level, response type, trigger name, enabled status, and usage count for a command. See the [Parameters](#parameters-for-options-subcommand) section below for details on the available options. **Syntax:** ```streamelements !command options ! [option2] [value2] ... ``` Note Replace `option1`, `value1`, etc., with the specific parameter flags and values listed in the Parameters section below. You can specify multiple options. **Example (setting multiple options):** Example chat ModUser:!command options !socials -cd 10 -usercd 30 -cost 50 -level 500 StreamElements:@Moderator, successfully updated command !socials. ## Parameters (for `options` subcommand) [Section titled “Parameters (for options subcommand)”](#parameters-for-options-subcommand) When using the `!command options` subcommand, you specify settings using flags followed by their values. You can set multiple options in a single message. These parameters allow fine-grained control over a command’s behavior: | Parameter | Description | Accepted Values | Example Usage | | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------------------------------------------- | ----------------- | | `-cd` | Sets the **global command cooldown** (minimum time between *any* use of the command). | `` (e.g., `10`) | `-cd 10` | | `-usercd` | Sets the **user-specific cooldown** (minimum time the *same user* must wait before using the command again). | `` (e.g., `30`) | `-usercd 30` | | `-cost` | Sets the **loyalty points cost** charged each time the command is used. If a user doesn’t have enough points, the command silently does nothing (no error message is sent). Requires the StreamElements [Loyalty System](https://support.streamelements.com/hc/en-us/articles/10474478470290-Loyalty-System-Overview) (enabled in the dashboard under **Loyalty** → **Loyalty Settings**). | `` (e.g., `50`) | `-cost 50` | | `-level` | Sets the **minimum user permission level** required. Takes a **number**: `100` (Everyone), `250` (Subscriber), `300` (Regular), `400` (VIP), `500` (Moderator), `1000` (Super Moderator). No other values are accepted. | `` (e.g., `500`) | `-level 500` | | `-type` | Sets **how the bot responds**. Platform support for `reply`, `mention`, and `whisper` may vary. | `say` (default), `reply`, `mention`, `whisper` | `-type whisper` | | `-trigger` | **Renames the command**, changing the trigger word used to invoke it. | `` (e.g., `!links`) | `-trigger !links` | | `-enable` | Enables the command. | N/A | `-enable` | | `-disable` | Disables the command, preventing anyone from using it. | N/A | `-disable` | | `-count` | **Manually sets the command’s usage counter**, useful for resetting or adjusting the value used by [`$(count)`](/chatbot/variables/count). | `` (e.g., `0`) | `-count 0` | ## Subcommand aliases [Section titled “Subcommand aliases”](#subcommand-aliases) Each subcommand also accepts its own shorthand aliases: * **`remove`:** `delete`, `del`, `rem` * **`edit`:** `update` * **`alias`:** `aliases` * **`show`:** `debug` * **`options`:** `option`, `opt`, `opts`, `o`, `🔧` ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!commands`](/chatbot/commands/default/commands): Lists available commands. * [`$(count)`](/chatbot/variables/count): Variable to display the usage count of a command. * [`$(user)`](/chatbot/variables/user): Variable representing the user executing the command. * [`$(channel)`](/chatbot/variables/channel): Variable representing the channel name. * See the full list of [Chatbot Variables](/chatbot/variables). ## FAQ [Section titled “FAQ”](#faq) * **What’s the difference between global cooldown (`-cd`) and user cooldown (`-usercd`)?** Global cooldown (`-cd`) applies to *everyone* – once the command is used, no one can use it again until the cooldown expires. User cooldown (`-usercd`) applies only to the *individual user* – they have to wait, but other users can still use the command if the global cooldown has passed. * **How do I reset a command’s usage counter?** Use the `options` subcommand with the `-count` parameter: `!command options ! -count 0` * **Can I make a command respond with a whisper instead of a public message?** Yes, use the `options` subcommand with the `-type` parameter: `!command options ! -type whisper`. Note that whisper functionality depends on the chat platform. * **How do I add or remove a command alias via chat?** Use the `alias` subcommand with `add` or `remove`: `!command alias add ! !` or `!command alias remove ! !`. * **I’m a moderator, but `!command add` isn’t working. Why?** Double-check that the `!command` default command itself hasn’t been disabled or had its permission level changed from the default (Moderator). You can check its settings in the `Default Commands` section of your StreamElements Dashboard. # !commands > Use the !commands command in StreamElements chatbot to display a link to the creator's public commands list page. The `!commands` command provides viewers with a link to the streamer’s public StreamElements commands page. This page lists all enabled default and custom commands for the channel, making it easy for viewers to discover available interactions. ## Usage [Section titled “Usage”](#usage) To get the link to the commands page, simply type the command in chat: ```streamelements !commands ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!commands StreamElements:You can find a list of all Commands here https\://streamelements.com/styler/commands ## Configuration [Section titled “Configuration”](#configuration) * This command is enabled by default. * The public commands page only shows commands that are currently enabled. * The list updates automatically based on your command settings in the StreamElements dashboard. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!command`](/chatbot/commands/default/command): Used by moderators/streamers to manage custom commands directly via chat. # !contest > Use the !contest command in StreamElements chatbot to check the status and details of the currently active betting contest. The `!contest` command allows anyone in chat to quickly check the status and details of the currently active **betting contest**. It displays the contest question, the available betting options, and the remaining time to place bets. Note This command *checks* the status of an active contest. To *start* a new betting contest, moderators must use the **StreamElements Dashboard**. ## Usage [Section titled “Usage”](#usage) To check the active contest details, simply type the command in chat: ```streamelements !contest ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!contest StreamElements:@User, the current contest is "Will I clutch this round?". You can !bet for yes, no. Betting ends in 3 mins 15 secs Example chat ViewerName:!contest StreamElements:@User, there is no active contest. ## Configuration [Section titled “Configuration”](#configuration) * The command response reflects the settings of the currently active contest (question, options, duration) configured by the streamer/moderator via the dashboard. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!bet`](/chatbot/commands/default/bet): Used by viewers to place bets on the active contest. # !deny > Use the !deny command in StreamElements chatbot to reject incoming duel requests initiated with the !duel command. The `!deny` command allows a user to reject an **incoming** duel request initiated by another user with the [`!duel`](/chatbot/commands/default/duel) command. Duel requests expire on their own after **2 minutes** if neither accepted nor denied. ## Usage [Section titled “Usage”](#usage) To reject a pending incoming duel request, type the command in chat: ```streamelements !deny ``` ## Examples [Section titled “Examples”](#examples) Example chat Challenger:!duel TargetUser 100 StreamElements:@TargetUser, @Challenger wants to duel you for 100 points, you can !accept or !deny within 2 minutes TargetUser:!deny StreamElements:@TargetUser denied the duel request from @Challenger. Example chat ViewerName:!deny StreamElements:@UserName, You do not have any pending incoming duel requests to deny. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!duel`](/chatbot/commands/default/duel): Initiate a duel with another user. * [`!accept`](/chatbot/commands/default/accept): Accept an incoming duel request. * [`!cancelduel`](/chatbot/commands/default/cancelduel): Cancel an *outgoing* duel request you initiated. # !disablesfx > Use the !disablesfx command in StreamElements chatbot to quickly disable all sound effect (SFX) items in your loyalty store. The `!disablesfx` command allows streamers and moderators to quickly disable all **sound effect** (SFX) items in the StreamElements loyalty store. This is useful for temporarily preventing viewers from redeeming SFX during specific stream segments or when managing audio. ## Usage [Section titled “Usage”](#usage) To disable all SFX store items, use the following command in chat: ```streamelements !disablesfx ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!disablesfx StreamElements:@Moderator, successfully updated 5 items. ## Configuration [Section titled “Configuration”](#configuration) * Manage your store’s SFX items in your **StreamElements Dashboard** under `Loyalty` -> `Stream Store`. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!enablesfx`](/chatbot/commands/default/enablesfx): Re-enables all sound effect (SFX) items in the loyalty store. * [`!closestore`](/chatbot/commands/default/closestore): Disables all *regular* (non-SFX) items in the loyalty store. * [`!openstore`](/chatbot/commands/default/openstore): Enables all *regular* (non-SFX) items in the loyalty store. * [`!redeem`](/chatbot/commands/default/redeem): Allows viewers to redeem store items. # !duel > Use the !duel command in StreamElements chatbot to challenge other users to a points duel in Twitch chat. The `!duel` command allows users to challenge another user in chat to a duel, optionally wagering their loyalty points. The challenged user then has **2 minutes** to respond using [`!accept`](/chatbot/commands/default/accept) or [`!deny`](/chatbot/commands/default/deny). If the duel is accepted, the winner is decided by a 50/50 coin flip — the winner gains the wagered points and the loser loses them. ## Usage [Section titled “Usage”](#usage) To initiate a duel challenge, use the following syntax: ```streamelements !duel [points] ``` ## Examples [Section titled “Examples”](#examples) Example chat Challenger:!duel TargetUser 100 StreamElements:@TargetUser, @Challenger wants to duel you for 100 points, you can !accept or !deny within 2 minutes Example chat ViewerName:!duel SelfUser 50 StreamElements:@SelfUser, you cannot duel yourself Kappa Example chat ViewerName:!duel AnotherUser 10000 StreamElements:@User, you do not have enough points to duel for 10000. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact username of the user you want to challenge. * `[points]` (Optional): The number of loyalty points you want to wager. There is no minimum and no default — if you leave it out, the duel is played for 0 points. Shorthand values are supported: `k` for thousands (`5k`), `m` for millions (`1m`), a percentage of your balance (`50%`), or `all`. The wager cannot exceed either participant’s current balance, and wagers above the module’s **Maximum amount** setting are automatically capped to that maximum. ## Configuration [Section titled “Configuration”](#configuration) Within the Duel module settings, you can customize: * **Maximum amount**: The highest number of points users can wager in a single duel. * **User cooldown**: How long (in seconds) an individual user must wait before initiating another duel after participating in one. * **Global cooldown**: How long (in seconds) everyone must wait after a duel finishes before *anyone* can start a new one. * **Win message**: The chat message displayed when a user wins the duel. * Available variables: `{winner}`, `{loser}` * **Points won message**: The chat message displayed when points are awarded after a duel. * Available variables: `{winner}`, `{loser}`, `{points}`, `{pointsname}` ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!accept`](/chatbot/commands/default/accept): Used by the challenged user to accept a duel. * [`!deny`](/chatbot/commands/default/deny): Used by the challenged user to decline a duel. * [`!cancelduel`](/chatbot/commands/default/cancelduel): Used by the challenger to cancel their *outgoing* duel request. * [`!points`](/chatbot/commands/default/points): Check your current loyalty points balance. # !editcounter > Use the !editcounter command in StreamElements chatbot to set, increment, or decrement custom counter values directly from chat. The `!editcounter` command allows streamers and moderators to modify the value of a pre-defined custom counter directly from chat. Counters are useful for tracking things like deaths in a game, wins, specific events, or any other metric you want to display or reference. Note Counters must first be created in the StreamElements Dashboard under `Chatbot` -> `Counters`. ## Usage [Section titled “Usage”](#usage) To modify a counter, use the following syntax: ```streamelements !editcounter ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!editcounter deaths +1 StreamElements:@Moderator, changed the deaths counter from 5 to 6. Example chat BroadcasterName:!editcounter wins 10 StreamElements:@Broadcaster, changed the wins counter from 9 to 10. Example chat ModUser:!editcounter donations -5 StreamElements:@Moderator, changed the donations counter from 100 to 95. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact name of the counter you created in the Dashboard (case-sensitive). * `` (Required): The value to apply. It can be: * A number (e.g., `15`): Sets the counter to this exact value. * `+number` (e.g., `+1`): Increments the counter by this amount. * `-number` (e.g., `-3`): Decrements the counter by this amount. ## Configuration [Section titled “Configuration”](#configuration) * Counters must be created in the **StreamElements Dashboard** under `Chatbot` -> `Counters` before they can be edited via this command. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * `$(count )`: This variable displays the current value of the specified counter. It can be used in other commands or titles. Example: `!deathcount - Current deaths: $(count deaths)` # !emotecount > Use the !emotecount command in StreamElements chatbot to display the usage frequency of a specific emote in your chat. The `!emotecount` command allows anyone in chat to check how many times a specific emote has been used in the channel’s chat history (since tracking began). Note The `!emotecount` command is **disabled by default**. Enable it under `Chatbot` -> `Chat Commands` -> `Default Commands` before using it. ## Usage [Section titled “Usage”](#usage) To check the count for a specific emote, use the following syntax: ```streamelements !emotecount ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!emotecount Kappa StreamElements:@User, The emote Kappa has been used 15731 times! PogChamp Example chat ViewerName:!emotecount channelCoolEmote StreamElements:@User, The emote channelCoolEmote has been used 452 times! PogChamp Example chat ViewerName:!emotecount NonExistentEmote StreamElements:@User, The emote NonExistentEmote was not found. NotLikeThis ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact name of the emote you want to check (case-sensitive). This can be a global emote, channel emote, or third-party emote (BTTV, FFZ, 7TV) if enabled. ## Configuration [Section titled “Configuration”](#configuration) * Emote usage tracking is handled automatically by StreamElements when the bot is active in the channel. * The accuracy depends on when the bot joined and started tracking messages. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!emotes`](/chatbot/commands/default/emotes): Provides a link to view the channel’s available third-party emotes (BTTV, FFZ, 7TV). ## FAQ [Section titled “FAQ”](#faq) * **Why is the count different from what I expected?** The count reflects usage only since StreamElements started tracking messages in this channel. It might not include historical usage before the bot was added or if there were periods the bot was inactive. # !emotes > Use the !emotes command in StreamElements chatbot to list available emotes from Twitch, BTTV, FFZ, or 7TV, or to reload the entire emote cache. The `!emotes` command serves two primary functions: 1. **List Platform Emotes:** When followed by a platform name (`twitch`, `bttv`, `ffz`, `7tv`), it lists the active emotes from that specific provider directly in chat. 2. **Reload Emote Cache (Moderator+):** Using the `reload` keyword, moderators can refresh the bot’s internal cache of emotes for **all** platforms (Twitch, BTTV, FFZ, 7TV) simultaneously. ## Usage [Section titled “Usage”](#usage) **To list active emotes for a specific platform:** ```streamelements !emotes ``` * ``: Required. The platform whose emotes you want to list. Valid options: `twitch`, `bttv`, `ffz`, `7tv`. **To reload the emote cache:** ```streamelements !emotes reload ``` * This refreshes the bot’s internal cache of available emotes for **all** platforms (Twitch, BTTV, FFZ, 7TV). * It is useful if new emotes have been added or changed and aren’t showing up correctly. Permissions Using `!emotes reload` requires **Moderator** permission level or higher by default. This can be adjusted in the StreamElements Dashboard under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Examples [Section titled “Examples”](#examples) **Listing active FFZ emotes:** Example chat ViewerName:!emotes ffz StreamElements:Active FrankerFaceZ emotes in chat: monkaS FeelsOkayMan PepeHands ZULUL **Listing active BTTV emotes:** Example chat ViewerName:!emotes bttv StreamElements:Active BetterTTV emotes in chat: Pog LULW monkaW Clap **Reloading all emote caches (Moderator+):** Example chat ModUser:!emotes reload StreamElements:@Moderator, successfully updated emotes :) ## Configuration [Section titled “Configuration”](#configuration) * The `reload` function will refresh caches for Twitch and any enabled third-party integrations. * The bot needs appropriate permissions (usually just being present in chat) to fetch Twitch emotes. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!emotecount`](/chatbot/commands/default/emotecount): Checks how many times a specific emote has been used in chat. # !enablesfx > Use the !enablesfx command in StreamElements chatbot to quickly re-enable all sound effect (SFX) items in your loyalty store. The `!enablesfx` command allows streamers and moderators to quickly re-enable all **sound effect** (SFX) items in the StreamElements loyalty store that were previously disabled (e.g., using `!disablesfx`). ## Usage [Section titled “Usage”](#usage) To enable all SFX store items, use the following command in chat: ```streamelements !enablesfx ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!enablesfx StreamElements:@Moderator, successfully updated 5 items. (SFX store opened) Example chat BroadcasterName:!enablesfx StreamElements:@Broadcaster, No disabled SFX store items found. ## Configuration [Section titled “Configuration”](#configuration) * Manage your store’s SFX items in your **StreamElements Dashboard** under `Loyalty` -> `Stream Store`. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!disablesfx`](/chatbot/commands/default/disablesfx): Disables all sound effect (SFX) items in the loyalty store. * [`!closestore`](/chatbot/commands/default/closestore): Disables all *regular* (non-SFX) items in the loyalty store. * [`!openstore`](/chatbot/commands/default/openstore): Enables all *regular* (non-SFX) items in the loyalty store. * [`!redeem`](/chatbot/commands/default/redeem): Allows viewers to redeem store items. # !filesay > Use the !filesay command in StreamElements chatbot to send multiple lines of text from a URL to chat, ideal for bulk commands like bans. The `!filesay` command allows streamers and moderators to execute multiple commands or messages stored in a text file hosted at a public URL. Each line in the text file is sent as a separate command/message to the chat. This is extremely useful for performing bulk actions, such as banning multiple users listed in a file. ## Usage [Section titled “Usage”](#usage) To execute the commands/messages from a file URL: ```streamelements !filesay ``` Important * The URL must point to a **raw text file** (e.g., a Pastebin raw link, a GitHub raw file link). * Each line in the file will be executed as if typed directly into chat. Ensure the commands are valid (e.g., `!ban username`). * There might be rate limits on how many lines can be processed quickly. ## Examples [Section titled “Examples”](#examples) **Example File (`https://pastebin.com/raw/examplebans`):** ```text /ban BotUser1 Spamming /ban TrollAccount2 Being disruptive /timeout AnotherUser 600 Repeat offences ``` **Using the command:** Example chat BroadcasterName:!filesay https\://pastebin.com/raw/examplebans StreamElements:Executing 3 lines from URL... StreamElements:BotUser1 has been permanently banned from the chat. StreamElements:TrollAccount2 has been permanently banned from the chat. StreamElements:AnotherUser has been timed out for 600 seconds. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The direct URL to a plain text file where each line contains a command or message to be sent. ## Configuration [Section titled “Configuration”](#configuration) * No specific module needs to be enabled, but the command relies on the bot having the necessary permissions to execute the commands listed within the file (e.g., ban permissions). * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!nuke`](/chatbot/commands/default/nuke): Times out all users who recently chatted based on a specific phrase. * [`!nukeusername`](/chatbot/commands/default/nukeusername): Times out all users whose usernames match a pattern. # !followage > Check how long you — or anyone — have been following a Twitch channel with the free !followage chat command in StreamElements Chatbot. The `!followage` command allows anyone in chat to check how long a specified Twitch user has been following a specified Twitch channel. If no user or channel is specified, it defaults to checking the command user’s follow duration for the current channel. ## Usage [Section titled “Usage”](#usage) Use the command with optional parameters: ```streamelements !followage [username] [channel_name] ``` ## Examples [Section titled “Examples”](#examples) **Check your own follow age:** Example chat Viewer1:!followage StreamElements:@Viewer1, You have been following CurrentChannel for 1 year 3 months 5 days 2 hours. **Check another user’s follow age in the current channel:** Example chat ViewerName:!followage StreamElements StreamElements:@User, StreamElements has been following CurrentChannel for 6 years 1 month 10 days 4 hours. **Check another user’s follow age for a different channel:** Example chat ViewerName:!followage StreamElements AnotherChannel StreamElements:@User, StreamElements is not following AnotherChannel. ## Parameters [Section titled “Parameters”](#parameters) * `[username]` (Optional): The Twitch username to check the follow age for. Defaults to the user running the command. * `[channel_name]` (Optional): The Twitch channel name to check the follow relationship against. Defaults to the current channel where the command is used. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!accountage`](/chatbot/commands/default/accountage): Checks when a Twitch account was created. * [`!uptime`](/chatbot/commands/default/uptime): Shows how long the current stream has been live. * [`!watchtime`](/chatbot/commands/default/watchtime): Shows how long a user has watched the current channel (requires Loyalty module). # !giveaway > Use the !giveaway command in StreamElements chatbot to check the status and link for the currently active channel giveaway. The `!giveaway` command allows anyone in chat to check the status of the currently active channel giveaway. If a giveaway is running, the command provides its name and a direct link for viewers to enter. Note This command *checks* the status of an active giveaway. To *start* or manage giveaways, use the StreamElements Dashboard Giveaway Module. ## Usage [Section titled “Usage”](#usage) To check the active giveaway details, simply type the command in chat: ```streamelements !giveaway ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!giveaway StreamElements:@User, Current giveaway: "Epic New Game Key!" https\://streamelements.com/YOUR\_CHANNEL/giveaway/GIVEAWAY\_ID Example chat ViewerName:!giveaway StreamElements:@User, There is currently no giveaway running! ## Configuration [Section titled “Configuration”](#configuration) * The `!giveaway` command requires a giveaway to be running. Manage giveaways in your **StreamElements Dashboard** under `Loyalty` -> `Giveaways`. * The command response reflects the settings of the currently active giveaway (name, entry requirements) configured by the streamer/moderator. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!ticket`](/chatbot/commands/default/ticket): Used by viewers to enter the active giveaway (if it requires loyalty points). * [`!raffle`](/chatbot/commands/default/raffle) / [`!sraffle`](/chatbot/commands/default/sraffle): Commands for different types of raffle/giveaway systems. # !givepoints > Viewers can use the !givepoints command in StreamElements chatbot to transfer their loyalty points to another user. The `!givepoints` command allows viewers to transfer their loyalty points to another user in the chat. This enables community interactions like gifting points or pooling resources. Note The `!givepoints` command is **disabled by default**. Enable it under `Chatbot` -> `Chat Commands` -> `Default Commands` before using it. ## Usage [Section titled “Usage”](#usage) To transfer points to another user: ```streamelements !givepoints ``` ## Examples [Section titled “Examples”](#examples) Example chat GenerousViewer:!givepoints LuckyFriend 500 StreamElements:@GenerousViewer -> gave 500 points to @LuckyFriend Example chat PoorViewer:!givepoints RichPal 10000 StreamElements:@PoorViewer, You only have 500 points. Example chat Viewer:!givepoints NonExistentUser 10 StreamElements:@Viewer, I couldn't find that user in the database :/ ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact username of the recipient. * `` (Required): The number of points to transfer. Must be a positive integer, and the sender must have sufficient points. ## Configuration [Section titled “Configuration”](#configuration) * Enable the **Loyalty system** in your **StreamElements Dashboard** under `Loyalty` -> `Loyalty Settings`. * The ability for users to give points can be enabled/disabled within the Loyalty Settings. * Streamers can set a minimum user level required to use the command and a cooldown period in the command’s settings under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!points`](/chatbot/commands/default/points): Check your own or another user’s point balance. * [`!addpoints`](/chatbot/commands/default/addpoints): (Moderator+) Manually add points to a user. * [`!setpoints`](/chatbot/commands/default/setpoints): (Moderator+) Set a user’s points to a specific value. * [`!top`](/chatbot/commands/default/top): View the leaderboard for points. # !hypecup > Use the !hypecup command in StreamElements chatbot to clear the HypeCup overlay contribution list on your Twitch stream. The `!hypecup` command allows streamers and moderators to clear the list of contributors displayed in the StreamElements HypeCup overlay widget. ## Usage [Section titled “Usage”](#usage) To clear the HypeCup overlay, use the following command in chat: ```streamelements !hypecup clear ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!hypecup clear StreamElements:@Moderator, Successfully cleared HypeCup. Example chat BroadcasterName:!hypecup StreamElements:@Broadcaster, Usage: !hypecup clear ## Parameters [Section titled “Parameters”](#parameters) * `clear` (Required): This is the only valid parameter and triggers the action to clear the HypeCup overlay list. ## Configuration [Section titled “Configuration”](#configuration) * This command interacts with the **HypeCup widget** in your StreamElements overlays. Ensure the widget is added to an active overlay. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. # !items > Use the !items command in StreamElements chatbot to get a link to the channel's loyalty store page, listing redeemable items. The `!items` command provides viewers with a direct link to the channel’s StreamElements loyalty store page. This page displays all currently available items that can be redeemed using loyalty points. ## Usage [Section titled “Usage”](#usage) To get the link to the store page, simply type the command in chat: ```streamelements !items ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!items StreamElements:Check out the available items here: https\://streamelements.com/YOUR\_CHANNEL\_NAME/store ## Configuration [Section titled “Configuration”](#configuration) * The linked store page only shows items that are currently enabled and redeemable. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!points`](/chatbot/commands/default/points): Check your current loyalty point balance. * [`!redeem`](/chatbot/commands/default/redeem): Allows viewers to redeem a specific store item directly via chat. * [`!closestore`](/chatbot/commands/default/closestore) / [`!openstore`](/chatbot/commands/default/openstore): (Moderator+) Commands to enable/disable regular store items. * [`!disablesfx`](/chatbot/commands/default/disablesfx) / [`!enablesfx`](/chatbot/commands/default/enablesfx): (Moderator+) Commands to enable/disable sound effect store items. # !join > Use the !join command in the StreamElements chatbot to enter active raffles started with !sraffle or !raffle. The `!join` command allows viewers to enter an **active raffle** in the chat. Viewers use this command to participate in raffles started by moderators using either [`!sraffle`](/chatbot/commands/default/sraffle) or [`!raffle`](/chatbot/commands/default/raffle). Entry is **free** — joining a raffle never costs points (points are the prize, not the entry fee) — and each viewer can only enter once per raffle; repeat `!join` messages are ignored. The command only does something while a raffle is running. If no raffle is active, `!join` does nothing. Note `!join` does **not** add you to the viewer queue. To enter the viewer queue, use [`!queue join`](/chatbot/commands/default/queue) instead. ## Usage [Section titled “Usage”](#usage) To enter the currently active raffle, simply type: ```streamelements !join ``` There are **no parameters** for this command. ## Examples [Section titled “Examples”](#examples) **Entering a raffle (`!sraffle`):** Example chat ModUser:!sraffle StreamElements:A raffle has begun! Enter by typing "!join". It will end in 60 seconds. ViewerName:!join ## Configuration [Section titled “Configuration”](#configuration) * The **Raffle module** must be enabled in your StreamElements dashboard (`Chatbot` -> `Modules` -> `Raffle`). ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!sraffle`](/chatbot/commands/default/sraffle): Starts a single-winner raffle where one entrant wins the full points prize. * [`!raffle`](/chatbot/commands/default/raffle): Starts a multi-winner raffle where the points prize is split between the winners. * [`!cancelraffle`](/chatbot/commands/default/cancelraffle): Cancels the active raffle. * [`!queue join`](/chatbot/commands/default/queue): Enters the viewer queue (not related to raffles). # !kappagen > Use the !kappagen command in StreamElements chatbot to trigger a visual emote explosion on the stream overlay via the Kappagen widget. The `!kappagen` command triggers a visual explosion of emotes on the stream overlay using the **StreamElements Kappagen widget**. This adds a fun, dynamic visual effect to the broadcast. ## Usage [Section titled “Usage”](#usage) To trigger the emote explosion: ```streamelements !kappagen ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!kappagen ## Configuration [Section titled “Configuration”](#configuration) * The **Kappagen widget** must be added to an active StreamElements overlay. * The `!kappagen` command must be enabled in your StreamElements Dashboard under `Chatbot` -> `Chat Commands` -> `Default Commands`. * You can customize the Kappagen widget settings (emotes used, intensity, duration, cooldown, cost, permissions) within the overlay editor and the command settings. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!emotes`](/chatbot/commands/default/emotes): Provides a link to the channel’s available emotes. * [`!alerts`](/chatbot/commands/default/alerts): Manages other overlay alert functions. # !leaderboard > Use the !leaderboard command in StreamElements chatbot to get a link to the channel's loyalty points or watch time leaderboard page. The `!leaderboard` command provides viewers with a direct link to the channel’s public StreamElements leaderboard page. This page ranks viewers based on loyalty points or watch time, depending on the channel’s configuration. ## Usage [Section titled “Usage”](#usage) To get the link to the leaderboard page, simply type the command in chat: ```streamelements !leaderboard ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!leaderboard StreamElements:Check out the channel Leaderboard here: https\://streamelements.com/YOUR\_CHANNEL\_NAME/leaderboard ## Configuration [Section titled “Configuration”](#configuration) * Enable the **Loyalty system** in your **StreamElements Dashboard** under `Loyalty` -> `Loyalty Settings`. * The leaderboard page displays rankings based on the settings configured in the Loyalty module (points or watch time). * The command itself is typically enabled by default. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!points`](/chatbot/commands/default/points): Check your current loyalty point balance. * [`!watchtime`](/chatbot/commands/default/watchtime): Check your accumulated watch time. * [`!top`](/chatbot/commands/default/top): Shows the top users (points or time) directly in chat. # !level > Moderators can use the !level command in StreamElements chatbot to view and manually override user permission levels. The `!level` command allows streamers and moderators to view or manually set the permission level of a specific user within the StreamElements system. User levels determine access to commands and other features. While levels like subscriber, VIP, and moderator are often assigned automatically based on platform roles, this command allows manual overrides or assigning custom levels like `Regular` or `Super Moderator`. ## Usage [Section titled “Usage”](#usage) **To check a user’s level:** ```streamelements !level ``` **To set a user’s level:** ```streamelements !level ``` **To reset a user’s level to default (based on their platform role):** ```streamelements !level reset ``` ## Examples [Section titled “Examples”](#examples) **Checking a level:** Example chat ModUser:!level RegularViewer StreamElements:@Moderator, The level of RegularViewer is 100. **Setting a user to Regular:** Example chat ModUser:!level RegularViewer 300 StreamElements:@Moderator, Successfully set RegularViewer's level to 300 (Regular). **Resetting a user’s level:** Example chat ModUser:!level RegularViewer reset StreamElements:@Moderator, Successfully reset RegularViewer's level to 100 (Everyone). ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact username of the target user. * ` or reset` (Optional): * Provide a numeric level value to manually set the user’s level. * Use the keyword `reset` to remove any manual override and revert to the level determined by their platform role (or default 100 if none). ## User Level Values [Section titled “User Level Values”](#user-level-values) StreamElements uses the following numeric values for permission levels: * `100`: Everyone (Default for non-sub/VIP/mod users) * `250`: Subscriber * `300`: Regular (Manually assigned via Dashboard or `!level`) * `400`: VIP (Twitch only) * `500`: Moderator * `1000`: Super Moderator (Manually assigned via Dashboard or `!level`) These six values are the only ones the bot accepts — commands like `!level` and `!command options -level` reject anything else. Note The dashboard’s custom-command **User level** dropdown additionally offers **Broadcaster**, a level above Super Moderator. It can only be assigned from the dashboard, not from chat. Note Manually setting a level (e.g., setting a non-sub to `250`) grants them the permissions of that level within StreamElements (e.g., access to sub-only commands) but does *not* grant them platform-specific benefits like sub badges or emotes. ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. * User levels are fundamental to command permissions configured in the **Chat Commands** section of the Dashboard. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!permit`](/chatbot/commands/default/permit): Temporarily grants link permission to a user, often used for users below a certain level. ## FAQ [Section titled “FAQ”](#faq) * **What happens if I use the command incorrectly?** The bot will guide you. You might see messages like: `@User, usage !level USER 500/reset` `@User, valid levels are: 100 (Everyone), 250 (Subscriber), 300 (Regular), 400 (VIP), 500 (Moderator), 1000 (Super Moderator)` # !module > Use the !module command in StreamElements chatbot to enable or disable specific chatbot modules (like games, points, etc.) directly from chat. The `!module` command allows streamers and moderators to enable or disable specific StreamElements chatbot modules directly from the chat. This provides real-time control over features like games, loyalty systems, or other functionalities without needing to access the dashboard. ## Usage [Section titled “Usage”](#usage) To enable or disable a module: ```streamelements !module ``` ## Examples [Section titled “Examples”](#examples) **Disabling the Roulette game module:** Example chat ModUser:!module roulette disable StreamElements:@Moderator, Module Roulette was disabled. **Enabling the Quotes module:** Example chat BroadcasterName:!module quotes enable StreamElements:@Broadcaster, Module Quotes was enabled. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The name of the module to modify (e.g., `roulette`, `duel`, `giveaway`, `quotes`, `loyalty`). Refer to the StreamElements Dashboard (`Chatbot` -> `Modules`) for a list of available module names. * `` (Required): Specify `enable` to turn the module on or `disable` to turn it off. ## Configuration [Section titled “Configuration”](#configuration) * Available modules and their current status can be viewed in the **StreamElements Dashboard** under `Chatbot` -> `Modules`. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!bot`](/chatbot/commands/default/bot): Controls the bot’s overall presence (mute/unmute/part). * [`!commands`](/chatbot/commands/default/commands): Provides a link to the list of commands (which are often tied to modules). # !next > Use the !next (!nextsong) command in StreamElements chatbot to see details about the next song in the media request queue. The `!next` command (aliased as `!nextsong`) allows anyone in chat to view details about the upcoming song in the StreamElements media request queue. It shows the channel, song title, requester, and a link. It only **displays** the next queued song — it does not skip anything; skipping is done by moderators with [`!skip`](/chatbot/commands/default/skip). ## Usage [Section titled “Usage”](#usage) To see the next song in the queue: ```streamelements !next ``` Or using the alias: ```streamelements !nextsong ``` ## Examples [Section titled “Examples”](#examples) Example chat ViewerName:!next StreamElements:@User, next song: SaxChannel - Epic Sax Guy 10 Hours, requested by SaxLover https\://youtu.be/kxopViU98Xo Example chat ViewerName:!nextsong StreamElements:@User, there are no songs in the queue! ## Configuration [Section titled “Configuration”](#configuration) * The information displayed depends on the data available from YouTube for the requested track. * Default cooldown: 10 seconds per user. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!song`](/chatbot/commands/default/song): Shows details about the *currently playing* song. * [`!songqueue`](/chatbot/commands/default/songqueue): Provides a link to the full media request queue. * [`!songrequest`](/chatbot/commands/default/songrequest): Allows users to request songs to add to the queue. * [`!skip`](/chatbot/commands/default/skip): (Moderator+) Skips the currently playing song. * [`!removesong`](/chatbot/commands/default/removesong): (Moderator+) Removes a specific song from the queue. # !nuke > Use the !nuke command in StreamElements chatbot to moderate chat by timing out, banning, or deleting recent messages matching specific text or regex. The `!nuke` command is a powerful moderation tool allowing moderators to perform bulk actions (timeout, ban, delete) on users whose recent messages contain specific text or match a regular expression. Caution This is a powerful command. Use it with caution, especially with broad match strings or regex. ## Usage [Section titled “Usage”](#usage) ```streamelements !nuke ``` ## Examples [Section titled “Examples”](#examples) **Timeout users saying “spam spam” in the last 60 seconds for 120 seconds:** Example chat ModUser:!nuke 60 120 spam spam StreamElements:@Moderator, Nuked 3 messages matching "spam spam". **Ban users whose messages matched a regex pattern in the last 5 minutes:** Example chat BroadcasterName:!nuke 300 ban /badsite.(com|net)/i StreamElements:@Broadcaster, Nuked 1 messages matching "/badsite.(com|net)/i". **Delete messages containing “selling stuff” in the last 30 seconds (Twitch only):** Example chat ModUser:!nuke 30 delete selling stuff StreamElements:@Moderator, Nuked 2 messages matching "selling stuff". ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The duration (in seconds, max 300) to scan previous messages. * `` (Required): The moderation action: * Number (e.g., `60`): Timeout duration in seconds. * `ban`: Permanently ban the users. * `delete`: Delete the matching messages (Twitch only, requires Mod status for the bot). * `` (Required): The text to search for. * For plain text matching: `some bad phrase` * For regular expression matching: Wrap the pattern in forward slashes, e.g., `/badword\d+/i` (the `i` makes it case-insensitive). ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. It’s highly recommended to keep this restricted. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!nukeusername`](/chatbot/commands/default/nukeusername): Performs similar actions but matches against usernames instead of message content. * [`!filesay`](/chatbot/commands/default/filesay): Executes commands line-by-line from a text file URL, useful for banning specific lists of users. # !nukeusername > Use the !nukeusername command in StreamElements chatbot to moderate chat by timing out or banning users whose usernames match specific text or regex. The `!nukeusername` command is a moderation tool allowing moderators to perform bulk actions (timeout or ban) on users whose **usernames** contain specific text or match a regular expression and have chatted within a specified lookback period. Caution This is a powerful command. Use it with caution, especially with broad match strings or regex, to avoid unintended actions against legitimate users. ## Usage [Section titled “Usage”](#usage) ```streamelements !nukeusername ``` ## Examples [Section titled “Examples”](#examples) **Timeout users for 300s whose username contains “bot123” and chatted in the last 60s:** Example chat ModUser:!nukeusername 60 300 bot123 StreamElements:@Moderator, Nuked 2 users matching "bot123". **Ban users whose usernames match a regex pattern (e.g., starts with “troll\_”) and chatted in the last 5 mins:** Example chat BroadcasterName:!nukeusername 300 ban /^troll\_/i StreamElements:@Broadcaster, Nuked 1 users matching "/^troll\_/i". ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The duration (in seconds, max 300) to scan previous chat messages to find users who chatted. * `` (Required): The moderation action: * Number (e.g., `60`): Timeout duration in seconds. * `ban`: Permanently ban the users. * **Note:** Unlike `!nuke`, `delete` is generally not applicable here as it targets message content, not usernames. * `` (Required): The text or pattern to match against usernames. * For plain text matching: `badnamepart` * For regular expression matching: Wrap the pattern in forward slashes, e.g., `/botaccount\d+/i` (the `i` makes it case-insensitive). ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. It’s highly recommended to keep this restricted. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!nuke`](/chatbot/commands/default/nuke): Performs similar actions but matches against message content instead of usernames. * [`!filesay`](/chatbot/commands/default/filesay): Executes commands line-by-line from a text file URL, useful for banning specific lists of users. # !openstore > Use the !openstore command in StreamElements chatbot to re-enable all regular (non-SFX) items in your loyalty store. The `!openstore` command allows streamers and moderators to quickly re-enable all **regular** (non-sound effect) items in the StreamElements loyalty store that were previously disabled (e.g., using `!closestore`). ## Usage [Section titled “Usage”](#usage) To enable all regular store items, use the following command in chat: ```streamelements !openstore ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!openstore StreamElements:@Moderator, successfully updated 15 items. (Store opened) Example chat BroadcasterName:!openstore StreamElements:@Broadcaster, No disabled regular store items found. ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!closestore`](/chatbot/commands/default/closestore): Disables all *regular* (non-SFX) items in the loyalty store. * [`!disablesfx`](/chatbot/commands/default/disablesfx): Disables only sound effect (SFX) items in the loyalty store. * [`!enablesfx`](/chatbot/commands/default/enablesfx): Enables only sound effect (SFX) items in the loyalty store. * [`!redeem`](/chatbot/commands/default/redeem): Allows viewers to redeem store items. * [`!items`](/chatbot/commands/default/items): Provides a link to the store page. # !pause > Use the !pause command in StreamElements chatbot to temporarily stop the media request playback without clearing the queue. The `!pause` command temporarily stops the playback of the current item in the StreamElements media request queue. The queue itself remains intact, and playback can be resumed later. ## Usage [Section titled “Usage”](#usage) To pause the currently playing media: ```streamelements !pause ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!pause StreamElements:@Moderator, Media request playback paused! ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!play`](/chatbot/commands/default/play): Resumes media playback after it has been paused. * [`!skip`](/chatbot/commands/default/skip): Skips the currently playing media item. * [`!volume`](/chatbot/commands/default/volume): Adjusts the volume of the media player. * [`!songrequest`](/chatbot/commands/default/songrequest): Adds a song/video to the queue. * [`!songqueue`](/chatbot/commands/default/songqueue): Provides a link to the media queue page. # !permit > Use the !permit command in StreamElements chatbot to temporarily allow a specific user to post links in chat without being timed out. The `!permit` command temporarily exempts a specified user from the bot’s automatic link filtering/timeout system. This allows them to post links for a short duration without being punished. ## Usage [Section titled “Usage”](#usage) To grant temporary link permission: ```streamelements !permit [duration_seconds] ``` ## Examples [Section titled “Examples”](#examples) **Permit a user for the default 60 seconds:** Example chat ModUser:!permit HelpfulViewer StreamElements:@HelpfulViewer, you have been permitted to post links for 60 seconds. **Permit a user for 120 seconds:** Example chat BroadcasterName:!permit TrustedFriend 120 StreamElements:@TrustedFriend, you have been permitted to post links for 120 seconds. ## Parameters [Section titled “Parameters”](#parameters) * `` (Required): The exact username of the viewer to permit. * `[duration_seconds]` (Optional): The duration (in seconds) the permit should last. Defaults to 60 seconds if not specified. ## Configuration [Section titled “Configuration”](#configuration) * This command relies on the **Link Protection** filter being enabled within the `Chatbot` -> `Spam Filters` section of the StreamElements Dashboard. * The default permit duration (if not specified in the command) can be configured in the Link Protection filter settings. * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!level`](/chatbot/commands/default/level): Used to view or set a user’s permanent permission level, which can also control link permissions. # !play > Use the !play (!resume) command in StreamElements chatbot to resume paused media request playback. The `!play` command (aliased as `!resume`) resumes the playback of the StreamElements media request queue after it has been stopped by the [`!pause`](/chatbot/commands/default/pause) command. ## Usage [Section titled “Usage”](#usage) To resume playback: ```streamelements !play ``` Or using the alias: ```streamelements !resume ``` ## Examples [Section titled “Examples”](#examples) Example chat ModUser:!play StreamElements:@Moderator, Media request playback resumed! ## Configuration [Section titled “Configuration”](#configuration) * The command’s permission level can be adjusted under `Chatbot` -> `Chat Commands` -> `Default Commands`. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!pause`](/chatbot/commands/default/pause): Pauses the current media playback. * [`!skip`](/chatbot/commands/default/skip): Skips the currently playing media item. * [`!volume`](/chatbot/commands/default/volume): Adjusts the volume of the media player. * [`!songrequest`](/chatbot/commands/default/songrequest): Adds a song/video to the queue. * [`!songqueue`](/chatbot/commands/default/songqueue): Provides a link to the media queue page. # !points > Use the !points command in StreamElements chatbot to check your own or another user's loyalty points balance and leaderboard rank. The `!points` command allows anyone in chat to check the loyalty point balance and leaderboard rank of themselves or another specified user. ## Usage [Section titled “Usage”](#usage) To check points and rank: ```streamelements !points [username] ``` Note The command also triggers on your channel’s custom points name. For example, if your loyalty currency is named “ChannelPoints”, typing `!channelpoints` works as well. ## Examples [Section titled “Examples”](#examples) **Checking your own points:** Example chat Viewer1:!points StreamElements:@Viewer1, you have 5280 ChannelPoints and are rank #15 on the leaderboard. **Checking another user’s points:** Example chat ViewerName:!points StreamElements StreamElements:@StreamElements has 99999 ChannelPoints and is rank #1 on the leaderboard. ## Parameters [Section titled “Parameters”](#parameters) * `[username]` (Optional): The exact username of the user whose points you want to check. If omitted, it defaults to the user running the command. ## Configuration [Section titled “Configuration”](#configuration) * Enable and configure the Loyalty system under `Loyalty` -> `Loyalty Settings` in your StreamElements Dashboard. * The loyalty currency name (e.g., “ChannelPoints” in the examples) is customizable in the Loyalty Settings. ## Related Commands [Section titled “Related Commands”](#related-commands) * [`!top`](/chatbot/commands/default/top): Shows the top users on the leaderboard directly in chat. * [`!leaderboard`](/chatbot/commands/default/leaderboard): Provides a link to the full leaderboard page. * [`!givepoints`](/chatbot/commands/default/givepoints): Allows users to transfer points to each other. * [`!addpoints`](/chatbot/commands/default/addpoints) / [`!setpoints`](/chatbot/commands/default/setpoints): (Moderator+) Commands to modify user points. # !queue > Use the !queue command in StreamElements chatbot to manage viewer queues for activities like playing games with the streamer. 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). ## Usage [Section titled “Usage”](#usage) The general syntax follows this pattern: ```streamelements !queue [arguments...] ``` A subcommand is always required — typing `!queue` on its own does nothing. Permissions The management subcommands (`open`, `close`, `pause`, `unpause`, `pick`, `remove`) require **Moderator** permission level or higher. The viewer subcommands (`join`, `position`, `list`) are available to everyone. ## Subcommands [Section titled “Subcommands”](#subcommands) Here’s a breakdown of the available subcommands: ### `join` [Section titled “join”](#join) Allows a viewer to enter the open queue. Note You must type the full `!queue join` to enter the viewer queue. The standalone [`!join`](/chatbot/commands/default/join) command is unrelated — it enters an active raffle instead. * **Syntax:** `!queue join` * **Example:** Example chat ViewerName:!queue join StreamElements:@User, you have been added to the queue in position #5. ### `position` [Section titled “position”](#position) Checks the command user’s current position in the queue. * **Syntax:** `!queue position` * **Example:** Example chat ViewerName:!queue position StreamElements:@User, you are currently position #3 in the queue. ### `list` [Section titled “list”](#list) Lists who is currently waiting in the queue. The bot posts up to 5 names in chat, followed by a count of how many other viewers are also waiting. * **Syntax:** `!queue list` * **Example:** Example chat ViewerName:!queue list StreamElements:Currently waiting in the Viewer Games queue: UserOne, UserTwo, UserThree, UserFour, UserFive and 7 others. ### `open