Community & management
Moderation & Automod
Ganyu covers the whole moderation chain: manual sanctions, tracked warnings, finely configurable auto-moderation and detailed logs of everything happening on the server. Every action requires the matching Discord permission and stays browsable in the The web dashboard.
By the Ganyu team Updated on
Sanctions
Four types of sanctions are recorded and tracked: ban, mute (timeout), kick and warn. Each one keeps a reason, the author and, where relevant, an expiry date. Timed sanctions (temporary ban, mute) are automatically lifted by the bot when they expire.
/ban <member> [reason] [delete_days] [duration] Bans a member. delete_days purges messages from the last N days (0 to 7); duration turns the ban into a temporary ban (e.g. 7d, 12h), lifted automatically when it expires.
/unban <user_id> [reason] Revokes a ban from the member's ID.
/kick <member> [reason] Kicks a member from the server (they can come back via an invite).
/mute <member> <duration> [reason] Applies a Discord timeout. duration is expressed in minutes (1 to 40320, i.e. the 28-day maximum imposed by Discord).
/warn add <member> <reason> Adds a warning. The reason is mandatory.
/warn list <member> Shows a member's warning history.
/warn remove <member> <number> Removes a specific warning (by its number in the list).
Tip — Set up warning thresholds in the dashboard to trigger an automatic sanction (mute, kick, ban…) once a member reaches a certain number of warns: 5 rules on FREE, 20 on PREMIUM, 100 on PRO.
Required permissions
Each command requires the appropriate native Discord permission — no need to create a special "moderator" role, Ganyu aligns with your existing permissions:
| Command | Required Discord permission |
|---|---|
| /ban, /unban | Ban Members |
| /kick | Kick Members |
| /mute, /warn | Timeout Members |
| /clear | Manage Messages |
| /lockdown, /unlock | Manage Channels |
| /role | Manage Roles |
| /ghostping | Mention @everyone |
Channels, roles and quick tools
/clear <amount> [user] [scope] Bulk-deletes messages. user filters a specific member; scope is channel (the current channel) or server.
/lockdown [reason] Locks the current channel in an emergency (prevents sending messages).
/unlock [reason] Unlocks the channel.
/role give <role> <member> Gives the role to the member, or removes it if they already have it (toggle).
/role all <role> [action] [ignore_bots] Applies a role to the whole server. action is grant or remove; ignore_bots excludes bots from the operation.
/ghostping Detects ghost pings (mentions sent and then deleted).
Auto-moderation
Automod automatically filters messages using up to 11 rules that can be toggled independently from the Automod tab of the The web dashboard. Each rule has its own exemptions (whitelisted channels and roles), on top of the global exemptions (roles/channels that bypass every rule). Configurable rule count: 10 on FREE, 25 on PREMIUM, 200 on PRO.
| Rule | What it filters | Main settings |
|---|---|---|
| Banned words | List of banned words/phrases | Word list |
| Links | Unauthorized URLs | Allowed domains, GIF exemption |
| Invites | External Discord invites | Allowed servers |
| Spam | Messages sent too fast | Max count / time window |
| Caps | Messages shouted in CAPS | Max % of caps, minimum length |
| Mentions | Mass pinging | Max mentions, role mentions, @everyone block |
| Emojis | Emoji overload | Max number of emojis |
| Line breaks | Vertically stretched messages | Max number of line breaks |
| Duplicates | Identical repeated messages | Time window |
| Photo/Video only | Media-only channels | Affected channels |
| Zalgo | Glitched text (combining marks) | Max %, minimum length |
Tip — The Links, Mentions and Photo/Video rules are among the most useful: whitelist your own domains and sharing channels before enabling sanctions.
Escalating automod sanctions
Instead of a single response, you define an escalation ladder triggered by the number of accumulated infractions. The available actions are: warn, delete (delete the message), timeout (mute, with a duration in minutes), kick and ban.
An infraction decay setting lets you forget old infractions after a delay, and the resetOnSanction option resets the counter once a sanction is applied. Every infraction is logged.
Server logs
The logging module records server events (deleted/edited messages, joins and leaves, sanctions, role changes…) in the channels of your choice. Retention: 30 days on FREE, 90 on PREMIUM, 365 on PRO — see Premium.
Tip — Player Premium includes /antimove, personal protection against being force-moved in voice (toggled on/off with a true/false state).
Frequently asked questions
How do I make a temporary ban?
Add the duration option to /ban (e.g. 7d for seven days, 12h for twelve hours). Ganyu automatically lifts the ban when it expires; without this option, the ban is permanent.
What is the maximum mute duration?
28 days (40320 minutes), the timeout system limit imposed by Discord. The duration is expressed in minutes in the duration option.
Do warnings trigger automatic sanctions?
Yes, if you set up thresholds in the dashboard: after N warns, Ganyu can automatically mute, kick or ban. The number of rules depends on the tier (5 / 20 / 100).
Can automod ignore moderators?
Yes. Each rule has its own whitelists of roles and channels, and you can define global exemptions that bypass every rule for your staff.
Where can I find the sanction history?
Every sanction (ban, mute, kick, warn) is tracked and browsable in the dashboard, along with its reason, its author and its possible expiry date.
Do I need a moderator role to use Ganyu?
No. Every command relies on the matching native Discord permission: /ban needs Ban Members, /clear needs Manage Messages, /lockdown needs Manage Channels. Your existing role hierarchy is enough, there is nothing to recreate.
How do I block links and Discord invites?
Turn on the Links and Invites rules in the Automod tab of the The web dashboard. The first one only allows the domains on your whitelist and can let GIFs through, the second blocks invites to other servers except the ones you allow.
How do I delete several messages at once?
/clear <amount> bulk-deletes messages in the current channel. The user option limits the purge to one member and the scope option extends it to the whole server instead of the single channel.
How do I lock a channel during a raid?
/lockdown immediately stops messages in the current channel and /unlock reopens it. Both need the Manage Channels permission and accept a reason, which lands in the logs.
How many automod rules can I enable?
Automod ships 11 rule types. You can configure 10 on FREE, 25 on PREMIUM and 200 on PRO, each with its own exempt channels and roles.
Can automod escalate its sanctions?
Yes. You define a ladder triggered by the number of accumulated infractions, among warn, delete, timeout, kick and ban. A decay setting forgets old infractions after a delay, and resetOnSanction clears the counter as soon as a sanction lands.
How long are moderation logs kept?
30 days on FREE, 90 days on PREMIUM and 365 days on PRO. The sanctions themselves stay in the dashboard history with their reason, their author and any expiry date.
Sources and official documentation
Community & management
Ready to try Ganyu?
Add Ganyu to your Discord server for free and put this guide into practice in under a minute.
Add Ganyu for free