> For the complete documentation index, see [llms.txt](https://moonlightbot.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://moonlightbot.gitbook.io/docs/get-started/faqs.md).

# Frequently Asked Questions

## Why is MoonlightBot not responding to my commands?

Try doing the following things:

* Make sure it's status shows as online, indicated by a green dot in the profile
* Try checking channel permission. If needed, you can add to the bot channel-specific permissions such as Read Messages, Send Messages, Embed Links and View Message History
* If the command errors with "The application did not respond", try again! Sometimes network latency spiked happen, you can also use a simpler command like [`/ping`](https://moonlightbot.gitbook.io/docs/miscellaneous-commands/other-minor-commands.md#ping) to check the latency.

If the problem persists, please [contact support](https://discord.gg/hNQWVVC).

## MoonlightBot is sending me offensive direct messages. What can I do?

This is happening because someone is abusing the infraction system to harass you. Our Staff does not tolerate this use at all. Please report it in the [support server](https://discord.gg/hNQWVVC).

## How does the Temporary Role feature work?

There are different types of Temporary Roles offered:

* The [`/temprole`](https://moonlightbot.gitbook.io/docs/role-management-commands/temprole.md) command, which allows a privileged user (usually a moderator) to give someone a role, and make MoonlightBot remove the role after a set duration
* [Self-assignable temproles](https://moonlightbot.gitbook.io/docs/management-commands/config.md#roles-self-assignable) that allow users to assign themselves a role through the [`/selfrole`](https://moonlightbot.gitbook.io/docs/role-management-commands/selfrole.md) command
* [Join-assigned temproles](https://moonlightbot.gitbook.io/docs/management-commands/config.md#roles-join-assignable) that assign a role automatically to a user upon joining the server
* [Reaction roles](https://moonlightbot.gitbook.io/docs/get-started/setting-up-reaction-roles.md) have an option to make their roles temporary
* Any role assigned to a user can automatically be changed to a temporary role with the [`detect-assignment` config option](https://moonlightbot.gitbook.io/docs/management-commands/config.md#roles-detect-assignment)
* The [`/pause-role`](https://moonlightbot.gitbook.io/docs/role-management-commands/pause-role.md) command removes a role and automatically adds it back after the set duration

## How do I cancel a temporary action?

You can cancel a temporary action to force an immediate expiration by using the same command you used to enact the action, but with a duration that would make it expire in the past. Say you want to cancel a temprole that has 3 days left:

```
/temprole user:<user> role:<role> duration:-3d
```

Any value lower than `-3d` will work as well. This same principle applies to the [`/tempban`](https://moonlightbot.gitbook.io/docs/moderation-commands/tempban.md), [`/tempmute`](https://moonlightbot.gitbook.io/docs/moderation-commands/tempmute.md), [`/timeout`](https://moonlightbot.gitbook.io/docs/moderation-commands/timeout.md) and [`/pause-role`](https://moonlightbot.gitbook.io/docs/role-management-commands/pause-role.md) commands.

## How does the temprole sustain mechanic work?

In order to encourage good support practices, a system has been introduced for sustaining temproles to ensure they remain functional and fair for all servers and users.

When operating a temporary or pause role, you must satisfy at least one of the following conditions:

1. **Maximum Duration Consistency**: The [maximum duration allowed](https://moonlightbot.gitbook.io/docs/miscellaneous-commands/check-duration.md) for you at the time of the role's expiration must be equal to or greater than their maximum duration allowed at the time the role was added
2. **Vote Requirement**: The [number of votes](https://moonlightbot.gitbook.io/docs/support-our-work/upvote-moonlightbot.md) received from you must be equal to or greater than half the number of days the temporary role lasts, rounded up. For example, a 30-day temprole meets this requirement if you have cast at least 15 votes after its beginning. Each vote counts towards **all** of your active temporary/pause roles
3. **Premium Instance**: The server uses a [MoonlightBot Premium instance](https://moonlightbot.gitbook.io/docs/support-our-work/premium.md) (Advanced tier or higher)
4. **Be Exempted**: You must have requested and received an exemption from the above requirements from bot Staff. Simply ask in the support channel and they will guide you through the exemption process

If none of these conditions are met, the operation at the end of expiration will not be executed. You can check if your temproles are sustained with [`/list-temproles`](https://moonlightbot.gitbook.io/docs/role-management-commands/list-temproles.md).

If someone is threatening to stop sustaining temproles to damage your server, [contact support](https://discord.gg/hNQWVVC). We will begin investigating the threat and will work to prevent abuse towards your server.

## Will my temproles be erased if bot downtime happens?

No! There's absolutely no reason to worry about potential data losses as MoonlightBot is designed to be resilient. We are committed to 99% uptime, but if it ever happens that the bot goes down, your temproles will be removed as nothing happened.

## Is there a limit to the number of temporary actions a server can have?

Yes, by default a server can have up to **100** temporary actions active at the same time. This means that if the server reaches the limit of actions running concurrently, you won't be able to start any new temporary actions until one of the existing ones completes and frees up a slot.

Only temporary actions created manually with a command cannot go over the limit, automatically created actions, such as join-assignable roles continue being created even if the limit is reached but count towards the total.

When your server is 5 or fewer actions away from the limit, a warning appears in the output of commands like [`/temprole`](https://moonlightbot.gitbook.io/docs/role-management-commands/temprole.md) and [`/pause-role`](https://moonlightbot.gitbook.io/docs/role-management-commands/pause-role.md), so you can plan ahead.

If your server is running into this limit, [contact support](https://discord.gg/hNQWVVC) and request for the limit to be raised. We do this free of charge after you answered the necessary questions.

## Can I use bots to trigger MoonlightBot commands?

No, other bots and webhooks cannot trigger MoonlightBot, due to safety reasons. Using [selfbots](https://support.discord.com/hc/en-us/articles/115002192352-Automated-User-Accounts-Self-Bots) is a violation of Discord's Terms of Service.

## What language is MoonlightBot written in?

It's written in Node.js using the Discord.js library to interface with Discord's API.

## Who is the owner of MoonlightBot?

MoonlightBot is owned by MoonlightCapital. With tag `moonlightcapital` and ID `256460316660072448` on Discord.

## How can I get access to new features early?

Take a look at the [Beta](https://moonlightbot.gitbook.io/docs/support-our-work/beta.md) version of MoonlightBot. We also have a more advanced [Tester Program](https://moonlightbot.gitbook.io/docs/support-our-work/volunteering.md#tester).

## I found a bug. How do I report it?

Report it in the [support server](https://discord.gg/hNQWVVC). Make sure to include enough information for your bug to be reproducible.

If your bug can be used to compromise the bot or end user's security, **message the bot owner privately about it**, and please do not disclose it anywhere.

## How can MoonlightBot remain operative for free?

We follow simple principles of fairness: **we don't sell your data, or use any sketchy means to stay afloat.**

Simply put, we keep hosting costs low and covered by [subscribers on Patreon](https://moonlightbot.gitbook.io/docs/support-our-work/premium.md#subscribe-on-patreon), where the developer does NOT take any cut of the earnings, and all of our operations are performed by [volunteers](https://moonlightbot.gitbook.io/docs/support-our-work/volunteering.md) (yes, even the developer is a volunteer!).

We count on doing a good job and entice a sufficiently sized group of server managers who find MoonlightBot helpful and either subscribe or volunteer with us, so if you would like to support our mission, for great benefit for yourself as well, you can become one of us!

Additionally, we maintain and strictly enforce our [Acceptable Use Policy](https://moonlightbot.gitbook.io/docs/policies/acceptable-use-policy.md) to remove bad actors of various kinds, from threats of technical nature to disrespect of volunteers and sabotage. Users who violate this policy may find themselves unable to use MoonlightBot in their servers, thereby losing access to our volunteers' amazing work.
