Overview
Moderation features in Yato include member management (ban, kick) and message cleanup tools. These commands are designed with safety checks to prevent misuse and ensure proper permission hierarchy.Ban
Permanently remove users from your server
Kick
Temporarily remove users from your server
Purge
Bulk delete messages from channels
Ban members
Permanently ban a user from your server with an optional reason.Usage
Parameters
user(required) - Select the user you want to ban from the dropdown menureason(optional) - Provide a reason for the ban that will be logged
Required permissions
User permission
BAN_MEMBERS
Bot permission
BAN_MEMBERS
Example
- Verify you have permission to ban members
- Check that the bot can ban the target user (role hierarchy)
- Prevent you from banning yourself
- Ban the user and display a success message
Kick members
Temporarily remove a user from your server. Unlike banning, kicked users can rejoin if they have a valid invite link.Usage
Parameters
user(required) - Select the user you want to kick from the dropdown menureason(optional) - Provide a reason for the kick that will be logged
Required permissions
User permission
KICK_MEMBERS
Bot permission
KICK_MEMBERS
Example
- Verifies proper permissions
- Checks role hierarchy
- Prevents self-kicks
- Displays confirmation when successful
If no reason is provided, the action will be logged as “No reason provided by [your username]“
Purge messages
Bulk delete messages from a channel to clean up spam, off-topic content, or unwanted messages.Usage
Parameters
number(required) - The number of messages to delete (1-100)
Required permissions
User permission
MANAGE_MESSAGES
Bot permission
MANAGE_MESSAGES
Examples
Limitations
- Maximum 100 messages can be purged at once
- Messages older than 14 days cannot be purged (Discord API limitation)
- The bot must have access to the channel and proper permissions
Best practices
Document your actions
Always provide a reason when using moderation commands. This helps maintain transparency and creates an audit trail for server staff.Check permissions first
Before executing moderation commands, ensure:- Yato’s role is positioned high enough in the role hierarchy
- Yato has the required permissions in the target channel
- You have the necessary permissions to execute the command
Use purge responsibly
The purge command is powerful but irreversible. Consider:- Reviewing messages before purging when possible
- Starting with smaller numbers to test
- Communicating with your community about cleanup actions
Troubleshooting
”I can’t ban/kick this member”
This error occurs when:- The target user has a role equal to or higher than the bot’s highest role
- The bot lacks the required permission
- You’re trying to ban/kick yourself