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.
Updated on
01 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.
02 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 |
03 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).
04 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.
05 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.
06 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
Q. 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.
Q. 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.
Q. 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).
Q. 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.
Q. 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.