A powerful and easy-to-use Discord bot for relaying messages, edits, deletes, and role pings between channels on one or more servers.
RelayBot is designed for communities that span multiple Discord servers, like gaming alliances or project collaborations. It creates a seamless bridge, allowing members to communicate as if they were in the same channel.
- Multi-Server Relaying: Link channels from any number of servers into a single, shared communication group.
- Directional Relays: Configure channels to be Send-Only, Receive-Only, or Both Ways, perfect for announcements or log channels.
- Full Message Syncing: Messages, edits, deletes, replies, and attachments are all synced across relayed channels.
- Dynamic Role Mapping: Mention a role in one server, and RelayBot will intelligently ping the correctly mapped role in all other linked servers.
- Auto-Role Creation: If a mapped role doesn't exist on a target server, the bot will automatically create it for you.
- Granular Deletion Toggles: Separately control if deleting original messages deletes copies, and if deleting copies deletes the original.
- Server Context: Relayed messages clearly show the sender's name and their original server (e.g.,
ShaggyZE (Server A)). - Easy Setup & Management: All configuration is done through user-friendly
/slash commands. - Scalable & Secure: Built with a robust database backend to ensure every server's configuration is separate and secure.
There are two ways to use RelayBot: inviting an official public bot (if available) or self-hosting your own private instance for full control.
- top.gg (public bot on railway.app)
The easiest way to host your own bot is with Railway. The button below will guide you through setting up your own private instance.
For manual installation instructions and troubleshooting, please see the sections at the bottom of this guide.
Configuration is done via the /relay command. You must have the Manage Server permission.
The bot uses global groups. One server creates the group, and others link to it.
-
On ONE Server Only - Create a Global Group: An admin on your "main" server creates the group. The name must be unique across all servers using this bot.
/relay create_group name: my-super-unique-alliance
-
On ALL Servers - Link Your Channels: Admins on all participating servers can now link their channels to the same global group by name. You can specify a message direction, which is great for announcement channels!
/relay link_channel group_name: my-super-unique-alliance direction: One Way (Send messages FROM this channel only)
-
Map Roles (Optional): To sync role pings, map your server's roles to a shared "common name" within that group.
- On Server A:
/relay map_role group_name: my-super-unique-alliance common_name: Team Leaders role: @Leaders - On Server B:
/relay map_role group_name: my-super-unique-alliance common_name: Team Leaders role: @Squad-Leads
- On Server A:
/relay help: Shows the setup guide.
Group Management:
/relay create_group: Creates a new, unique global group./relay delete_group: Deletes a global group (can only be run by the creating server)./relay kick_server: Forcibly remove a server from a group you own./relay list_servers: See all servers currently in a group.
Channel Management:
/relay link_channel: Links the current channel to a global group (with an optional direction)./relay unlink_channel: Unlinks the current channel from its group.
Role Mapping:
/relay map_role: Maps a server role to a common name./relay list_mappings: Lists all configured role mappings for a group on this server./relay unmap_role: Removes a specific role mapping.
Settings:
/relay set_direction: Sets the direction of a channel from a group you own./relay set_delete_delay: Sets how long until relayed messages are auto-deleted (OFF by default)./relay toggle_forward_delete: Toggles if deleting an original message also deletes its copies (ON by default)./relay toggle_reverse_delete: Toggles if deleting a relayed copy also deletes the original message (OFF by default).
Utility:
/invite: Get a link to invite the bot to another server./version: Check the bot's current version./vote: Get links to vote for and support the bot.
Manual Installation & Configuration
If you prefer to host the bot yourself on a VPS or other service, follow these steps.
Prerequisites:
- A code editor like VS Code
Before you begin, ensure you have the following software installed on your system.
-
Node.js: This is the runtime environment for the bot.
- Recommended Version: v20.x (LTS) or higher.
- We strongly recommend using a version manager to avoid permission issues and easily switch versions:
- For Windows, use nvm-windows.
- For Mac/Linux, use nvm.
-
Build Tools for Native Modules: The
better-sqlite3database package requires C++ code to be compiled during installation.- On Windows: The easiest way to get the necessary build tools is to install Visual Studio 2022 Community. During installation, make sure to select the "Desktop development with C++" workload.
- On macOS: Install the Xcode Command Line Tools by running
xcode-select --installin your terminal. - On Debian/Ubuntu: Install the necessary packages by running
sudo apt-get install -y build-essential python3.
-
Git: Required for cloning the repository. You can get it from git-scm.com.
1. Clone the Repository:
git clone https://github.com/shaggyze/RelayBot.git
cd RelayBot2. Install Dependencies:
This single command will download all the necessary Node.js packages like discord.js, dotenv, and better-sqlite3.
npm install3. Create a Discord Bot Application:
- Go to the Discord Developer Portal.
- Click "New Application" and give it a name.
- Go to the "Bot" tab and click "Add Bot".
- Crucially, under the bot's username, enable all three Privileged Gateway Intents (Presence, Server Members, and Message Content).
- Click "Reset Token" to reveal your bot's token. Keep this secret!
- On the "General Information" page, copy the Application ID.
4. Configure Environment Variables:
- Create a new file named
.envin the project root. - Open the
.envfile and fill in the required values:# Your Discord Bot Token from the Developer Portal DISCORD_TOKEN=YourBotTokenGoesHere # Your Bot's Application/Client ID from the "General Information" page CLIENT_ID=YourBotClientIDGoesHere # The ID of your private/developer/support server DEV_GUILD_ID=1397170407580237944
5. Deploy Slash Commands: Run this command once to register the bot's slash commands with Discord.
npm run deploy6. Start the Bot:
npm startFor 24/7 hosting on a VPS, it is highly recommended to use a process manager like pm2.
7. Inviting Your Bot to a Server: After deploying your bot, it is running but hasn't joined any servers yet. Use the manual link generation method to get it into your first server.
- Go to the Discord Developer Portal -> [Your App] -> OAuth2 -> URL Generator.
- In "Scopes", check
botandapplications.commands. - In "Bot Permissions", check:
Manage Roles,Manage Webhooks,Manage Messages,Read Message History,Send Messages, andView Channel. - Copy the generated URL and use it to invite the bot.
Once the bot is in one server, you can simply use the /invite command to get a clean invite link for other servers.
Troubleshooting
I get a big red error during npm install on Windows (better-sqlite3 / node-gyp)
If you see a long error log during npm install that mentions better-sqlite3, node-gyp rebuild, and C++ errors, it is almost certainly a Node.js version incompatibility.
Cause: This happens when you are using a brand-new or unstable version of Node.js. Many packages that rely on native C++ code, like our database driver, are only compatible with stable, Long-Term Support (LTS) versions.
Solution: The fix is to use a Node Version Manager to install and switch to the recommended LTS version.
-
Install a Node Version Manager:
- Download and run the installer for nvm-windows.
-
Switch to the Stable LTS Version:
- Open a new terminal as an Administrator.
- Install the latest Long-Term Support (LTS) version:
nvm install lts - Tell nvm to use it:
nvm use lts - Verify the change with
node -v. It should now show a stable version (e.g.,v20.x.x).
-
Perform a Clean Installation:
- It's crucial to delete the old, broken files. In your project directory, run:
rmdir /s /q node_modules del package-lock.json
- Now, run the installation again:
npm install
- It's crucial to delete the old, broken files. In your project directory, run:
Your use of RelayBot is subject to the following legal documents. By adding the bot to your server, you are agreeing to these terms.
documents
- Terms & Conditions: Outlines the rules for using the bot, acceptable use, and our disclaimers.
- Privacy Policy: Details what data the bot collects, how it is used, and your rights regarding that data.
- ISC License: RelayBot is open-source software. This license grants you broad permissions to use, modify, and distribute the software.
The bot is provided "as is", without warranty of any kind.
This bot was originally conceived by YuRaNnNzZZ then ShaggyZE and has been refactored for public use.