Permissions & Intents
Discord permissions and gateway intents Lio commonly needs.
Recommended bot permissions
- View Channels, Send Messages, Embed Links, Attach Files — baseline for messages and transcripts.
- Manage Roles — Welcome auto-role, XP level roles, streamer live roles, absence roles.
- Manage Channels — Tickets (private channels), Voice Hubs (spawn/delete voice rooms).
- Manage Messages — Moderation, suggestion message replacement, automod deletes.
- Moderate Members — timeout/ban commands in the Moderation module.
- Move Members — Voice Hubs (move user into their new room).
What Lio needs to work
Lio is fully hosted — you do not need to change anything in Discord's developer settings. When you invite the bot, grant the permissions shown on the invite screen.
- Member join/leave events — used by Welcome and some logging features.
- Reading message content — used by XP, automod, suggestions, and a few chat commands.
If a feature seems inactive, check that the module is enabled and the bot can send messages in the configured channel.
Channel overwrites
If the bot cannot post in a configured channel, check category-level denies. Lio needs explicit allow for Send Messages in that channel.
Ticket channels are created with private overwrites — the bot role must be above roles it assigns.
Slash commands
Global commands: /ping, /info, /stats, /module enable|disable (admin).
Module-specific commands appear when those modules are enabled (e.g. moderation, giveaways).
Helpdesk commands (/claim, /close, /note, /waituser, /reminder) are always registered but only work inside active Helpdesk tickets when Helpdesk is enabled.
Helpdesk-specific permissions
- Manage Channels — create and delete ticket channels (channel mode).
- Create Private Threads + Send Messages in Threads — thread mode tickets.
- Manage Messages — default permission on staff slash commands; map support roles in Helpdesk Settings.
- Bot role should sit above support roles if you assign roles inside tickets.