Blacklists Commands

Complete guide to Blacklists module commands and features

📦 Blacklists Commands

User Commands: × /blacklists: Check all the blacklists in chat.

Admin Commands: × /addblacklist <trigger>: Blacklists the word in the current chat. × /rmblacklist <trigger>: Removes the word from current Blacklisted Words in Chat. × /blaction <mute/kick/ban/warn/none/tban/tmute> [duration]: Sets the action to be performed by bot when a blacklist word is detected. Temporary actions require a duration, such as /blaction tban 1d or /blaction tmute 2h. With no arguments, shows the current action and duration. × /blacklistaction: Same as above

Owner Only: × /remallbl /rmallbl /rmblocklistall /rmallblocklist: Removes all the blacklisted words from chat

Note: The Default mode for Blacklist is warn, which will delete the message and issue a warning to the user.

Available Actions: The following actions can be set using /blaction:

none - Just deletes the message without any further action
warn - Deletes message and issues a warning to the user (default)
mute - Deletes message and mutes the user
kick - Deletes message and kicks the user (they can rejoin)
ban - Deletes message and permanently bans the user
tban - Deletes message and bans the user for the required duration
tmute - Deletes message and mutes the user for the required duration

Temporary durations range from 1 minute to 366 days, using m, h, d, or w. The action and duration apply to every word, including words added later. Switching to an untimed action clears the duration. Older temporary-action settings without a usable duration keep the one-hour fallback; temporary actions do not punish channel senders.

Commands:

/addblacklist <trigger> - Blacklists the word in the current chat
/rmblacklist <trigger> - Removes the word from current Blacklisted Words in Chat
/blaction <mute/kick/ban/warn/none/tban/tmute> [duration] - Sets the action to be performed by bot when a blacklist word is detected
/remallbl / /rmallbl / /rmblocklistall / /rmallblocklist - Removes all the blacklisted words from chat (Owner Only)

Module Aliases

These are help-menu module names, not command aliases.

This module can be accessed using the following aliases:

blacklist
unblacklist
blocklist
addblocklist

Available Commands

Command	Description	Disableable
`/addblacklist`	Add a trigger to the blacklist	❌
`/addblocklist`	Alias of `/addblacklist`	❌
`/blacklist`	Add a trigger to the blacklist	❌
`/blacklistaction`	Set action for blacklist triggers	❌
`/blacklists`	List all blacklisted triggers	✅
`/blaction`	Set action for blacklist triggers	❌
`/blocklist`	Alias of `/addblacklist`	❌
`/blocklists`	Alias of `/blacklists`	✅
`/remallbl`	Remove all blacklist triggers	❌
`/rmallbl`	Alias of `/remallbl`	❌
`/rmallblocklist`	Alias of `/remallbl`	❌
`/rmblacklist`	Remove a trigger from the blacklist	❌
`/rmblocklist`	Alias of `/rmblacklist`	❌
`/rmblocklistall`	Alias of `/remallbl`	❌
`/unblacklist`	Alias of `/rmblacklist`	❌

Usage Examples

Basic Usage

/addblacklist spam
/blaction tban 1d
/blaction tmute 2h
/blaction

For detailed command usage, refer to the commands table above.

Required Permissions

/addblacklist, /blacklist, /addblocklist, /blocklist — Requires admin + Restrict Members permission (CanUserRestrict)
/rmblacklist, /rmblocklist, /unblacklist — Requires admin + Restrict Members permission (CanUserRestrict)
/blaction, /blacklistaction — Requires admin + Restrict Members permission (CanUserRestrict)
/remallbl, /rmallbl, /rmblocklistall, /rmallblocklist — Requires chat owner (creator)
/blacklists, /blocklists — Available to all users (disableable)

Bot must also be admin with Restrict Members permission for add/remove/action commands.