Invite & Setup
Adding the Bots to Your Server
Use the invite links on the OmniProtocol page to add Rascal and/or Halcyon to your Discord server. You'll need Manage Server permission in the server you're adding them to.
Each bot has its own invite link. Both use the bot and applications.commands scopes and never ask for Administrator.
Required Permissions
When inviting, grant these permissions for full functionality:
- Send Messages & Read Message History - Basic chat
- Manage Channels - For ticket creation
- Manage Roles - For auto-role, level roles, color roles, role menus
- Add Reactions - For polls, giveaways, starboard
- Embed Links & Attach Files - For rich responses and image replies
- Manage Messages - For moderation features
- View Channels - Basic access to each channel
- Kick Members, Ban Members & Time Out Members - For moderation actions
- Manage Threads - For the thread watcher
- Connect & Speak - For voice channels
First-Time Setup
Once the bots are in your server, a server admin should run:
/setup_r- Initialize Rascal (indexes channels)/setup_h- Initialize Halcyon (same process, separate personality)
This scans your server's channels and checks which ones the bot can read. It does not read past messages.
Configuring Features
All features beyond basic chat are organized into modules. Modules are disabled by default - a server admin enables them through the admin dashboard or setup commands. See the Modules page for the full list.
Channel Settings
Use /rsettings or /hsettings in any channel to customize how the bots behave there:
- Interjection chance - How often the bot speaks unprompted, from 0 to 1 (0.1 is 10%)
- Active toggle - Enable or disable bot activity in specific channels
- Channel type - Mark as "general" for lower bot activity