Moderation Commands Guide (YAGPDB)¶

This guide provides a comprehensive list of all moderation commands available through the YAGPDB bot.

Command Prefix and Syntax

The command prefix is -.
<User>: The user you want to action (@mention or User ID).
<Duration>: The length of time for the action (e.g., 10m, 2h, 7d).
<Reason>: The reason for the moderation action. This is logged for team reference.
[...]: Brackets indicate an optional parameter.

Member Punishment Commands¶

These commands are for applying disciplinary actions to users.

Command & Aliases	Description	Basic Usage
`-ban` `-banid`	Permanently or temporarily bans a user.	`-ban <User> [Duration] [Reason]`
`-kick`	Removes a user from the server. They can rejoin immediately.	`-kick <User> [Reason]`
`-mute`	Prevents a user from speaking in text or joining voice channels.	`-mute <User> [Duration] [Reason]`
`-timeout` `-to`	Prevents a user from interacting in the server for a set duration.	`-timeout <User> <Duration> [Reason]`

Punishment Command Examples

-ban @User#1234 7d Repeatedly breaking rule 2.1
-kick 123456789012345678 Disrupting voice chat
-mute @User#1234 2h Please cool down
-timeout @User#1234 10m Spamming

Advanced Ban Option: Deleting Messages

When banning a user, you can delete their recent message history by adding the -ddays flag. You can specify a range from 0 to 7 days.

Example: -ban @User#1234 -ddays 7 Raiding the server

Reversing Punishments¶

These commands are used to lift active punishments from a user.

Command & Aliases	Description	Basic Usage
`-unban` `-unbanid`	Unbans a user, allowing them to rejoin the server.	`-unban <User ID> [Reason]`
`-unmute`	Removes a mute from a user.	`-unmute <User> [Reason]`
`-removetimeout` `-rto` / `-untimeout`	Removes an active timeout from a user.	`-removetimeout <User> [Reason]`

Reversal Command Examples

-unban 123456789012345678 Successful appeal
-unmute @User#1234 Mute served

Warning System Commands¶

Use these commands to issue and manage user warnings.

Command & Aliases	Description	Basic Usage
`-warn`	Issues an official warning to a user, which is logged by the bot.	`-warn <User> <Reason>`
`-warnings` `-warns`	Displays a list of all warnings a specific user has received.	`-warnings <User>`
`-editwarning`	Edits the text of a previously issued warning.	`-editwarning <Warning ID> <New Reason>`
`-delwarning` `-dw`	Deletes a specific warning by its ID.	`-delwarning <Warning ID> [Reason]`
`-clearwarnings` `-clw`	Deletes all warnings for a specific user.	`-clearwarnings <User> [Reason]`
`-topwarnings` `-topwarns`	Shows a server-wide leaderboard of users with the most warnings.	`-topwarnings`

How do I find a Warning ID?

Run the -warnings <User> command. The ID is the number listed next to each warning entry.

Channel & Utility Commands¶

These commands are for channel management and general moderation tasks.

Command & Aliases	Description	Basic Usage
`-clean` `-clear` / `-cl`	Deletes a specified number of recent messages in a channel.	`-clean <Number of Messages>`
`-report`	Creates a formal report about a user for the staff team.	`-report <User> <Reason for Report>`
`-reason`	Adds or edits the reason for a moderation action in the modlog.	`-reason <Message ID> <New Reason>`

Advanced -clean Usage

The -clean command is very powerful and can filter messages. - Clean messages from a specific user: -clean <User> <Number> - Clean messages with attachments only: -clean 100 -a - Clean while ignoring pinned messages: -clean 50 -nopin