Skip to main content

!nukeusername

Twitch YouTube Trovo Kick

Overview​

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.

Warning: This is a powerful command. Use it with caution, especially with broad match strings or regex, to avoid unintended actions against legitimate users.

Important: By default, only users with Super Moderator permission level or higher can use this command.

Usage​

!nukeusername <lookback_seconds> <action> <match_text_or_regex>

Examples​

Timeout users for 300s whose username contains "bot123" and chatted in the last 60s:

example chat
moderator badgeModUser:!nukeusername 60 300 bot123
partner badgemoderator badgeStreamElements:@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
broadcaster badgeBroadcasterName:!nukeusername 300 ban /^troll_/i
partner badgemoderator badgeStreamElements:@Broadcaster, Nuked 1 users matching "/^troll_/i".

Parameters​

  • <lookback_seconds> (Required): The duration (in seconds, max 300) to scan previous chat messages to find users who chatted.
  • <action> (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.
  • <match_text_or_regex> (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​

  • The command's permission level can be adjusted under Chatbot -> Chat Commands -> Default Commands. It's highly recommended to keep this restricted.
  • !nuke: Performs similar actions but matches against message content instead of usernames.
  • !filesay: Executes commands line-by-line from a text file URL, useful for banning specific lists of users.

Aliases​

There are no default aliases for this command. Custom aliases can be created in the StreamElements dashboard.