Granular Role Permissions, Auto-Punishments, Embed DMs, and ModLogs natively integrated into Slash Commands.
- Drop
into yourCode:
moderation.pyfolderCode:/configurations - Open the file to configure your
and your custom Role Permissions!Code:
MODLOG_CHANNEL_ID - Run
in DiscordCode:
!load moderation - Sync your slash commands
Unlike standard bots, you can choose exactly which roles (or users) can perform which actions. You can assign multiple IDs separated by commas!
Code:
# Example:
PERMISSIONS = {
"warn": [11111, 22222], # Helpers & Admins can warn
"clearwarns": [22222], # Only Admins can clear warns
"timeout": [22222], # Only Admins can mute
"kick": [22222], # Only Admins can kick
"ban": [33333], # Only SuperAdmins can ban
}
Slash Commands (/mod) — Clean, native Discord UX. No more typing
.Code:!ban @user spam
Premium UI Embeds — All moderation replies are visually stunning, color-coded embeds displaying the target, reason, and the moderator's avatar.
Advanced Warn System — Warns are saved permanently in a JSON database. The bot tracks who warned them, when, and why.
Auto-Punishments — Fully automated! Reach 3 warns? Auto 1-hour Timeout. Reach 5 warns? Auto Kick. Reach 7 warns? Auto Ban. All customizable directly in the code!
ModLogs Channel — Every action generates a detailed, color-coded embed in your dedicated #mod-logs channel.
Auto-DM Notification Embeds — The bot will always attempt to privately message the user with a clean Embed explaining why they were punished and by which server before taking action.
Role Hierarchy Protection — Moderators cannot punish users who have a higher or equal role to them.
-
— Warns a user, DMs them, and logs it.Code:
/mod warn <user> <reason> -
— View a clean embed showing all past warnings for a specific user.Code:
/mod warns <user> -
— Wipes a user's warning slate clean.Code:
/mod clearwarns <user> -
— Uses Discord's native Timeout feature.Code:
/mod timeout <user> <minutes> <reason> -
— Kicks the user and logs it.Code:
/mod kick <user> <reason> -
— Bans the user and logs it.Code:
/mod ban <user> <reason>
Having trouble with the installation? Found a bug? Got a question?
Don't post in the reviews — join our Discord and open a ticket.
We'll get back to you as fast as possible.
