Moderation Commands

These commands assist server administrators and moderators in maintaining order and enforcing server rules.

Common Issues (General Moderation):

• Command fails with "Role Hierarchy Error" → The bot's highest role must be positioned higher than the target user's highest role.

• Command fails with "Permission Error" → Ensure the user running the command has the required Discord permission (e.g., Ban Members, Manage Channels).

• Action is not logged → Verify that the Logging System is enabled and configured to track moderation events.

• Cannot ban/kick owner → Discord prevents bots from banning or kicking the server owner.

antiraid

Configure anti-raid protection settings.

Usage:

;antiraid <subcommand> [options]

Parameters:

Name	Type	Required	Description
subcommand	string	Yes	The action to perform (enable/disable/config/status/test/stats).

Permission Required: Administrator

Examples:

;antiraid enable
;antiraid config threshold 5

Notes:

• Use ;antiraid help for a detailed list of subcommands and options.

• Requires Administrator permissions for the user and bot.

ban

Ban a user from the server.

Usage:

;ban <user> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to ban.
reason	string	No	Optional reason for the ban.

Permission Required: Ban Members

Examples:

;ban @User Spamming
;ban 123456789 Breaking rules

Notes:

• The bot requires Ban Members permission.

• Your highest role must be above the target user's highest role.

cwarns

Clear all warnings for a user.

Usage:

;cwarns <user>

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to clear warnings for.

Permission Required: Manage Messages

Examples:

;cwarns @User
;cwarns 123456789

Notes:

• The bot requires Manage Messages permission.

• You cannot clear warnings for users with higher or equal roles.

hardban

Permanently ban a user with no possibility of unban.

Usage:

;hardban <userID>

Parameters:

Name	Type	Required	Description
userID	string	Yes	The ID of the user to permanently ban.

Permission Required: Administrator

Examples:

;hardban 123456789

Notes:

• WARNING: This action is irreversible through normal bot commands. Reversing requires contacting bot support.

• Only the server owner can use this command.

jail

Jail management system.

Usage:

;jail <user> [duration] [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to jail.
duration	string	No	Optional duration for temporary jail (e.g., 1h, 1d).
reason	string	No	Optional reason for the jail.

Permission Required: Moderate Members

Examples:

;jail @User 2h Spamming
;jail list

Notes:

• Use ;jail setup to automatically configure the jail system (creates role and channel).

• Use ;jail list to view all currently jailed users.

kick

Kick a member from the server.

Usage:

;kick <user> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to kick.
reason	string	No	Optional reason for the kick.

Permission Required: Kick Members

Examples:

;kick @User Spamming
;kick 123456789 Breaking rules

Notes:

• The bot requires Kick Members permission.

• Your highest role must be above the target user's highest role.

lock

Lock the channel for @everyone and the most populated role if it has >60% members.

Usage:

;lock [#channel] [reason]

Parameters:

Name	Type	Required	Description
channel	mention	No	The channel to lock. Defaults to the current channel.
reason	string	No	Optional reason for the lock.

Permission Required: Manage Channels

Examples:

;lock #general Maintenance
;lock Raid in progress

Notes:

• The bot requires Manage Channels permission.

lockdown

Lock down all channels in the server.

Usage:

;lockdown [reason]

Parameters:

Name	Type	Required	Description
reason	string	No	Optional reason for the lockdown.

Permission Required: Administrator

Examples:

;lockdown Raid in progress
;lockdown Emergency

Notes:

• The bot requires Manage Channels and Manage Roles permissions.

modlogs

View moderation logs and history.

Usage:

;modlogs <subcommand> [options]

Parameters:

Name	Type	Required	Description
subcommand	string	Yes	The type of log view (server/user/history/stats/search/recent/type).

Permission Required: Manage Messages

Examples:

;modlogs server
;modlogs user @User

Notes:

• Use ;modlogs help for a detailed list of subcommands and options.

modnotes

Add or view moderator notes on users.

Usage:

;modnotes <subcommand> <user> [content]

Parameters:

Name	Type	Required	Description
subcommand	string	Yes	The action to perform (add/view/remove/search).
user	mention/ID	Yes	The user to manage notes for.
content	string	No	The note content or note ID for removal.

Permission Required: Manage Messages

Examples:

;modnotes add @User Warned for spamming
;modnotes view @User

Notes:

• Use ;modnotes help for a detailed list of subcommands and options.

setautomod

Set up automated content moderation rules.

Usage:

;setautomod toggle <filter> [true/false]

Parameters:

Name	Type	Required	Description
filter	string	Yes	The filter to toggle (slurs/swears/invites/links/religion/bypass/hardslurs).
value	boolean	No	Enable or disable the filter (true/false). Toggles if omitted.

Permission Required: Manage Server

Examples:

;setautomod toggle slurs true
;setautomod blacklist add badword

Notes:

• Use ;setautomod help for a detailed list of subcommands and options.

slowmode

Set the slow mode duration of a channel.

Usage:

;slowmode <duration>

Parameters:

Name	Type	Required	Description
duration	number	Yes	The slowmode duration in seconds (0-21600).

Permission Required: Manage Channels

Examples:

;slowmode 10
;slowmode disable

Notes:

• Use ;slowmode disable or ;slowmode off to remove slowmode.

spy

Bans all known spy/bot accounts.

Usage:

;spy

Parameters:

Name	Type	Required	Description

Permission Required: Administrator

Examples:

;spy

Notes:

• This command bans a predefined list of known malicious bot accounts.

tempjail

Temporarily jail a user.

Usage:

;tempjail <user> <duration> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to jail.
duration	string	Yes	Duration of the jail (e.g., 1h, 30m, 1d).
reason	string	No	Reason for the jail.

Permission Required: Ban Members

Examples:

;tempjail @User 1h Spamming
;tempjail 123456789 2d Breaking rules

Notes:

• The bot requires Manage Roles permission.

• Users are automatically unjailed after the duration expires.

timeout

Mute a member for a specified time.

Usage:

;timeout <user> <duration> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to timeout.
duration	string	Yes	Duration of the timeout (e.g., 1h, 30m, 1d).
reason	string	No	Reason for the timeout.

Permission Required: Moderate Members

Examples:

;timeout @User 1h Spamming
;timeout 123456789 2d Breaking rules

Notes:

• The bot requires Moderate Members permission.

triggerword

Manage trigger words for moderation.

Usage:

;triggerword <add/remove/list> <word>

Parameters:

Name	Type	Required	Description
subcommand	string	Yes	The action to perform (add/remove/list).
word	string	Yes	The word to add or remove from the trigger list.

Permission Required: Manage Messages

Examples:

;triggerword add badword
;triggerword list

Notes:

• Use ;triggerword help for a detailed list of subcommands and options.

unban

Unban a user from the server.

Usage:

;unban <user_id> [reason]

Parameters:

Name	Type	Required	Description
user_id	string	Yes	The ID of the user to unban.
reason	string	No	Reason for unbanning the user.

Permission Required: Ban Members

Examples:

;unban 123456789
;unban 123456789 Appealed ban

Notes:

• The bot requires Ban Members permission.

unjail

Release users from jail or temp jail.

Usage:

;unjail <user> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to release from jail.
reason	string	No	Reason for releasing the user.

Permission Required: Ban Members

Examples:

;unjail @User
;unjail 123456789 Served time

Notes:

• The bot requires Manage Roles permission.

unlock

Unlock the channel for @everyone and the most populated role if it has >60% members.

Usage:

;unlock [#channel]

Parameters:

Name	Type	Required	Description
channel	mention	No	The channel to unlock. Defaults to the current channel.

Permission Required: Manage Channels

Examples:

;unlock
;unlock #general

Notes:

• The bot requires Manage Channels permission.

unlockdown

Unlock all channels and restore previous permissions.

Usage:

;unlockdown

Parameters:

Name	Type	Required	Description

Permission Required: Manage Channels

Examples:

;unlockdown

Notes:

• The bot requires Manage Channels permission.

unmute

Unmute a member from the server.

Usage:

;unmute <user> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to unmute.
reason	string	No	Reason for unmuting the user.

Permission Required: Moderate Members

Examples:

;unmute @User
;unmute 123456789 Timeout completed

Notes:

• The bot requires Moderate Members permission.

vanityguard

Manage vanity URL protection for your server.

Usage:

;vanityguard <subcommand> [options]

Parameters:

Name	Type	Required	Description
subcommand	string	Yes	The action to perform (enable/disable/status/set/logchannel/help).

Permission Required: Manage Server

Examples:

;vanityguard enable
;vanityguard set myserver

Notes:

• Use ;vanityguard help for a detailed list of subcommands and options.

voteban

Start a vote to ban a user from the server.

Usage:

;voteban <user> <duration> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to start a vote ban for.
duration	string	Yes	Duration for the vote (e.g., 30s, 5m, 1h).
reason	string	No	Reason for the vote ban.

Permission Required: Ban Members

Examples:

;voteban @User 5m
;voteban 123456789 2m Breaking rules

Notes:

• The bot requires Ban Members and Add Reactions permissions.

warn

Warn a user for breaking server rules.

Usage:

;warn <user> [reason]

Parameters:

Name	Type	Required	Description
user	mention/ID	Yes	The user to warn.
reason	string	No	Reason for warning the user.

Permission Required: Manage Messages

Examples:

;warn @User Spamming in chat
;warn 123456789 Inappropriate behavior

Notes:

• The bot requires Manage Messages permission.

warns

Check warns a user has.

Usage:

;warns [user]

Parameters:

Name	Type	Required	Description
user	mention/ID	No	The user to check warnings for. Defaults to yourself.

Permission Required: Manage Messages

Examples:

;warns
;warns @User

Notes:

• The bot requires Manage Messages permission.