!nuke
Twitch YouTube Trovo Kick
Overview
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.
Warning: This is a powerful command. Use it with caution, especially with broad match strings or regex.
Important: By default, only users with Super Moderator permission level or higher can use this command.
Usage
!nuke <lookback_seconds> <action> <match_text_or_regex>
Examples
Timeout users saying "spam spam" in the last 60 seconds for 120 seconds:
example chat
ModUser:
StreamElements:
Ban users whose messages matched a regex pattern in the last 5 minutes:
example chat
BroadcasterName:
StreamElements:
Delete messages containing "selling stuff" in the last 30 seconds (Twitch only):
example chat
ModUser:
StreamElements:
Parameters
<lookback_seconds>
(Required): The duration (in seconds, max 300) to scan previous messages.<action>
(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).
- Number (e.g.,
<match_text_or_regex>
(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
(thei
makes it case-insensitive).
- For plain text matching:
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
!nukeusername
: Performs similar actions but matches against usernames instead of message content.!filesay
: Executes commands line-by-line from a text file URL, useful for banning specific lists of users.