BotGhost Documentation
Support ServerYouTubeMarketplaceBotGhost PremiumSign in
  • Welcome to BotGhost
  • Guidelines & Privacy
  • Changelogs 2025
    • Changelogs 2024
    • Changelogs 2023
  • BotPanel Documentation
  • Getting Started
    • Create Your First Bot
      • Create Your Second Bot
    • Invite Your Bot
    • Standard Practices
      • Advanced Practices
    • Mobile Application (PWA)
  • Support
    • BotGhost Support
    • Frequently Asked Questions
  • Premium & Priority Hosting
    • Priority Hosting
    • Our Premium Features
    • Plans & Payment Methods
    • Manage Your Subscription
    • Upgrade Your Bot
    • Refund & Cancellation Policy
    • Beta Features
  • General Settings and Collaboration
    • Settings
    • Collab
    • Status
    • Active Developer Badge
    • Marketplace
  • Custom Commands & Events
    • Command & Event Builder
      • Sharing Commands and Events
      • Advanced Options
    • Actions
      • Message Actions
        • Send or Edit a Message
          • Button
          • Select Menu
        • Edit a Button or Select Menu
        • Send a Form
        • Delete a Message
        • Publish a Message
        • React to a Message
        • Pin a Message
      • Custom Variable Actions
        • Set Variable
        • Run Equation on Variable
        • Delete Variable
      • API Actions
        • Send an API Request
        • Execute an IFTTT Trigger
      • Loop Actions
        • Run a Loop
        • Stop a Loop
      • Voice Actions
        • Join a Voice Channel
        • Leave a Voice Channel
        • Voice Move a Member
        • Voice Kick a Member
        • Voice Mute or Unmute a Member
        • Voice Deafen or Undeafen a Member
      • Role Actions
        • Add Roles
        • Remove Roles
        • Create a role
        • Delete a role
        • Edit Role
      • Channel Actions
        • Create a channel
        • Edit a channel
        • Delete a channel
      • Thread and Forum Actions
        • Create a Thread
        • Edit a Thread
        • Delete a Thread
      • Server Actions
        • Kick a member
        • Ban a member
        • Timeout a member
        • Change a members nickname
        • Purge Messages
        • Create Server Invite
      • Other Actions
        • Wait before running another action
        • Manipulate some text
        • Send an error log message
        • Set a unique variable
        • Change the Bot's Status
        • Note
      • [LEGACY] Reply Actions
        • Plain Text Reply
        • Embed Reply
        • Random Reply
        • Send a message to a channel
        • Direct Message a User
        • Send a Message with attached buttons
          • Buttons
        • Send a message with a select menu
          • Menu Option
    • Conditions
      • Comparison Condition
      • Permission Condition
      • Chance Condition
      • Channel Condition
      • Role Condition
      • User Condition
      • Premium Check Condition
    • Options
      • Text Option
      • Number Option
      • User Option
      • Channel Option
      • Role Option
      • Choice Option
      • Attachment Option
    • Events
      • Timed Events
      • Webhooks
    • Data Storage
      • Collections
      • Objects
    • IFTTT
    • Variables
  • Server Management
    • Moderation
    • Discord Automod
    • Tickets
    • Welcomer
    • Verification
    • Statistic Channels
    • Modmail
    • Auto-React
    • Sticky Roles
    • Emoji Manager
    • Polls Filter
    • Automod
    • Logging
  • Messages
    • Timed Messages
    • Reaction Roles
    • Autoresponder
    • Embed Builder
    • Sticky Messages
    • Polls
    • Global Chat
    • Media Channels
  • AI
    • ChatGPT
    • Image Generation
  • Game Integrations
    • Roblox Verification
  • Social Integrations
    • YouTube
    • Twitch
  • Community Engagement
    • Leveling
    • Temp Voice Channels
    • Suggestions
    • Invite Tracker
    • Starboard
    • Question Of The Day
    • Giveaways
  • Fun Modules
    • Economy & Minigames
    • Birthdays
    • Counting
  • Utility
    • Translation
    • Weather
Powered by GitBook
On this page
  • Common Issues
  • Roles not being added / removed
  • Users not being muted, kicked or banned
  • Watch the Tutorial
  • Settings
  • Command Settings
  • Visual Settings
  • Behaviour Settings
  • Auto-Punishment Settings
  • Punishments
  • Variables
  • Commands
  • Events

Was this helpful?

  1. Server Management

Moderation

Moderate your server with a set of powerful commands!

Last updated 1 month ago

Was this helpful?

The module allows you to setup a highly customizable moderation system you can create for your server, with warnings, timeouts, auto-punishments and more features.

Common Issues

It is advised that you Enable Moderation Logging to make sure you can see details about possible errors.

Roles not being added / removed

If the /role add, /role remove or /role temp commands are not working, it is likely because the role that you are trying to add or remove is above the bot's role in your server settings. The steps below will most likely solve your issue:

1

Make sure your bot has the administrator permission in your server. You can check this by looking at the permissions from your bot's role.

2

Make sure the bot's role is at the top of the role list. If this is not the case, drag the role to the top.

3

Users not being muted, kicked or banned

If the /mute add, /kick, /ban add or /ban temp command is not working, it is likely because the role of the target user is higher than the role from the bot. You are likely to solve this with the steps below:

1

Make sure your bot has the administrator permission in your server. You can check this by looking at the permissions from your bot's role.

2

Make sure the bot's role is at the top of the role list. If this is not the case, drag the role to the top.

3

Watch the Tutorial


Settings

Command Settings

Default Permissions

If you have this enabled, users with the manage messages permission will be able to use moderator commands. Users with the administrator permission will be able to use admin commands.

Admin Roles

Moderator Roles

Enable Moderation Logging

When enabled, all moderation actions will be logged to a channel.

Moderation Log Channel

Here you can select the channel where you want to log moderation actions. This setting only shows if you Enable Moderation Logging.

Visual Settings

Punishment Color

Here you can select what color that you want to use for punishment messages. Punishment messages are sent to the channel where the punishment has been issued.

Logging Color

Here you can select what colour you want to give to log messages. Log messages are sent to the moderation log channel, if enabled.

Behaviour Settings

Send Direct Messages

Here you can select whether you want to send a direct message to the user that has been punished.

Direct Message

Ban: Delete Messages

Here you can select whether or not you want to delete a user's messages when they have been banned from the server.

Auto-Punishment Settings

Trigger Punishment Type

In this selection, you can select what type of punishment should trigger the auto punishment.

Warnings / Timeouts Needed

This is the number of warnings or timeouts needed before the auto punishment is triggered.

Punishment

Here you can select the type of punishment that a user should get when they reach the amount of warnings / timeouts entered above.

Timeout Duration

To save the punishment's settings, you need to click "Add" in the bottom-right corner of the settings. This will reset the fields so you can set up another punishment.

Punishments

To save the edits you made on the punishment's settings, you need to click "Edit" in the bottom-right corner of the settings.


Variables

Variable
Details

{action}

This variable will show the type of punishment the user got. For example: warn, mute or ban.

{moderator}

This variable will mention the moderator that gave the punishment.

{time}

This variable will show you the timestamp of the moment the punishment was issued.

{case}

This variable will show you the ID of the moderation case.

{reason}

This variable will return the reason for the punishment, this reason was provided by the moderator.


Commands

/ban add

This command allows you to ban a user from the server.

/ban remove

This command allows you to unban a user from the server on ID

/ban temp

This command allows you to temporarily ban a user from the server

/mute add

This command allows you to put a user in time-out

/mute remove

This command allows you to remove a timeout from a user

/role add

This command allows you to ddd a role to a user

/role remove

This command allows you to remove a role from a user

/role temp

This command allows you to temporarily give a user a role, this role will be removed after a selected amount of time

/voice deaf

This command allows you to deafen someone in a voice channel

/voice undeaf

This command allows you to undeafen someone in a voice channel

/kick

This command allows you to kick a user

/case view

This command allows you to get the content of a moderation case

/note add

This command allows you to add a note to a user

/note remove

This command allows you to remove a note from a user

/note view

This command allows you to get the content of a note from a user

/case remove

This command allows you to delete a moderation case

/user history

This command allows you to view the punishment history of a user

/slowmode

This command allows you to enable or edit the slow mode setting of a channel

/user clear-history

This command allows you to clear the punishment history of a user

/warn

This command allows you to warn a user

/ping

This command allows you to get the latency of the bot

/purge

This command allows you to delete up to 100 messages at the same time from a channel

/server-info

This command allows you to get information about the server, such as the server name, member count, description and more

/user nick

This command allows you to change the nickname of a user

/channel lock

This command allows you to change the channel permissions so that no one can send messages anymore

/channel unlock

This command allows you to change the permissions in a channel back so that everyone can send messages again

/say

This command allows you to send a message with the bot.

[👑] Add Command

Events

Moderation Handler
Temporary Role & Ban Check

This command will make sure temporary roles or bans are removed on time.

[👑] Add Event


It's advised that you do not edit the commands and events unless you have a good understanding of BotGhost and its Command Builder. If you encounter any issues, you might want to reset the module for it to work again as intended.

Additionally, a copy of the edited commands / events will be created if you update the module.

Experiencing issues with the module? Check out the common issues below. If your issue is not listed in this page, make sure your module is updated to the latest version. If you are still experiencing issues with the module, join our to ask for further help.

If you're still experiencing issues, join our to ask for further help, we'll do our best to solve your issue!

If you're still experiencing issues, join our to ask for further help, we'll do our best to solve your issue!

Here you can select one or more roles that you want to allow to use admin commands. Admin roles can access commands that are only meant for managing the server. Examples of these are: /role add, /role remove, /role temp and /user clear-history but those may not be all. You can view a list with all commands in .

Here you can select one or more roles that you want to allow to use moderator commands. Moderator roles can only access commands meant for moderating the server, such as: /ban add, /case view and /warn, but those are not all. You can view a list with all commands in .

Here you can edit the message that a user gets after being punished. If the setting above has been disabled, the user will not get any direct message. You can use a set of variables in the direct message, you can read more about that . This setting only shows if the Send Direct Messages setting is enabled.

This is the time a user should be timed out when they trigger an auto-punishment. This setting is only shown if you selected "Timeout User" in the .

Here you can manage your currently active punishments. The same settings as apply. You are able to edit / delete these punishments. A maximum of 10 punishments is present.

Here are some module variables that can be used in .

By clicking the add command button you can create your own command for the moderation module using all the module and settings.

This event will enforce .

By clicking the add event button you can create your own event for the moderation module using all the module and settings.

support server
support server
support server
the commands section
the commands section
here
Punishment settings
Auto-Punishments
the direct message section
variables
the auto-punish settings
variables
Moderation