Warns Commands

Complete guide to Warns module commands and features

📦 Warns Commands

Keep your members in check with warnings; stop them getting out of control! If you’re looking for automated warnings, read about the blacklist module!

User Commands:

/warns [user]: See your own warnings, or another user’s.

Admin Commands:

/warn : Warn a user.
/dwarn : Warn a user by reply, and delete their message.
/swarn : Warn a user and delete your command message; the warning is still posted.
/rmwarn: Remove a user’s latest warning.
/resetwarns: Reset all of a user’s warnings to 0.
/resetallwarns: Delete all the warnings in a chat. All users return to 0 warns. (creator only)
/warnings: Get the chat’s warning settings.
/setwarnmode <ban/kick/mute/tban/tmute> [time]: Set the chat’s warn mode.
/setwarntime <time/off>: Set how long a warn counts, e.g. 30d; off keeps warns forever. Warns issued before the bot recorded warn times never expire; /resetwarns removes them.
/setwarnlimit : Set the number of warnings before users are punished.

Examples

Warn a user. -> /warn @user For disobeying the rules

Default Settings:

Default warn limit: 3 warnings
Default warn mode: mute
Default warn expiry: off (warns never expire)

Available Warn Modes:

ban - Permanently ban the user from the chat
kick - Kick the user (they can rejoin)
mute - Mute the user (cannot send messages)
tban - Ban the user for the time given with the mode, e.g. /setwarnmode tban 1d
tmute - Mute the user for the time given with the mode, e.g. /setwarnmode tmute 2h

Warnings That Delete Messages:

/swarn - Delete your command; the warning is still posted
/dwarn - Delete the user’s message and warn them

Module Aliases

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

This module can be accessed using the following aliases:

warn
warning
warnings

Available Commands

Command	Description	Disableable
`/dwarn`	Warn a user and delete the replied message	❌
`/resetallwarns`	Reset all warnings for all users in the chat (chat owner only)	❌
`/resetwarn`	Alias of `/resetwarns` - reset all warnings for a user	❌
`/resetwarns`	Reset all warnings for a user	❌
`/rmwarn`	Remove the last warning from a user	❌
`/setwarnlimit`	Set maximum warnings before action (range: 1–100)	❌
`/setwarnmode`	Set action taken when warn limit is reached	❌
`/setwarntime`	Set how long a warn counts before it expires	❌
`/swarn`	Warn a user and delete your command (the warning is still posted)	❌
`/unwarn`	Alias of `/rmwarn` - remove the last warning from a user	❌
`/warn`	Warn a user	❌
`/warnings`	Get the chat’s warning settings	❌
`/warns`	Show warning count for a user	✅

Usage Examples

Basic Usage

/dwarn
/resetallwarns
/resetwarn

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

Required Permissions

Permission Requirements:

/warn: Bot admin + User admin with restrict
/dwarn, /swarn: Bot admin + User admin, both with restrict and delete rights
/rmwarn, /unwarn: Bot admin + User admin
/resetwarn, /resetwarns: Bot admin + User admin
/resetallwarns: Chat owner only
/setwarnmode, /setwarnlimit, /setwarntime: Bot admin + User admin
/warnings: Bot admin + User admin
/warns: Any user (disableable)

Technical Notes

Notes:

When a user reaches the warn limit, the configured action (ban/kick/mute/tban/tmute) is applied automatically
Warning reasons are stored and displayed when checking a user’s warns
The /warns command is the only command in this module that can be disabled by admins
Anonymous channel posts cannot be warned
Admins cannot be warned