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 do not own it and do not hold Administrator or Manage Server. Or your sign-in is out of date. | Ask the owner for Manage Server, then sign out and sign in again so the list is refreshed. |
| 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.