Slowmode¶
The slowmode command allows server moderators to control the rate at which members can send messages in a channel. This is highly effective for managing high-traffic discussions, stopping spam, or forcing a slower pace in specific channels.
When slowmode is active, users will see a countdown in their message box after sending a message, indicating how long they must wait before sending another.
Syntax¶
The slowmode command can be used in two ways:
Slash Command:
/slowmode [seconds:STRING] [channel:CHANNEL]
Prefix Command:
$slowmode [seconds] [channel]
Aliases:
sm
Parameters¶
| Parameter | Type | Required | Description |
|---|---|---|---|
channel |
Channel | No | The channel to modify (defaults to current). |
seconds |
String | No | The delay value (e.g., 10, 5s, 2m). If omitted, Tux returns the current setting. |
Constraints¶
- Maximum Delay: Discord allows a maximum slowmode of 21600 seconds (6 hours).
- Minimum Delay:
0(disables slowmode).
Permissions¶
Bot Permissions¶
Tux requires the following permissions:
- Manage Channels - Required to modify channel settings like slowmode.
User Permissions¶
Users need appropriate moderation permissions to use this command.
Permission System
Command permissions are configured per-guild using Tux's dynamic permission system. Configure via /config commands or see the Permission Configuration guide.
Usage Examples¶
Get Current Slowmode¶
Check the slowmode setting for the current channel.
/slowmode
Set Slowmode in Current Channel¶
Setting a 10-second delay.
/slowmode seconds:10
Set Slowmode for Another Channel¶
Setting a 5-minute delay for #general.
$slowmode #general 5m
Disable Slowmode¶
/slowmode seconds:0
Response¶
When executed successfully, Tux will:
- Update the channel's slowmode setting on Discord.
- Return a confirmation message (slash command) or send a temporary confirmation (prefix command) stating the new slowmode setting.
Error Handling¶
Common Errors¶
Error: Invalid Delay Format¶
When it occurs: The provided delay string is not a simple number or doesn't use supported units (s, m, h).
Solution: Use a number (seconds) or a number with a unit (e.g., 30s, 10m).
Error: Amount Too High¶
When it occurs: The requested delay exceeds 6 hours (21600 seconds).
Solution: Use a delay within the 0 to 21600 second range.
Error: Unsupported Channel Type¶
When it occurs: You attempt to set slowmode in a channel type that doesn't support it (e.g., a Category).
Solution: Use slowmode in Text Channels, Threads, or Voice Channels.