Troubleshooting
The most common issues, and the fastest way to confirm what's actually going wrong before you assume the bot is broken.
A slash command doesn't appear in Discord
Restart your Discord client first — command lists are cached locally and this fixes the majority of cases. If it's still missing, confirm Ovels was invited with both the bot and applications.commands scopes (see Setup and invite), and that it's still present in the server's member list.
A moderation command silently fails on one member
This is almost always role hierarchy — Discord blocks any bot from acting on a member whose highest role sits above the bot's own role, regardless of what permissions the bot has. Compare Ovels' role position to that specific member's highest role in Server Settings → Roles.
A dashboard save fails or doesn't stick
Reload the page after saving to confirm it actually persisted — the dashboard shows a success toast immediately, but a reload is the real test. If it reverts, check that Ovels still holds the Discord permission that feature depends on; a save can succeed on the dashboard side while the underlying Discord action is rejected.
Music won't join or keeps disconnecting
Confirm Ovels has Connect and Speak permission in the target voice channel. If it joins and then leaves shortly after, that's very likely the 120-second empty-channel idle timer — see the music system deep dive for exactly how idle handling and reconnection work.
Text-to-speech fails to join voice
The same voice permissions apply as regular music playback. If permissions look correct, the most common remaining cause is a restrictive network — VPNs and some firewalls block the outbound UDP traffic Discord voice connections require.
A setting reverted after you changed it in Discord directly
The dashboard is the source of truth for Ovels' own configuration. Changing something in Discord's native settings (like a channel's own permission overrides) doesn't update Ovels' saved configuration, and the two can drift out of sync — always confirm feature-level settings from the dashboard, not Discord's UI.