This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

Mod Commands

All manual moderation commands. Permissions are checked at the Discord level (Moderate Members / Manage Guild / Administrator).

---

/mod

Command	Permission	Function
/mod warn <user> <reason>	Moderate Members	Issue a warning — gets a P-# ID, counts toward escalation
/mod note <user> <note>	Moderate Members	Staff note without punishment — shows up in /mod history
/mod kick <user> [reason]	Kick Members	Kick a member
/mod ban <user> [reason] [delete-days]	Ban Members	Ban a member (optional: delete 0–7 days of messages)
/mod softban <user> [reason] [delete-days]	Ban Members	Kick + message cleanup (ban+unban combo)
/mod mute <user> <duration> [reason]	Moderate Members	Discord timeout (max 28 d)
/mod unmute <user>	Moderate Members	Remove timeout
/mod unban <user-id> [reason]	Ban Members	Unban a user by their Discord ID
/mod unwarn <id>	Manage Guild	Mark a P-# warning as inactive
/mod history <user>	Moderate Members	Full punishment history
/mod clear <count>	Manage Messages	Delete 1–100 messages in the current channel
/mod reload	Manage Guild	Reload mod.yml

Important: You can only moderate users who have a lower rank than you. The bot checks this automatically.

---

/mod history @user

Shows all punishments for a user (warns, notes, kicks, bans, mutes, softbans), newest first.

• 🟢 = active (counts toward escalation)
• ⚫ = inactive

Each entry contains the P-# ID, date, moderator, and reason.

---

/report

/report <user> <reason>

Public command — any member can report another user to the mods.

Parameter	Description
user	Who is being reported
reason	Required — what happened

• Cooldown: 5 min between reports
• Limit: 3 reports per day
• Mods/Admins cannot be reported
• The report is posted to the configured mod-log channel

Permission: All members

---

/botstatus

Shows a compact status embed:

• Uptime, WebSocket ping, roundtrip latency
• Memory (RSS / heap)
• Status of all modules (welcome / mod / tickets / news)
• Ticket statistics (open / closed / total)
• Punishment statistics

Permission: Manage Guild

---

Server Audit Logger (no command)

The bot automatically logs a wide range of server events to the mod-log channel:

• Channels: create / delete / update (including voice channels created / deleted by /voice)
• Roles: create / delete / update
• Members: role add/remove, update, kick, ban, unban
• Profile: nickname, username, display name, avatar
• Other: invite, webhook, emoji (create/delete), message delete, message bulk delete

Voice channels from the Join-to-Create system appear normally in the channel logs — the executor is the respective owner. More details in GrumpyVoice-EN.

→ More in GrumpyMod-EN

---

Duration Format

For /mod mute:

Input	Meaning
30s	30 seconds
5m	5 minutes
2h	2 hours
1h30m	1 hour 30 minutes
7d	7 days
60 (number without unit)	60 minutes