Keyboard shortcuts

Press or to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

seabird-discord-backend

Static Badge GitHub Actions Workflow Status

Dependencies

  • seabird-core

Configuration

Environment Variables

Common settings:

  • SEABIRD_ID (optional, defaults to seabird) - internal "id" of the backend, used for identification purposes. This must be unique between backends. It may be dropped or ignored in future versions of the seabird APIs.
  • SEABIRD_HOST (required) - this is the URL of the seabird-core instance. Most users should use https://core.seabird.chat
  • SEABIRD_TOKEN (required) - the seabird token

Discord-specific settings

  • DISCORD_TOKEN (required) - Both an application and a bot user must be set up in Discord, and connected to the relevant Discord server by an admin on that server. The correct OAuth URL has been lost to time, but make sure priviledged intents (presence, server members, and message content) are enabled. Note that tokens must be prefixed with Bot in order for Discord to use them as a bot token.
  • DISCORD_COMMAND_PREFIX (optional, defaults to !)
  • DISCORD_CHANNEL_MAP (optional, defaults to empty) - a comma separated list of Discord voice channels, followed by a : and then a channel which should be notified when someone joins.

Known Issues

  • There is not true Discord "command" support, so all commands need to be prefixed by the DISCORD_COMMAND_PREFIX setting.