Moderation Commands

Sentinel Bot's moderation commands allow you to manage users and content on your server quickly and efficiently. All commands include permission checks, automatic logging, and protection against common errors.

General Features

✅ Permission Verification: Only users with appropriate permissions can use these commands
✅ Whitelist Respect: Whitelisted users are protected from bans and kicks
✅ Automatic Logging: All actions are logged in security logs
✅ Private Responses: Only the person executing the command sees the responses
✅ Security Validations: Prevents common errors (self-ban, etc.)

Ban Commands

/mod ban add

Bans a user from the server.

Syntax

/mod ban add usuario:@User [razon:"Ban reason"] [dias:7]

usuario (required): The user to ban
razon (optional): Ban reason that will be shown in logs
dias (optional): Days of messages to delete (0-7, default 0)

Examples

/mod ban add usuario:@Spammer razon:"Massive spam" dias:7
/mod ban add usuario:123456789012345678 razon:"Toxic behavior"
/mod ban add usuario:@User dias:3

💡 Important notes:

You cannot ban users on the whitelist
You cannot ban yourself
You cannot ban the server owner
Deleted messages are permanently deleted (cannot be recovered)
The action is automatically logged

/mod ban remove

Unbans a user from the server.

Syntax

/mod ban remove usuario:@User

usuario (required): The user to unban (can be ID if not in server)

Examples

/mod ban remove usuario:@User
/mod ban remove usuario:123456789012345678

/mod ban list

Shows a list of all banned users on the server.

💡 Information shown:

User name and tag
User ID
Approximate ban date

Kick Commands

/mod kick

Kicks a user from the server (they can rejoin with an invitation).

Syntax

/mod kick usuario:@User [razon:"Kick reason"]

usuario (required): The user to kick
razon (optional): Kick reason for logs

Examples

/mod kick usuario:@User razon:"Inappropriate behavior"
/mod kick usuario:@User razon:"Spam in multiple channels"

⚠️ Differences between ban and kick:

Kick: User can rejoin with a valid invitation
Ban: User cannot rejoin until unbanned

Use kick for severe warnings, ban for permanent removals.

Clear Messages

/mod clear

Deletes messages from a channel. You can clear general messages or only from a specific user.

Syntax

/mod clear cantidad:50 [canal:#channel] [usuario:@User]

cantidad (required): Number of messages to delete (1-100)
canal (optional): Channel where to delete. If not specified, uses current channel
usuario (optional): Only delete messages from this user

Examples

# Delete 50 messages from current channel/mod clear cantidad:50
# Delete 20 messages from a specific user/mod clear cantidad:20 usuario:@Spammer
# Delete 100 messages from a specific channel/mod clear cantidad:100 canal:#general

💡 Limits and restrictions:

Maximum 100 messages per command
Cannot delete messages older than 14 days (Discord limit)
Pinned messages are not deleted
If deleting messages from a user, the bot searches in the channel's recent messages

Timeout (Mute User)

/mod timeout

Temporarily mutes a user. They will not be able to send messages, react, speak in voice channels, or join threads.

Syntax

/mod timeout usuario:@User minutos:60 [razon:"Timeout reason"]

usuario (required): The user to mute
minutos (required): Mute duration in minutes (1-40320, maximum 28 days)
razon (optional): Timeout reason for logs

Examples

# 1 hour timeout/mod timeout usuario:@User minutos:60 razon:"Spam"
# 1 day timeout/mod timeout usuario:@User minutos:1440 razon:"Inappropriate behavior"
# 7 day timeout/mod timeout usuario:@User minutos:10080 razon:"Serious infraction"

💡 Useful conversions:

1 hour = 60 minutes
1 day = 1,440 minutes
1 week = 10,080 minutes
28 days (maximum) = 40,320 minutes

Warn User

/mod warn

Sends a private warning to a user via direct message (DM).

Syntax

/mod warn usuario:@User [razon:"Warning reason"]

usuario (required): The user to warn
razon (optional): Warning reason

Examples

/mod warn usuario:@User razon:"Inappropriate language"
/mod warn usuario:@User razon:"Not following channel rules"

💡 About warnings:

The user will receive a private message (DM) with the warning
If the user has DMs disabled, the warning will not be sent, but will be logged
Warnings are logged for tracking
You can use warnings to create a manual "strikes" system

Channel Slowmode

/mod slowmode

Sets slow mode on a channel. Limits how long a user must wait between messages.

Syntax

/mod slowmode segundos:30 [canal:#channel]

segundos (required): Wait time between messages (0-21600, maximum 6 hours)
canal (optional): Channel where to apply. If not specified, uses current channel

Examples

# Activate 30 second slowmode in current channel/mod slowmode segundos:30
# Deactivate slowmode (0 seconds)/mod slowmode segundos:0
# 5 minute slowmode in a specific channel/mod slowmode segundos:300 canal:#general

💡 Useful conversions:

10 seconds = 10
1 minute = 60
5 minutes = 300
1 hour = 3,600
6 hours (maximum) = 21,600

⚠️ Important note:
To deactivate slowmode, set seconds to 0.

Logs and Records

All moderation actions are automatically logged in the configured log channel.

What is logged?

✅ User who executed the action
✅ Target user
✅ Action type (ban, kick, timeout, etc.)
✅ Provided reason
✅ Channel where it occurred (if applicable)
✅ Event timestamp

Configure Log Channel

Go to Settings → Logs in the web panel
Find "Ban Log Channel" or "General Log Channel"
Paste the ID of the channel where you want to receive logs
Save changes

Security Protections

Moderation commands include multiple protections:

1. Whitelist Protection

Users on the whitelist cannot be banned or kicked. If you try to do so, the bot will reject the action.

2. Self-Moderation Prevention

You cannot:

Ban yourself
Kick yourself
Apply timeout to yourself

3. Owner Protection

The server owner cannot be moderated by the bot.

4. Permission Verification

Each command verifies that you have the necessary permissions before executing:

Ban: Requires "Ban Members" permission
Kick: Requires "Kick Members" permission
Timeout: Requires "Moderate Members" permission
Clear: Requires "Manage Messages" permission
Slowmode: Requires "Manage Channels" permission

Best Practices

Use descriptive reasons: Helps other moderators understand why an action was taken
Review logs regularly: Will help you identify patterns and improve moderation
Use warnings before severe actions: Gives users a chance to correct themselves
Configure slowmode in active channels: Prevents spam during events or raids
Clear messages after incidents: Keeps the server organized

Frequently Asked Questions

Can I moderate users who are not in the server?

Yes, for bans and unbans you can use the user ID directly. For other actions (kick, timeout), the user must be in the server.

Do commands work if the user is offline?

Yes, you can ban, unban, and apply timeout to users even if they are not connected.

What happens if I try to ban someone on the whitelist?

The bot will reject the action and show you a message indicating that the user is protected by the whitelist.

Can I cancel a timeout before it ends?

Yes, you can use /mod timeout usuario:@User minutos:0 to remove the timeout immediately.

Can the bot moderate other bots?

No, the bot cannot moderate other bots due to Discord limitations.

💡 Final Tip:
Moderation commands are powerful tools. Use them responsibly and always provide clear reasons for your actions. Remember that all actions are logged for later review.