Moderation (rewrite)

Staff Handbook

This page is used for quick command references for mods and helpers for moderating and keeping their community safe. For more details on the commands, please see relative pages for each of the modules/sections.

 


 

 

General Moderation

These commands are for the majority of the basic moderation commands ranging from warns to bans, and even voice chat tools.

 

Warns

Command

Descriptive Example

!warn member [reason]

!warn @yeetmaster#3000 Not sharing popcorn

 

- Warns the person

!bulkwarn WarnedUserID % Moderator % Reason
Warned User % Moderator % Reason
Warned User % Moderator % Reason

!bulkwarn 507121360831234530 % 507121360833609730 % trolling
507121360812349730 % 507121360833612730 % trolling
512341360812309730 % 512321360833609730 % trolling
507121123123609730 % 507121360833612330 % trolling

 

- Sends a warning to multiple people

- This must be used in this syntax or it will not work as intended

!rewarn warnID/member [New reason here]

!rewarn 638 Did not share popcorn

 

- Updates the reason for an existing warning

!warnlist member

!warnlist @Yeetmaster#3000

 

- Displays all the warnings the person has

!warnlist reason search text

!warnlist reason yeet

 

- Displays all warnings with the specified text

!warnlist mod member

!warnlist mod @ModGod#3000

 

- Displays all warnings the mod has sent

!warnlist all

!warnlist all

 

- Displays all warnings in your server

!pardon WarnID

!pardon 68

 

- Pardons the warn

 

Mutes

Command Descriptive Example

!mute member [time] [reason]

!mute @yeetmaster#3000 999999999d No

 

- Mutes the person

- Time length types: 1d 1h 1m 1s

!unmute member

!unmute @yeetmaster#3000

 

- Unmutes the person

!mutelist

!mutelist

 

- Displays all active mutes in the server

 

Kicks

Command Descriptive Example

!kick member [reason]

!kick @yeetmaster#3000 Not sharing popcorn

 

- Kicks the person from the server

!kick member member [reason]

!kick @yeetmaster#3000 @yettmaster#3001

 

- Kicks multiple people

!softban member [reason]

!softban @yeetmaster#3000 telling movie spoilers

 

- Kicks a person and clears their messages from today

 

Bans 

Command Descriptive Example

!ban mention/UserID reason

!ban @yeetmaster#3000 Not sharing popcorn

 

- Bans the person from the server

!unban username

!unban 356436845136545

 

- Unbans the person from the server

!tempban mention/UserID time reason

!tempban @yeetmaster#3000 3d 2m 1s Not sharing

 

- Temporarily bans someone from the server

- Time length types: 1d 1h 1m 1s

!tempbanlist

!tempbanlist

 

- Lists all active temporary bans in the server

!allbans

!allbans

 

 

- Lists all active bans in the server

 

Voice Chat Tools

Command

Descriptive Example

!vcmute member [time]

!vcmute @yeetmaster#3000 Popcorn noises

 

- Voice mutes the person for X minutes

!vcunmute member

!vcunmute @yeetmaster#3000

 

- Voice unmutes the person

!vckick member

!vckick @yeetmaster#3000 @yeetmaster#3001

 

- Kicks user(s) from the voice channel

 


 

 

Message Moderation

These commands will help keep your community walls, boards, floors, and chats clean, calm, and collective.

 

Purger

Command Descriptive Example

!purge amount 

!purge 10

 

- Deletes the amount of messages

!purge amount @mention

!purge 10 @yeetmaster#3000

 

- Deletes the amount of messages from the person

!purge amount @role

!purge 10 @Troll Role

 

- Deletes the amount of messages sent by anyone with the role

!purge amount text

!purge 10 yeet

 

- Deletes the amount of messages with that text/letter

 

Slowmode

Command Descriptive Example
!slowmode

!slowmode

 

- Displays all current slowmode settings

!slowmode server off/number

!slowmode server 5

 

- Sets slowmode in the entire server to 5 seconds

!slowmode channel off/number

!slowmode #general 5

 

- Sets slowmode in a certain channel to 5 seconds

 

Channel Locks

Command Descriptive Example

!lock

!lock

 

- Disables @everyone perms to talk in that channel

!lock light role

!lock light @Troll Role

 

- Locks the channel to a certain role

!unlock

!unlock

 

- Re-enables @everyone perms to talk in that channel

!freeze

!freeze

 

- Removes all channel permissions

- Disables @everyone perms to talk in that channel

 

Do not ever use this command a second time in a row.

This command requires administrator before and during freeze and thaw or else channel permissions will not be properly restored.

!thaw

!thaw

 

- Restores the server to its previous state

The warning above is a requirement in order to properly restore the server to its previous state before the freeze command was made.

 


 

 

Verification Moderation

There is only one command which provides a powerful means to help a newcomer with their verification woes.

 

Manual Verification

Command Descriptive Example
!manualverify member

!manualverify @yeetmaster#3000

 

- Manually verifies a person into the server

 


 

 

Ticket Moderation

These commands enable the staff to manage and moderate the modmail or tickets in the community. The send command is a public command that anyone can use.

 

Ticket Moderation

Command  Descriptive Example
!send

!send

 

- Sends a completely private ticket to the server staff

THIS IS A PUBLIC COMMAND. ANYONE CAN USE IT.

!assign userID ticketID

!assign userID ticketID

 

- Opens the ticket and assigns it to the staff

!unassign userID ticketID

!unassign userID ticketID

 

- Unassigns a staff from the ticket

!closeticket ticketID

!closeticket ticketID

 

- Closes and marks the ticket as done and deletes the channel
- If requested, creates a full dump of the channel

!ticketstatus ticketID

!ticketstatus ticketID

 

- Displays the ticket status

!blockticket userID

!blockticket userID

 

- Prevents that user from sending tickets

!unblock userID

!unblock userID

 

- Re-allows that user to send tickets

 


 

 

Information Gathering

These commands help you gather publicly available information about a user, role, or channel, which can be helpful in making moderation decisions or working with a configuration setup.

 

General Information

Command

Descriptive Example

!getid channel/role/member

!getid #server-news

 

- Displays the ID of whatever was mentioned

!user member

!user @yeetmaster#3000

 

- Displays detailed information about a user

!get member

!get 507121360833609730

 

- Displays basic public information on a person

!rapsheet member

!rapsheet @yeetmaster#3000

 

- Displays a person's punishment history

!roleinfo role

!roleinfo @Troll Role

 

- Displays detailed information about a role

!guildinfo

!guildinfo

 

- Displays detailed information about the server

 


 

 

Name Moderation

Only one command for managing the nicknames of people with less tasteful, hard to read, or harmful names.

 

Nicknames

Command Description
!nick member newNickname

!nick @yeetmaster#3000 I don't share popcorn

 

- Changes a person's display name

 


 

 

Utilities

The say command is a powerful tool for adding embedded messages, sending messages through the bot, or having a little fun.

 

Say Command(Sending Messages with Gaius)

Command Description
!say [optional #channel] Message here.

!say Please share popcorn on movie night!

 

- Sends a plain text in the channel

!say [optional #channel] %e Message here.

!say #important-messages %e Please share popcorn on movie night!

 

- Sends an embedded message

!say [optional #channel] %e %c#000000 Message here.

!say #important-messages %e %c#FFFFFF Please share popcorn on movie night!

 

- Sends an embedded message with a color hex tag 

 

 

Voice Chat Tools

The voice chat tools available with Gaius to mute unwanted or harmful voice communications, to take them out of the voice channel altogether. 

 


 

 

 

Commands

 

Vckick

Vckick can simply kick someone out of a voice channel if that's what you prefer, however vckick has a few other options available for making a more complex action in one command.

Vckick's role function is a powerful moderation booster to help keep unruly people our of your voice channels and maintain a safer and cleaner environment for your fellow members to relax in. If your community has a special role that your members earn from activity or trust and that the role is designed for voice channel permissions, then it would remove the earned privilege from the person who broke the trust. This is done permanently.

Required Permissions (Staff)

Move Members
Manage Roles (Mod)

Examples

Command

Descriptive Example

!vckick [mine/channel] [role]

!vckick mine

 

- Kicks everyone out of your current voice channel


!vckick AFK @ExpBoosting

 

- Kicks everyone out of the vc and removes the role from them

!vckick member

!vckick @yeetmaster#3000

 

- Kicks the person from the voice channel

 

Vcmute/Vcunmute

These 2 are very simple commands designed to be like the regular mute and unmute commands, except for voice channels and without using roles. Gaius will simply apply the Server Mute function on the user so that they cannot speak or unmute themselves in your voice channels. It's a handy tool for the harmful, super awkward, or uncomfortable speakers or spammers.

Required Permissions (Staff)

Mute Members (Mod)

Examples

Command

Descriptive Example

!vcmute member [#w #d #h #m #s] [reason]

!vcmute @yeetmaster#3000 Demanding more popcorn

 

- Voice mutes the person permanently


!vcmute @yeetmaster#3001 52w Evading voice mute

 

- Voice mutes the person for a period of time.

Time format is explained below:

W = Week
D = Day
H = Hour
M = Minute
S = Second

!vcunmute member [reason]

!vcunmute @yeetmaster#3000 Donated popcorn to charity

 

- Unmutes the person from voice channels, allowing them to speak

 


 

 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. Will vckick keep from from coming back into the voice channel, like a ban from voice channels?

- Not in the basic sense but it is possible with the [role] function. If the vckicked person is actually a botted account, they are likely not going to try to rejoin anyhow. If it's an actual human, they might try to join back if they so choose to unless they did not have permission to join the voice channel in the first place.

- It would help to vcmute an unruly speaker as a substitute.

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)

 

 

Panic Mode

The configuration features for automated panic mode is reserved for Gaius Plus only. Learn more

Setting up Panic Mode

There is only one command to the panic mode feature. This is a fairly simple and straightforward tool that helps monitor and detect raids to your configurations and takes action upon panic mode being triggered. 

Panic

This is the only command for the panic mode function. Premium users have the freedom to make it as strict as allowable or a relaxed as allowable to use what fits best for their community. Communities with higher traffic might need to have a more relaxed system to better detect anomalies, while slower moving servers can use the stricter settings. Configuring the settings for users and settings in the command is currently only available for Gaius Plus users.

Gaius has to have Manage Roles permission or else panic mode will not work.

Required Permissions (Staff)

Manage Roles (Admin)

Examples

Command Description
!panic current

!panic current

 

- Displays the current panic mode settings

!panic on/off

!panic

 

- Toggles panic mode


!panic on

 

- Turns panic mode on


!panic off

 

- Turns panic mode off

!panic auto on/off

!panic auto

 

- Toggles automated panic mode


!panic auto on

 

- Turns automated panic mode on


!panic auto off

 

- Turns automated panic mode off

!panic users number

!panic users 10

 

- Sets the number of server joins required to trigger panic mode

This feature is reserved for Gaius Plus only. Learn more

!panic seconds number

!panic seconds 12

 

- Sets the number of seconds needed between joins to increase the trigger number

This feature for is reserved for Gaius Plus only. Learn more

 


 

 

What Do the Numbers in the Last Two Rows Above Mean?

Using the example above, the users is set to 10 and the seconds is set to 12. If we were to say 10 people must join the server within 12 seconds, then that would be incorrect. The time is not based on only the first person who joined; it is based on the previous person who joined the server. 

To help clarify this, let's consider users to simply be a number, only a number.

If Sarah (1) joins the server, the number becomes 1. If 12 seconds has passed by and John joins at 13 seconds after Sarah (1), then Sarah is no longer counted, and John becomes 1. So the triggered number is staying at one.

If Josh (2) joins 6 seconds after John (1), the number is 2. If 12 seconds pass and no one else joined after Josh, then the number goes back to 0. No raid has been detected.

If one troll joins the server, and then another troll joins after 2 seconds, the number is 2, then 8 more join in less than 5 seconds between each join, the number jumps to 10, and causes Gaius to trigger the automated panic in the server. This is because there were 10 people who joined the server with less than 12 seconds between each join.

 


 

 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. Can I customize my panicd role?

- Sure! Roles are remembered by ID, so changing the name and color shouldn't affect performance.

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)

 

 

Channel Management

These commands allow you to have some control over some channels and keep out unwanted or unwelcomed guests.

 

Lock/Unlock

REQUIRED PERMISSIONS:
Manage Channels
Manage Permissions

Locks are small "freezes" that simply disables @everyone's ability to speak in the channel. This is useful in situations where reporting is needed for serious raids or trolls who have sent some malicious content. 

Lock light allows you to keep certain people from speaking while keeping the channel free and available to your regulars or trusted members, which is useful for countering raid and trolls if you have a role designed for every newcomer in your community.

Commands

Command Descriptive Example
!lock

!lock

 

- Locks the channel from everyone

!lock light [channel] [role]

!lock light @Troll Role

 

- Locks the current channel from the specified role


!lock light #general @Troll Role

 

- Locks the specified channel from the specified role

!unlock light [channel] [role]

!unlock light @Troll Role

 

- Unlocks the current channel from the specified role


!unlock light #general @Troll Role

 

- Unlocks the specified channel from the specified role

!unlock

!unlock

 

- Unlocks the channel for everyone

 


 

 

Freeze/Thaw

This feature is reserved for Gaius Plus only. Learn more.

REQUIRED PERMISSIONS:
Administrator
Manage Channels
Manage Permissions

Freeze the server by denying everyone permission to speak or add reactions, for after raid clean up and mid-raid stopping. Thaw a server from "freeze" restoring all previous permissions that were present before the freeze. A channel thaw is possible in cases in which there are channels that are okay for community members to talk in while a freeze is on place. Thawing roles and individual people are also possible with the thaw command.

If something goes wrong with your permissions or if you would like to go back to a certain "thaw" point because some perms were lost or wrong after another thaw, you can thaw recover the server to a certain point. Please note that you will not have any recoveries available during your first freeze because the server has not been thawed for its first time. Every server thaw will save a snapshot of permissions for the channels involved and give it a unique ID (timestamp). If you are uncertain of the timestamp, you can simply say thaw recover, and you will be given the list of currently available timestamps to choose from.

Staff

Command Descriptive Example
!freeze

!freeze

 

- Freezes all channels from all non-admins

!thaw recover [timestamp]

!thaw recover [timestamp]

 

- Recovers an old backup of previously saved permissions

The timestamp is a unique ID generated every time a server is frozen and then thawed.

You will not have any recoveries available during your first freeze.

!thaw channel/role/member

!thaw #general

 

- Restores the specified channel's permissions for everyone


!thaw @Moderator

 

- Restores the specified role's ability to see channels and speak in the server


!thaw @TrustySteed#3000

 

- Restores the specified person's ability to see channels and speak in the server

 


 

 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. Why can't a see my timestamps?

- Timestamps are only made after each time a server thaw has been made, so no timestamp will be available during the first ever server freeze.

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)

 

 

SmartPrune

 

SmartPrune checks for and removes either people in your server currently missing a profile picture, or avatar, or invites that have been used less than a certain number of times. If you don't want people to know why they have been pruned from your server, you can say nomessage at the end of the command. This will tell Gaius not to send a message about why the pruned members were removed.

Examples

Command Descriptive Example
!smartprune avatar [nomessage]

!smartprune avatar

 

- Kicks everyone who doesn't have a profile image

REQUIRED PERMISSIONS: 
Kick Members

!smartprune norole [nomessage]

!smartprune norole nomessage

 

- Kicks everyone who does not have a role

REQUIRED PERMISSIONS: 
Kick Members

!smartprune invite uses

!smartprune invite 5

 

- Deletes all invites used less than a certain number times

 


 

 

FAQ

 

Q. Will kicking Gaius reset the bot?

- No, kicking/banning Gaius will never reset your settings or prefix.

Q. Can I use smartprune for inactive people?

- This is not currently a feature. The best possible alternative is to use Discord's prune feature for people, however this will only prune people who have not logged into Discord for a certain period of time (including people with certain roles).

Q. How do I see all the commands?

- The help command is man's best friend (not dogs).

 

 


 

Video

Not yet available

If you have or find a video on Gaius specifically for what is covered in this documentation page, you can send the info to Fairy 狐 紫#0001 via DM (You must be in the support server in order to make contact).

 


 

Points of Interest

Staff Handbook
Bot Logging/Exlog
Verification Module
Anti-Spam Protection
Wordlist Filtering

 

(Top of Page)