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.