Sync Bot — Server-Spiegelung
Überblick
Was der Sync Bot macht und wie er eine Kategorie zwischen zwei Servern spiegelt.
Sync Bot — Server-Spiegelung
Der Sync Bot spiegelt eine komplette Kategorie inklusive aller Kanäle zwischen zwei Discord-Servern. Server A ist die Quelle (Main), Server B der Spiegel (Target). Struktur-Änderungen fließen von A nach B, Nachrichten laufen in beide Richtungen über Webhooks.
Funktionen
| Funktion | Beschreibung |
|---|---|
| Struktur-Sync | Kanäle erstellen, löschen, umbenennen und sortieren — von A nach B |
| Kanal-Eigenschaften | Typ (Text, Voice, Forum, Announcement), Topic, Slowmode und NSFW werden übernommen |
| Nachrichten (A ↔ B) | Bidirektional über Webhooks, mit Anzeigename und Avatar des Originals |
| Inhalte | Text, Anhänge und Embeds werden 1:1 gespiegelt |
| Bearbeiten & Löschen | Edits, einzelne Löschungen und Massen-Löschungen (Purge) werden mitgezogen |
| Reaktionen | Emojis werden 1:1 mitgespiegelt (Hinzufügen und Entfernen) |
| Echte Pings | @User, Rollen und @everyone/@here lösen echte Benachrichtigungen aus |
| Custom-Namen | Kanäle auf B lassen sich per Befehl umbenennen und gegen Überschreiben locken |
| Loop-Schutz | Eigene Webhook-Nachrichten werden erkannt und nicht erneut gespiegelt |
Voraussetzungen
- Eine laufende Bot-Instanz (Node 22), die Mitglied beider Server ist.
- Bot-Rechte: Kanäle verwalten, Webhooks verwalten, Kanäle ansehen, Nachrichten senden, Nachrichtenverlauf lesen.
- Im Developer Portal muss das Message Content Intent aktiviert sein.
Ohne das Message Content Intent kommen gespiegelte Nachrichten leer an — der Bot kann den Text
sonst nicht lesen. Das Intent ist „privileged" und wird im Developer Portal unter Bot → Privileged
Gateway Intents aktiviert.
So funktioniert es
- Auf Server A legst du mit
/sync setupdie Kategorie fest und erhältst eine Sync-ID. - Auf Server B aktivierst du mit
/sync activate <Sync-ID>— Kategorie und Kanäle werden nachgebaut und die Webhooks eingerichtet. - Ab dann folgt die Struktur A → B, und Nachrichten sowie Reaktionen laufen in beide Richtungen.
Weiter geht's mit der Einrichtung — dort legst du den Bot an und bringst ihn
auf beide Server.