Discord Bridge · Installation Guide
Diese Anleitung führt dich Schritt für Schritt durch die Installation und Einrichtung der Twitch ↔ Discord Bridge. Plane etwa 15 bis 20 Minuten ein. Wenn du unterwegs Fragen hast, findest du auf unserem Discord Server einen Support-Channel.
- Streamer.bot in Version 0.2.x oder neuer
- Ein Discord-Account mit Admin-Rechten auf einem Server
- Optional: OBS Studio mit aktiviertem OBS-WebSocket-Plugin für Join-Alerts
Discord Bot Application erstellen
Öffne das Discord Developer Portal und melde dich mit deinem Discord-Account an. Klicke oben rechts auf „New Application“, vergib einen Namen (zum Beispiel Twitch) und bestätige mit „Create“.
Im Menü links auf „Bot“ klicken. Scroll nach unten zum Abschnitt Privileged Gateway Intents und aktiviere alle drei Schalter:
- Presence Intent
- Server Members Intent
- Message Content Intent
Ganz wichtig: danach unten auf „Save Changes“ klicken ohne das greifen die Intents nicht.
Bot-Token generieren und kopieren
Auf der gleichen Bot-Seite auf „Reset Token“ klicken und den Hinweis bestätigen. Discord zeigt dir jetzt einmalig den Token an kopiere ihn sofort an einen sicheren Ort. Wenn du ihn verlierst, kannst du ihn jederzeit neu generieren, aber der alte ist dann ungültig.
Bot auf deinen Server einladen
Links im Menü auf „OAuth2″ → URL Generator klicken.
Unter Scopes die Checkbox bot aktivieren. Scroll nach unten jetzt erscheinen die Bot Permissions. Aktiviere folgende:
View ChannelsSend MessagesRead Message HistoryManage Messages(wichtig für Delete-Sync)
Ganz unten wird eine URL generiert. Diese URL kopieren, im Browser öffnen, deinen Server auswählen und die Einladung bestätigen.
Server-ID und Channel-ID auslesen
In Discord: Einstellungen öffnen → Erweitert → Entwicklermodus aktivieren. Dadurch erscheint in Rechtsklick-Menüs die Option „ID kopieren“.
Führe zwei Rechtsklicks durch:
- Rechtsklick auf den Server-Namen → „Server-ID kopieren“
- Rechtsklick auf den Bridge-Channel → „Kanal-ID kopieren“
Speicher dir beide IDs zusammen mit dem Token zwischen im nächsten Schritt brauchst du alles zusammen.
Extension in Streamer.bot importieren
entpacke das.7z-Archiv der Extension welches du nach dem Kauf auf der Shop-Seite heruntergeladen hast und Öffne die Datei Import-String.txt. Öffne Streamer.bot und drücke auf Import. Den Inhalt der Datei einfügen und importieren.
Nach dem Import findest du folgende Actions im Actions-Tab:
- Discord Bridge · Init — startet den Bot beim Start von Streamer.bot
- Discord Bridge · Twitch to Discord — spiegelt Twitch-Nachrichten
- Discord Bridge · Twitch Delete — löscht einzelne Nachrichten beidseitig
- Discord Bridge · Twitch User Cleared — löscht alle Nachrichten bei Timeout/Ban
- Discord Bridge · Toggle — Command
!bridgezum Features steuern
Zugangsdaten eintragen
Öffne die Action Discord Bridge · Init und trage in den vorhandenen Set-Argument-Sub-Actions deine Werte ein:
discord_botToken— dein Bot-Token aus Schritt 2discord_serverId— deine Server-ID aus Schritt 4discord_channelId— deine Channel-ID aus Schritt 4
Die Rollen-Emotes kannst du optional anpassen siehe dazu den FAQ-Eintrag zum Thema eigene Emotes.
Verbindung prüfen
Im Log von Streamer.bot sollte nach ein paar Sekunden folgende Zeile erscheinen:
[Discord Bridge] Discord Gateway connected
Jetzt den ersten Test durchführen:
- Im Twitch-Chat eine Nachricht schreiben sie sollte im Discord-Channel erscheinen
- Im Discord-Bridge-Channel eine Nachricht schreiben sie sollte im Twitch-Chat ankommen
Falls keine Nachrichten durchkommen, mit !bridge status im Chat den aktuellen Zustand prüfen.
Optional: OBS Join-Alerts einrichten
Dieser Schritt ist optional überspringe ihn wenn du keine Alerts im Stream möchtest.
In OBS neue Quellen in der Stream-Scene anlegen:
- Eine Bild-, Video- oder Medienquelle für das visuelle Alert
- Optional eine Text (GDI+) Quelle für den Willkommenstext
- Optional eine Medienquelle für den Sound (Schleife deaktivieren)
Alle Quellen unsichtbar stellen, die Extension blendet sie automatisch ein und wieder aus. Die exakten Quellnamen (Groß-/Kleinschreibung!) in folgende Arguments der Init-Action eintragen:
obsAlertSource— Name der Bild-/Video-QuelleobsAlertText— Name der Text-QuelleobsAlertSound— Name der Sound-QuellealertDuration— Anzeigedauer in Millisekunden (Standard: 5000)alertTextDelay— Verzögerung des Text Alerts in Millisekunden (Standard: 500)
Features im laufenden Betrieb steuern
Über den Chat-Command !bridge kannst du einzelne Features live an- und abschalten. Die Einstellungen bleiben persistent und überleben einen Neustart.
!bridge twitch— Twitch → Discord an/aus!bridge discord— Discord → Twitch an/aus!bridge alerts— Join-Alerts an/aus!bridge joinmsg— Join-Nachricht im Twitch-Chat an/aus!bridge status— zeigt den aktuellen Zustand aller Features
Fertig — deine Bridge läuft
Wenn alle Schritte funktioniert haben, ist dein Twitch-Chat jetzt live mit Discord verbunden. Viel Spaß beim Streamen.
