MoonlightBot Documentation
Last updated
Last updated
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 it to its fullest potential.
First, add the bot to your server using . It's recommended (but not required) that you grant it all permissions it requests, so all its features will work correctly.
Once you've added it to your server, you can verify that it's working by using the /ping command, which simply checks the bot's latency.
The bot can assign and remove specified roles to a user temporarily.
MoonlightBot offers configurable logging, and can log several kinds of actions to one or more channels. To enable and configure logging for a specific channel, use the command
where LOG-CHANNEL is the channel you want logs posted to.
MoonlightBot can mute users both temporarily and permanently. To use mute features, use the command
to automatically create a mute role with the correct permissions. You can specify a role to be used, or leave it blank and the bot will automatically create a new role.
MoonlightBot supports multiple languages for its commands and responses. This can be set globally for the server, or specifically for you. You can set this by using
for server-wide configuration, or
for user-specific configuration, where LANG is the language you want MoonlightBot to respond in.
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 . Please read this carefully, as a violation of the Acceptable Use Policy can result in you being banned from using the service.
We suggest that you also review the and share it with your server moderators and administrators following the configuration of the bot.
You can assign or remove a temporary role to a user with
All temporary roles currently active in the server can be listed with
You can permanently assign or remove any role to a user with
Users can assign and remove selected roles to themselves with
You also have the option of using in place of the /selfrole command
A role assigned to a user can automatically be changed to a temporary role with the
Any role assigned to a user can also be temporarily removed with
MoonlightBot uses Discord's built-in permissions system to configure who should and should not be able to execute certain commands. Some commands have required permissions set up by default, and all commands can have permissions overridden for specific roles or users. To set up permissions properly, follow the .
It will ask you for the log actions, and you can enter your choice of items or categories from the or simply enter an asterisk (*) to log everything. The list of items and categories to log should be separated by commas and spaces, like so: BAN, KICK, USER_JOIN, USER_LEFT
You should now be able to use , , and .
You can find a list of all valid languages . Locale, Language Name, and Native Name are all valid inputs. You can also use auto and MoonlightBot will attempt to auto-detect your preferred language from your Discord settings.
MoonlightBot is run and maintained by volunteers, and is currently funded entirely by . These subscriptions help us fund hosting and give you great benefits, making them a fantastic way to support us. You can also help by on bot lists or by .
Please to see if your question or problem is answered there. If your question or problem is still unanswered, and we will help you as best we can!
