Welcome to the documentation for MoonlightBot! MoonlightBot is a powerful moderation bot for Discord with a focus on user-friendliness and efficiency. It's simple to use and easy to set up, and is run and maintained entirely by volunteers. This documentation will teach you everything you need to know to use MoonlightBot to its fullest potential.
First, add MoonlightBot to your server using this invite link. It is recommended (but not required) that you grant all requested permissions to ensure all features work correctly.
{% hint style="info" %} You can only add bots to servers in which you have the Manage Server permission. {% endhint %}
Once you've added MoonlightBot to your server, you can verify that it's working by using the /ping command.
The output of the /ping command
Join our support server, this is optional but highly recommended: https://discord.gg/hNQWVVC
If this is your first time using MoonlightBot, you'll receive a Direct Message welcoming you to the bot and providing several recommendations, including reading the Acceptable Use Policy. Please read this carefully, as a violation of the Acceptable Use Policy can result in you being banned from using the service.
The beginning of the introductory guide DM. The rest of the message continues explaining the introductory activities.
We also suggest that you review the Moderation Tutorial and share it with your server moderators and administrators once you've finished the configuration.
MoonlightBot supports multiple languages for its commands and responses, and can be set server-wide or per-user. Set your server's language using
/config settings locale:LANG
For your personal user language use
/userconfig settings locale:LANG
LANG is the language you want MoonlightBot to respond in.
A list of supported languages is available on the Discord's official list; Locale, Language Name, and Native Name are all valid inputs. Alternatively, auto can be used for MoonlightBot to detect your preferred language from your Discord settings.
{% hint style="info" %} MoonlightBot is translated entirely by volunteers, so not all languages are complete or not yet translated at all. Incomplete and missing translations will be shown in English. If you would like to help us with your native language, please consider translating it for us! {% endhint %}
MoonlightBot provides easy and dynamic role management by staff and members alike, including Reaction Roles. It can precisely execute actions after a specified amount of time.
- A role can be temporarily added with
/temprole, when someone joins the server, or in many other ways - A role can be temporarily removed with
/pause-role - All active temporary roles can be listed with
/list-temproles - Roles added to members can be automatically detected to be made temporary using the
detect-assignmentconfig option
You can also permanently assign or remove any role to a user with /role, or setup Reaction Roles and let members give themselves configured roles with /selfrole
MoonlightBot uses Discord's built-in permissions system to control who is and is not able to execute certain commands. Some commands have required permissions set by default, and overrides for specific members and roles can be applied to any and all commands.
To set up permissions properly, please follow the Permission Tutorial.
MoonlightBot offers highly granular logging, and can log all kinds of actions to one or more channels. To enable and configure logging for a specific channel, use the command
/config channels channel:LOG-CHANNEL logs:Open editor
where LOG-CHANNEL is the channel you want logs posted to.
An editor will open where you can enter items or categories from the list of log names, or an asterisk (*) to log everything. The list of items and categories to log should be separated by commas and spaces, like so: BAN, KICK, Members
The modal to edit logs. This will soon be replaced with an innovative system
MoonlightBot can mute members both temporarily and permanently. Use the command
/create-muterole [role]
to set up a permission-restricted mute role. Specifying the role option allows you to set up an existing role, or you can leave it out to create a new @Muted role.
Result of the /create-muterole command
You will now be able to use /mute, /tempmute, and /unmute.
Evasion bans are a fallback moderation feature to ensure muted members cannot abuse improperly configured permissions by escalating a mute punishment to a harsher ban.
If a user with your server's mute role sends a message in a channel, they will be banned. To enable evasion bans, use the command
/config settings mute-evasion-ban:True
All channels will now be monitored for new messages sent by muted members. To create exceptions to the evasion ban and allow muted members to talk in specific channels, use
/config channels channel:IGNORED-CHANNEL ignore-mute-evasion-ban:True
where IGNORED-CHANNEL is the channel you want ignored. Ignoring a channel will also ignore threads under the channel.
When an evasion ban is triggered, a BAN event can be logged.
A mute evasion ban being logged looks like this
{% hint style="info" %} Evasion Bans can be set up with MoonlightBot Premium. If you think this feature can help you, vote for MoonlightBot to earn an infinitely extendable subscription or support us in other ways. {% endhint %}
MoonlightBot is run and maintained by volunteers, and is funded entirely by Premium Subscriptions. These subscriptions help us fund hosting and give you great benefits, making them a fantastic way to support us.
You can also help by upvoting the bot or by joining our team of testers, translators, and documentation writers. Yes, the contents of this documentation are work of volunteers, too!
Our strong point is listening to our users' suggestions. If you have an idea for something that can help your server's moderation, we will gladly listen and consider. Users can vote on suggestions to decide what to prioritize. All of this is done in MoonlightBot's support server.
Please read the Frequently Asked Questions first to see if your question or problem is answered there. If your question or problem is still unanswered, join the support server and we will help you as best we can!