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.