Warnings & Punishments

Use punishments in accordance with server rules. Before manual punishment, ensure the user and evidence are correct, the action is immediate, and the bot and moderator are authorized to act against the user's role.

1. Preparation & Authorization

Admin configures Admin/Moderator roles, log channels, and punishment rules via /setup.
Moderator logs in according to server policy with /staff_login, and if required - enables 2FA according to the 2FA guide.
Enable Safe Mode with /safemode. Commands marked with Safe Mode in the command reference will not execute until authentication is complete.

2. Manual Punishment

The main command is /punish. Select a user, action type, reason or server rule, and optionally add an evidence ID/link or image.

/punish member:@User punishment_type:Warning rule_or_reason:spam /punish member:@User punishment_type:Timeout rule_or_reason:"Chat flooding"

Available types in the command: Warning, Timeout, Kick, and Ban.
If an existing rule is selected, the bot uses the type and duration configured in the rule. Manual timeout without an explicit duration defaults to 10 minutes in the current code.
The bot blocks self-punishment, bot punishment, server administrator, user with equal/higher role than the moderator, or user whose role is above the bot's role.
Add evidence only when necessary; do not include personal information or secrets.

3. Helper Commands

/warnings user:@User - View warnings.
/punishstats punishment_id:… - Action details by ID.
/unpunish user:@User punishment_id:… reason:… - Reverse a specific action; requires Safe Mode.
/clearwarnings member:@User - Delete warnings; requires Safe Mode. Verify the user carefully before approving.
/mute, /unmute and /tempban are available depending on the command and server permissions; check the options Discord presents and the command catalog.

4. Documentation & Verification

Ensure Warning, Timeout, Kick, and Ban log channels are configured in /setup.
Test with a test account/server before enabling broad automatic rules.
If an action fails, check the Discord message, bot permissions, role hierarchy, and Safe Mode. Do not repeat punishment until you verify the previous action was recorded.
See also the error guide and logging guide.