Troubleshooting
Run /doctor in Discord or open the overview page of the dashboard first. Both list the common problems below.
| What you see | Likely cause | What to do |
|---|---|---|
| The bot does not answer commands | The bot cannot see or post in that channel, or it lacks Use Application Commands. | Give the bot's role View Channel and Send Messages in the channel. Run /doctor. |
| The dashboard says the bot is not in this server | The bot was removed, or it has only just joined and has not reported in yet. | Wait a few seconds and reload. If the bot is not in your member list, add it again from Add to Discord. |
| A server is missing from the dashboard picker | You are not an administrator of it (the owner, or the Administrator permission), and no administrator added you on its Panel access page. Manage Server alone is not enough. Or your sign-in is out of date. | Ask an administrator of the server to add you under Panel access, then reload the page. If you were just given the Administrator permission, sign out and sign in again so the list is refreshed. |
| A dashboard page says a part of the panel was not given to you | An administrator added you to the panel, but not with that part. | Ask an administrator of the server to tick that part for you on the Panel access page. |
| A channel or role is missing from a dropdown | The bot has not mirrored it yet, or it cannot see that channel. | Give the bot View Channel on it. Lists refresh whenever the bot sees a change in Discord. |
| The plugin will not pair | The code expired (ten minutes), was already used, or was typed wrong too many times. | Create a new code on the dashboard and run /vv pair again. |
| Ranks do not change in game | LuckPerms is not installed, the server is offline, or the group is not in the plugin's allowed list. | Check the server status on the dashboard and the allowed-groups list in the plugin's config.yml. |
| I changed a setting but the bot still acts the old way | Busy parts of the bot read settings from a short cache. | Wait up to 30 seconds. If it still does not change, check the audit log to confirm the change was saved. |
| "You need the Owner level" on a setting | Some settings can only be changed by the server owner. | Ask the owner to change it, or leave it as it is. |
Still stuck? See the contact page.