Sync Bot — Server Mirroring
Commands
Every /sync command — from registering to activating and disconnecting.
Commands
Everything runs through the /sync slash command. By default the commands require the
Manage Server permission.
| Command | Where | Function |
|---|---|---|
/sync setup [category] | Server A | Registers the category and returns a Sync ID |
/sync activate [sync-id] | Server B | Recreates the category + channels, sets up webhooks, starts the sync |
/sync status | both | Shows the syncs connected to this server |
/sync rename-channel [channel] [new_name] | Server B | Renames a mirrored channel and locks the name |
/sync rename-category [new_name] | Server B | Permanently renames the mirrored category |
/sync remove [sync-id?] | both | Disconnects the sync and deletes its database entries |
Starting a sync
- On Server A: run
/sync setup category:<category>and copy the Sync ID. - On Server B: run
/sync activate sync-id:<id>. The category and all channels are created, webhooks are set up, and the sync starts.
/sync activate must be run on Server B (the mirror) — not on the source.Renaming
/sync rename-channelis the only way to give a mirrored channel its own name. From then on that channel is no longer overwritten when Server A renames it./sync rename-categoryis the only allowed way to permanently rename the mirrored category.
For how UI renames behave, see Synchronisation.
Disconnecting
/sync remove tears down the connection: the webhooks the bot created are deleted and all database
entries are removed. If a server has more than one sync, pass the sync-id.
The channels and category created on Server B are kept — they become normal channels. Only the
connection and the webhooks are removed.