README.md

Castle

🔌 A tool to mirror messages in a discord server to another discord server in realtime.

🔥 Features

• Automatically clones channels and categories in a mirror server
• Creates webhooks in mirror server
• Mirrors messages, embeds, attachments, reactions, and webhooks in realtime
• Handles permission overwrites for channels and categories
• Lightweight and fast, with very little external dependencies
• Minimal configuration required

📦 What's inside?

Castle uses its own selfbot methods to communicate with discord. No external dependencies are needed except for node-fetch, which is used when sending outward requests to discord.

Configuration

config.json

{
    "gateway": "wss://gateway.discord.gg/?v=9&encoding=json",
    "target_user_token": "",
    "mirror_user_token": "",
    "target_user_status": "online",
    "target_guild_id": "",
    "mirror_guild_id": "",
    "autoMirror": true,
    "target_channels": [
        {
            "target_channel_id": "",
            "mirror_channel_id": "",
            "mirror_webhook": ""
        }
    ],
    "categories": {}
}

Key	Value	Description
gateway	wss://gateway.discord.gg/?v=9&encoding=json	Discord Gateway URL, do not change unless you know what you're doing
target_user_token		Discord token of the user inside the target server to mirror messages from
mirror_user_token		Discord token of the user inside the mirror server that will be mirroring messages
target_user_status	online	Status of the target user to mirror messages from, can be online, idle, dnd, or invisible
target_guild_id		ID of the target server to mirror messages from
mirror_guild_id		ID of the mirror server to mirror messages to
autoMirror	true	Automatically create channels, categories, and webhooks in the mirror server
target_channels		Array of channel IDs to mirror messages from. Leave empty if autoMirror is set to true
categories		Key-value pairs of category IDs in the target server, and the category IDs in the mirror server

⚙️ Run it yourself

Clone the repository

git clone https://github.com/d3or/castle.git && cd castle

Install dependencies

yarn install

Build

yarn build

Configure the bot

cp config.example.json config.json

# Edit the config.json file with your own configuration

Start

yarn start

TODO

• Add support for cloning discord roles so that they can be used in the mirror server when they are mentioned in the target server.
• Add support for mirroring messages from multiple servers to a single server (or multiple servers) at the same time.
• Add support for using normal discord bots instead of selfbots
• Add support for reactions on messages
• Add support for editing messages