Discord Relay
Eine Live-Brücke zwischen Discord und GameVox. Nachrichten aus deinen Discord-Kanälen erscheinen innerhalb von Sekunden in deinen GameVox-Kanälen, mit Name und Avatar des Autors, und Bearbeitungen, Löschungen, Reaktionen und Anhänge bleiben synchron. Kombiniere es mit dem Chat-Relay GameVox → Discord, und die Brücke läuft in beide Richtungen.
Was übertragen wird
Alles, was eine Nachricht auf Discord tut, gespiegelt in GameVox
Nachrichten
Gepostet mit dem Anzeigenamen und Avatar des Discord-Autors, damit sich die Unterhaltung auf beiden Seiten natürlich liest. Funktioniert in normalen Kanälen genauso wie in Ankündigungskanälen, auch mit Beiträgen aus Kanälen, denen dein Server folgt.
Bearbeitungen & Löschungen
Bearbeite eine Nachricht auf Discord, und die Kopie in GameVox wird aktualisiert; lösche sie, und der Spiegel verschwindet. Mit dem Relay GameVox → Discord dazu aktualisieren Bearbeitungen und Löschungen in GameVox auch die Discord-Kopie direkt, ohne störende Reposts mit „(bearbeitet)“.
Reaktionen
Reagiere auf beiden Seiten einer verbundenen Nachricht. Discord-Reaktionen erscheinen in GameVox als Live-Pills mit dem Namen der reagierenden Person, und in GameVox hinzugefügte Reaktionen erscheinen an der ursprünglichen Discord-Nachricht.
Anhänge & Sticker
Bilder, Dateien und Sticker reisen mit der Nachricht mit und werden in GameVox direkt angezeigt.
Verlauf nachladen
Hol mit einem Klick bis zu 500 aktuelle Nachrichten aus einem Discord-Kanal nach GameVox, die älteste zuerst.
Verbindungsprotokoll
Ein Live-Protokoll der Bot-Verbindung mit Zeitstempeln, direkt in den Servereinstellungen. Sieh genau, wann er sich verbunden hat oder warum nicht.
Sollen Nachrichten auch in die andere Richtung laufen? Kombiniere das Relay im selben Einstellungs-Tab mit GameVox → Discord (Chat-Relay): GameVox-Nachrichten werden auf Discord gepostet, und Bearbeitungen oder Löschungen in GameVox aktualisieren die Discord-Kopie direkt. Ein Schleifenschutz ist eingebaut: Gespiegelte Nachrichten werden nie erneut übertragen.
Einrichtung
Etwa fünf Minuten. Du brauchst Server verwalten auf dem Discord-Server und Server verwalten auf dem GameVox-Server. Der Assistent in der App führt dich durch dieselben Schritte.
Erstelle deinen Bot
Öffne das Discord Developer Portal, klicke auf New Application und gib ihr einen Namen, zum Beispiel „GameVox Relay“. Das Bot-Konto wird zusammen mit der Anwendung erstellt, und sein Name ist das, was deine Mitglieder als Brücke sehen. Jede Community erstellt ihren eigenen Bot, er bleibt also komplett unter deiner Kontrolle. Du musst keinen Avatar hochladen: Der Bot bekommt beim ersten Verbinden automatisch das GameVox-Relay-Icon.
Erlaube ihm, Nachrichten zu lesen
Öffne in deiner Anwendung den Tab Bot und scrolle zu Privileged Gateway Intents. Schalte Message Content Intent ein und speichere.
Kopiere das Bot-Token
Klicke, noch im Tab Bot, auf Reset Token und kopiere es. Discord zeigt das Token genau einmal an; wenn du es verlierst, setz es einfach erneut zurück. In GameVox wird es verschlüsselt gespeichert und nach dem Einfügen niemandem mehr angezeigt.
Lade den Bot auf deinen Discord-Server ein
Öffne in GameVox Servereinstellungen → Discord-Integration → Discord → GameVox und füge dein Token in Schritt 3 des Assistenten ein. Automatisch erscheint ein Einladungslink: Öffne ihn, wähle deinen Discord-Server und klicke auf Autorisieren. Der Link vergibt Kanäle ansehen, Nachrichtenverlauf anzeigen, Reaktionen hinzufügen (damit in GameVox hinzugefügte Reaktionen auf Discord erscheinen können) und Webhooks verwalten (das treibt die Nachrichtenrichtung GameVox → Discord an).
Sorg dafür, dass der Bot deine Kanäle sieht
Die Einladung vergibt serverweite Berechtigungen, aber private Kanäle erben sie nicht. Öffne für jeden Kanal mit eingeschränktem Zugriff seine Discord-Berechtigungen und füge den Bot (oder eine seiner Rollen) mit Kanal ansehen und Nachrichtenverlauf anzeigen hinzu. Sieht der Bot einen Kanal nicht, wird aus ihm nichts übertragen, und das Nachladen des Verlaufs schlägt mit einem Berechtigungsfehler fehl.
Verbinden und prüfen
Füge zurück im GameVox-Assistenten die ID deines Discord-Servers ein (Rechtsklick auf deinen Servernamen in Discord → Server-ID kopieren; falls du das nicht siehst, aktiviere den Entwicklermodus unter Benutzereinstellungen → Erweitert) und klicke auf Verbinden und prüfen. GameVox baut die Verbindung auf und beobachtet sie live: Nach wenigen Sekunden wird der Status grün, Relay verbunden und verifiziert. Stimmt etwas nicht, bekommst du statt eines Ladekreisels den genauen Grund und die Lösung.
Kanäle zuordnen & Verlauf nachladen
Nach der Prüfung wird der Bereich für die Kanalzuordnung freigeschaltet. Für jede Brücke: Rechtsklick auf den Discord-Kanal → Kanal-ID kopieren, einfügen, den GameVox-Kanal wählen, in den gespiegelt werden soll, und auf Zuordnung hinzufügen klicken. Neue Nachrichten fließen sofort. Klicke bei einer beliebigen Zuordnung auf Verlauf nachladen, um bis zu 500 aktuelle Nachrichten zu holen, die älteste zuerst.
Fehlerbehebung
Jeder Fehler taucht in der Statuskarte und im Verbindungsprotokoll auf. Das bedeuten sie
Discord hat die Verbindung abgelehnt, weil Message Content Intent aus ist. Öffne im Developer Portal deine Anwendung → Tab Bot → Privileged Gateway Intents → schalte Message Content Intent ein → speichern. Klicke dann in GameVox auf Verbindung erneut versuchen, und du siehst im Verbindungsprotokoll connecting → identifying → ready.
Bei Bots auf weniger als 100 Servern (was Relay-Bots immer sind) greift der Schalter sofort und kostenlos, ohne Prüfung durch Discord.
Discord hat das Bot-Token abgelehnt: Es ist vertippt, oder es wurde im Portal zurückgesetzt, nachdem du es gespeichert hast. Geh zum Tab Bot, klicke auf Reset Token, kopiere das neue Token, füge es in GameVox unter Bot-Einstellungen ein und klicke auf Aktualisieren. Ein neues Token erzwingt automatisch eine frische Verbindung.
Der Bot ist auf deinem Discord-Server, sieht aber genau diesen Kanal nicht. Das heißt fast immer, dass der Kanal (oder seine Kategorie) privat ist, und private Kanäle erben die serverweiten Berechtigungen aus der Einladung nicht.
Lösung: Öffne in Discord die Einstellungen des Kanals → Berechtigungen → füge den Bot (oder eine seiner Rollen) mit erlaubtem Kanal ansehen und Nachrichtenverlauf anzeigen hinzu. Wenn der Kanal seine Berechtigungen mit einer Kategorie synchronisiert, korrigiere stattdessen die Kategorie. Starte das Nachladen danach erneut.
Für die Live-Übertragung gelten dieselben Zugriffsregeln: Ein Kanal, den der Bot nicht sehen kann, sendet überhaupt keine Events.
Geh diese Punkte der Reihe nach durch:
1. Prüf die Zuordnung. Die Discord-Kanal-ID muss die des Kanals sein, in dem du postest. Rechtsklick auf den Kanal selbst (nicht auf den Server), Kanal-ID kopieren und mit der Zuordnung vergleichen.
2. Prüf, ob der Bot den Kanal sieht. Dieselben Zugriffsregeln wie beim 403 oben: Ist der Kanal privat, füge den Bot zu seinen Berechtigungen hinzu.
3. Prüf, ob der Status READY ist. Zeigt das Verbindungsprotokoll einen Fehler, behebe zuerst den. Zuordnungen funktionieren nur, solange die Verbindung steht.
4. Intent später entzogen? Wenn das Relay lief und nach Änderungen im Developer Portal aufgehört hat, schalte Message Content Intent wieder ein und klicke auf Verbindung erneut versuchen.
Das Verbindungsprotokoll unter der Statuskarte hält jeden Zustand fest, den die Bot-Verbindung durchläuft, der neueste zuerst, und übersteht Neustarts auf unserer Seite:
connecting / identifying: Gateway wird geöffnet und der Bot angemeldet · ready: verbunden und überträgt · reconnecting: kurzer Netzwerkaussetzer, erholt sich automatisch · intent_denied / auth_failed: braucht dein Eingreifen (siehe oben) · stopped: das Relay wurde deaktiviert oder startet neu.
Eine gesunde Einrichtung endet bei ready. Alles in Rot sagt dir genau, was zu beheben ist, und danach lässt Verbindung erneut versuchen die Abfolge noch einmal laufen, während du zusiehst.
Voraussetzungen
Was du brauchst, bevor du loslegst
- Dein eigener Discord-Bot. In etwa einer Minute kostenlos im Developer Portal erstellt, der Einrichtungsassistent führt dich durch. Ein Bot pro Community lässt dich die volle Kontrolle über seinen Zugriff behalten.
- Server verwalten auf Discord. Nötig, um den Bot auf den Server einzuladen, den du spiegelst.
- Server verwalten auf GameVox. Der Tab Discord-Integration in den Servereinstellungen ist Besitzern und Admins vorbehalten.
- Discord-Entwicklermodus zum Kopieren von Server- und Kanal-IDs: Benutzereinstellungen → Erweitert → Entwicklermodus.
Verbinde deine Community
Halte die Unterhaltung an einem Ort, während deine Community umzieht. Richte das Relay in fünf Minuten ein.