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.
Tip

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.