/warnings

Overview

/warnings manages the warnings members accumulate from /warn. Use it to review a user's warning history, remove individual warnings, clear all of a user's warnings, or configure what happens when a member hits the warning limit.

Required Permissions

• Moderate Members for view, delete, and clear.
• Administrator for settings.

Subcommands

view

Option	Required	Description
user	Yes	User whose warnings to view

Shows the user's warning count against the configured maximum, with each warning's moderator, reason, and date. Paginated at 5 warnings per page.

delete

Option	Required	Description
user	Yes	User to remove a warning from

Opens the same paginated list with a select menu. Choosing a warning asks for confirmation, then removes that single warning and decrements the user's warning count.

clear

Option	Required	Description
user	Yes	User to clear all warnings for
reason	No	Reason for clearing

Removes all of the user's warnings in one action. The user is DMed with the reason.

settings

Option	Required	Description
max_warnings	No	Warnings allowed before punishment triggers (1–20)
punishment	No	Action applied at the limit: mute, kick, or ban
mute_duration	No	Mute length when punishment is mute, e.g. 1d, 12h

Run with no options to view current settings. Omitted options keep their current values.

Behavior

• Reaching max_warnings triggers the configured punishment and resets the user's warning count to zero.
• Time format for mute_duration: use s, m, h, d, w (for example 5s, 10m, 1d).
• All warning changes are logged to the log channel if one is configured.