Troubleshooting
Most problems come from a missing permission or the role order. Start here.
Slash commands do not show up
- Invite Plexa again with the Add to Discord button, so the applications.commands scope is granted.
- Check the module in /settings modules. Commands of a switched-off module are hidden.
- A role-based rule from /settings permission can hide a command for you.
- Restart Discord (Ctrl+R) if you just added the bot.
Plexa cannot give a role
- The Plexa role must be above the role in Server settings → Roles.
- Managed roles (from bots or integrations) and @everyone cannot be handed out.
- Roles with admin or server-management rights are never given on a panel, for safety.
A feature is silent
- Plexa needs View Channel, Send Messages and Embed Links in that channel.
- Check whether a channel override denies Plexa something.
- For welcome messages and the log, make sure a channel is actually set. The setup wizard shows what is missing.
Automod does not act
- New servers start in log-only mode: it logs, but deletes and punishes nothing. Turn it off when you are happy.
- Members with Manage Messages (mods, admins) are never filtered. Turn that off to test it yourself, then back on.
- /automod test tells you whether your text, your role or the channel is exempt.
Members get no XP
- Levels are off by default on new servers.
- There is a cooldown between messages that give XP, and channels or roles can be excluded.
- Bots do not collect XP.
Music does not play
- Join a voice channel first. Plexa needs Connect and Speak there.
- Plexa does not play YouTube. Search by name (SoundCloud), paste a SoundCloud, Bandcamp, Twitch, Vimeo or stream link, or use /radio.
- If the music server restarts, try again after a minute.
Tickets do not open
- Post the panel in a normal text channel, not in a thread.
- Private-thread tickets need Create Private Threads in that channel.
- Free servers have one ticket panel; Plexa Plus has more. Delete an old panel or upgrade.
- Each member can have a limited number of open tickets.
Something else
Run /support for the support server, or send /bug or /feedback. The Status page shows whether the bot and the database are running.