Bot Missing Permissions for Moderation Actions

Common Permission Errors

When M4T3 attempts moderation actions like /admin punish commands (kick, ban, timeout, warn), you may encounter permission-related failures. These occur when the bot lacks the necessary Discord permissions to perform the requested action.

Required Bot Permissions

For All Moderation Actions

• Send Messages - To respond with success/error messages
• Embed Links - To display formatted response embeds
• Use External Emojis - For status indicators in embeds

Action-Specific Permissions

• Kick Members - Required for /admin punish kick action
• Ban Members - Required for /admin punish ban action
• Moderate Members - Required for /admin punish timeout action
• Manage Messages - Required for anti-spam and auto-moderation features
• Manage Channels - Required for channel-specific moderation
• Connect and Speak - Required for voice channel moderation

How to Fix Permission Issues

Step 1: Check Bot Role Position

1. Go to Server Settings > Roles
2. Find the M4T3 role in the list
3. Drag it above the roles of users you want to moderate
4. Important: Discord hierarchy rule - bots can only moderate users with lower roles

Step 2: Verify Bot Permissions

1. Right-click the M4T3 role
2. Select Edit Role
3. Go to the Permissions tab
4. Enable the required permissions listed above
5. Click Save Changes

Step 3: Check Channel-Specific Permissions

1. Go to the channel where moderation fails
2. Click the Settings (gear) icon
3. Go to Permissions tab
4. Find M4T3 in the member/role list
5. Ensure no permissions are explicitly denied (red X)
6. Grant necessary permissions if needed

Error Messages You Might See

From Kick/Ban/Timeout Commands

• "Failed to kick [user]: Missing Permissions"
• "Failed to ban [user]: Missing Permissions"
• "Failed to timeout [user]: Missing Permissions"

From Anti-Spam/Auto-Mod

• Permission errors in channel when trying to delete messages
• Auto-moderation features not triggering
• Welcome messages not posting

Role Hierarchy Rules

Understanding Discord Hierarchy

• M4T3 can only moderate users whose highest role is below M4T3's role
• Server owner and administrator roles bypass most restrictions
• Bot cannot moderate other bots with equal or higher role positions

Best Practice Setup

1. Create a "Bot" role category near the top
2. Place M4T3 role in this category
3. Ensure M4T3 is above all member roles
4. Keep M4T3 below admin/moderator roles only

Testing Your Setup

Quick Permission Test

1. Use /admin punish on a test user (with lower role)
2. Try each action: warn, timeout, kick
3. Check for error messages or successful completion
4. Verify actions appear in server audit log

Voice Channel Test

1. Ensure M4T3 can Connect and Speak in voice channels
2. Test music commands in voice channels
3. Check dynamic channel creation (if enabled)

Special Cases

Premium vs Free Servers

• Some moderation features require active subscription
• Error: "This feature requires a premium subscription"
• Check your server's subscription status in dashboard

Auto-Moderation Bypass

• Users with Manage Messages permission bypass auto-mod
• This is intentional to prevent moderating staff
• Anti-spam ignores users with Manage Messages

Still Having Issues?

Check These Common Problems

1. Server verification level too high preventing bot actions
2. Two-factor authentication required for moderation
3. Explicit content filter blocking bot messages
4. Rate limiting from Discord API (temporary)

Getting More Help

If permission issues persist after following these steps:

• Check server audit log for specific error details
• Try removing and re-adding M4T3 with proper permissions
• Use Discord's built-in permission calculator
• Contact support with specific error messages