🟣 TWITCH LIVE

Mit Twitch Live verbindest du Twitch-Kanäle mit deinem Discord-Server. Geht einer davon live, postet THE GRID automatisch eine Meldung in den Kanal, den du dafür gewählt hast – zum Beispiel #live-streams. So verpasst deine Community keinen Stream eurer Fahrer, Kommentatoren oder des Liga-Kanals.

Jeder verbundene Twitch-Kanal hat seinen eigenen Ziel-Kanal in Discord, seine eigene Nachricht und auf Wunsch eine Rolle, die gepingt wird. Die Nachricht baust du im Editor aus Bausteinen zusammen und siehst dabei eine Vorschau.

• Jeder öffentliche Twitch-Kanal geht – auch fremde. Du brauchst dafür kein Twitch-Konto und musst dich nicht bei Twitch anmelden.
• Gemeldet wird der Streamstart. Endet der Stream, passiert nichts – die Meldung bleibt unverändert stehen.
• Nur in bezahlten Tarifen: Im Free-Tarif ist die Funktion gesperrt, ab Lite kannst du Kanäle verbinden – siehe Tarife.
• Einrichten können nur der Server-Besitzer und Mitglieder mit der Discord-Berechtigung „Administrator“. „Server verwalten“ reicht nicht – mehr unter Voraussetzungen.
• Deutsche Standardtexte: Die Vorlage für neue Kanäle und der Button „Zum Stream“ sind deutsch – auch auf englischen Servern. Du ersetzt sie im Editor durch eigenen Text.

Twitch Live connects Twitch channels to your Discord server. When one of them goes live, THE GRID automatically posts a notification in the channel you picked for it – for example #live-streams. That way your community never misses a stream from your drivers, commentators or the league channel.

Every connected Twitch channel has its own target channel in Discord, its own message and, if you like, a role that gets pinged. You build the message from building blocks in the editor and see a preview while you work.

• Any public Twitch channel works – including channels that are not yours. You do not need a Twitch account and do not have to log in to Twitch.
• The stream start is announced. When the stream ends, nothing happens – the notification stays as it is.
• Paid plans only: the feature is locked in the Free plan; from Lite on you can connect channels – see Plans.
• Setting it up is limited to the server owner and members with the Discord permission “Administrator”. “Manage Server” is not enough – more under Requirements.
• German default texts: the template for new channels and the button label “Zum Stream” (to the stream) are German – on English servers too. Replace them with your own text in the editor. A few other parts of the interface are also German only; this guide gives the German original with a translation in brackets.

Wie viele Twitch-Kanäle du verbinden kannst, hängt vom Tarif deines Servers ab:

• Beim Verbinden zählen alle Einträge – eingeschaltete und ausgeschaltete. Ausschalten gibt also keinen Platz frei, nur „Entfernen“.
• Beim Einschalten zählen nur die eingeschalteten Einträge.
• Nach einer Herabstufung oder wenn dein Tarif endet, bleiben bereits eingeschaltete Kanäle derzeit eingeschaltet und melden weiter. Die Übersicht zeigt dann zum Beispiel „2 von 1 Kanälen genutzt“. Neue Kanäle verbinden oder ausgeschaltete wieder einschalten geht erst, wenn du unter dem Limit deines Tarifs liegst.
• Im Free-Tarif zeigt die Übersicht den gelben Hinweis „Diese Funktion ist Teil der Premium-Tarife.“ mit dem Link „Tarife ansehen“, und „Twitch-Kanal verbinden“ ist gesperrt. Auf der Moderations-Seite trägt die Karte „Twitch Live-Benachrichtigung“ dann das Abzeichen „PREMIUM“.

How many Twitch channels you can connect depends on your server's plan:

• When connecting, every entry counts – switched on and switched off. Switching a channel off does not free a slot; only “Remove” does.
• When switching on, only the entries that are switched on count.
• After a downgrade or when your plan ends, channels that are already switched on currently stay on and keep posting. The overview then shows, for example, “2 of 1 channels used”. You can only connect new channels or switch channels back on once you are below your plan's limit.
• In the Free plan the overview shows the yellow notice “This feature is part of the premium plans.” with the link “View plans”, and “Connect Twitch channel” is locked. On the moderation page the “Twitch Live Notification” card then carries the badge “PREMIUM”.

Du kannst jeden öffentlichen Twitch-Kanal verbinden, auch fremde. Eine Anmeldung bei Twitch brauchst du dafür nicht.

Was du eingeben kannst

• Den Twitch-Login – den Kanalnamen, wie er in der Adresse steht, zum Beispiel pdel_live. Groß- und Kleinschreibung spielt keine Rolle, ein vorangestelltes @ auch nicht.
• Die vollständige Kanal-URL mit https://, also https://twitch.tv/pdel_live. Adressen ohne https:// („twitch.tv/…“ oder „www.twitch.tv/…“) und mobile Adressen mit m.twitch.tv werden nicht erkannt – dann erscheint „Ungültiger Twitch-Login.“.
• Ein Twitch-Login hat 3 bis 25 Zeichen: Buchstaben a–z, Ziffern und den Unterstrich.

Ab drei Zeichen sucht THE GRID den Kanal bei Twitch, sobald du kurz mit dem Tippen aufhörst. Fehler stehen rot unter dem Feld. „Abbrechen“, die Esc-Taste oder ein Klick neben das Fenster schließen es.

Nach dem Verbinden

Es erscheint „Kanal verbunden“, und der Kanal steht als neue Karte in der Übersicht. Ein neuer Eintrag

• ist ausgeschaltet („INAKTIV“) und hat noch keinen Ziel-Kanal,
• bringt eine deutsche Standardvorlage mit: Überschrift „Anzeigename ist jetzt live!“, darunter Streamtitel und „🎮 Spiel“ mit Vorschaubild, eine Trennlinie und der Button „Zum Stream“.

Als Nächstes öffnest du mit „Nachricht bearbeiten“ den Editor, wählst den Ziel-Kanal und passt die Nachricht an – siehe Nachricht gestalten.

Meldungen beim Verbinden

You can connect any public Twitch channel, including channels that are not yours. You do not need to log in to Twitch for this.

What you can enter

• The Twitch login – the channel name as it appears in the address, for example pdel_live. Upper and lower case do not matter, and neither does a leading @. The empty field shows the German hint „z. B. thegrid“ (e.g. thegrid).
• The full channel URL with https://, i.e. https://twitch.tv/pdel_live. Addresses without https:// (“twitch.tv/…” or “www.twitch.tv/…”) and mobile addresses with m.twitch.tv are not recognised – you then see “Invalid Twitch login.”.
• A Twitch login has 3 to 25 characters: letters a–z, digits and the underscore.

From three characters on, THE GRID looks the channel up on Twitch as soon as you briefly stop typing. Errors appear in red below the field. “Cancel”, the Esc key or a click outside the window close it.

After connecting

You see “Channel connected”, and the channel appears as a new card in the overview. A new entry

• is switched off (“INACTIVE”) and has no target channel yet,
• comes with a German default template: the heading „Anzeigename ist jetzt live!“ (display name is live now!), below it the stream title and „🎮 Spiel“ (game) with a preview image, a divider and the button „Zum Stream“ (to the stream).

Next, open the editor with “Edit message”, choose the target channel and adapt the message – see Designing the message.

Messages when connecting

Auf jeder Karte, die noch nicht verknüpft ist, steht der Knopf „Mit Twitch verknüpfen“ optional. Damit bestätigst du, dass dir der Twitch-Kanal gehört. An der Meldung ändert das nichts – Live-Meldungen funktionieren mit und ohne Verknüpfung genau gleich.

1. Klicke auf „Mit Twitch verknüpfen“. Du landest bei Twitch.
2. Melde dich mit dem Twitch-Konto dieses Kanals an und bestätige. Twitch zeigt die Bestätigungsseite jedes Mal und fragt dabei die Berechtigung ab, deine E-Mail-Adresse zu lesen.
3. Du kehrst zur Übersicht zurück und siehst „Twitch-Konto verknüpft“. Die Karte trägt jetzt das Abzeichen „VERIFIZIERT“, der Knopf verschwindet.

THE GRID speichert dabei nur, dass der Kanal verknüpft ist, mit welchem Discord-Konto und wann.

Every card that is not linked yet has the button “Link with Twitch” optional. It confirms that you own the Twitch channel. It does not change the notification – live notifications work exactly the same with or without a link.

1. Click “Link with Twitch”. You are taken to Twitch.
2. Log in with the Twitch account of this channel and confirm. Twitch shows the confirmation page every time and asks for permission to read your email address.
3. You return to the overview and see “Twitch account linked”. The card now carries the badge “VERIFIED” and the button disappears.

THE GRID only stores that the channel is linked, with which Discord account and when.

Oben auf der Seite

• Zähler – etwa „3 von 5 Kanälen genutzt“, daneben dein Tarif in Großbuchstaben (hier „PLUS“).
• „Twitch-Kanal verbinden“ – gesperrt, wenn dein Tarif keine weiteren Kanäle erlaubt. Fährst du mit der Maus darüber, steht der Grund da: „Premium erforderlich“ oder „Limit deines Tarifs erreicht“.
• Ohne verbundene Kanäle steht hier „Noch kein Twitch-Kanal verbunden“.

Die Karten

Jeder verbundene Kanal hat eine Karte – in der Reihenfolge, in der du die Kanäle verbunden hast. Sie zeigt Profilbild, Anzeigename, @Login und die Status-Abzeichen. Darunter steht der Ziel-Kanal, bei eingeschaltetem Ping auch die Rolle: „Ziel-Channel: #live-streams · Ping: @Stream-Alarm“. „kein Channel gewählt“ heißt, dass du im Editor noch einen Kanal wählen musst. Steht statt des Namens eine lange Zahl hinter dem #, wurde der Kanal in Discord gelöscht.

Wenn „PROBLEM“ erscheint

Die Karte nennt die Ursache nicht. Es ist eine dieser:

• Es ist kein Ziel-Kanal gewählt.
• Der Ziel-Kanal existiert nicht mehr – wähle im Editor einen neuen.
• Dem Bot fehlt im Ziel-Kanal eine dieser Berechtigungen: „Kanal ansehen“, „Nachrichten senden“ oder „Links einbetten“.
• Die Ping-Rolle existiert nicht mehr – wähle eine neue Rolle oder schalte den Ping aus.

Die genaue Ursache siehst du auf der Moderations-Seite, wenn du mit der Maus über das Abzeichen der Karte „Twitch Live-Benachrichtigung“ fährst – siehe Abzeichen. Nach dem Beheben kann es einen Moment dauern, bis das Abzeichen verschwindet.

Die rote Fehlerzeile

Scheitert eine Live-Meldung, erscheint in Discord nichts. Stattdessen steht der Grund in einer roten Zeile auf der Karte – so, wie Discord ihn liefert, also auf Englisch. Der Kanal bleibt eingeschaltet, und bei jedem Streamstart wird es erneut versucht. Die Zeile bleibt stehen, bis die nächste echte Live-Meldung geklappt hat – auch wenn du den Fehler schon behoben hast. Eine Testnachricht entfernt sie nicht.

Die Knöpfe einer Karte

• Schalter – schaltet die Meldungen ein oder aus. Das geht nur hier; der Editor hat keinen Schalter. Details unter Testen, Einschalten, Entfernen.
• „Nachricht bearbeiten“ öffnet den Editor.
• „Test senden“ schickt sofort eine Testnachricht in den Ziel-Kanal.
• „Mit Twitch verknüpfen“ erscheint nur, solange der Kanal nicht verknüpft ist.
• „Entfernen“ löscht den Eintrag nach einer Rückfrage.

At the top of the page

• Counter – for example “3 of 5 channels used”, next to it your plan in capitals (here “PLUS”).
• “Connect Twitch channel” – locked if your plan allows no further channels. Hover over it to see why: “Premium required” or “Plan limit reached”.
• Without any connected channels you see “No Twitch channel connected yet”.

The cards

Every connected channel has a card – in the order in which you connected them. It shows the profile picture, display name, @login and the status badges. Below that is the target channel and, if the ping is on, the role: “Target channel: #live-streams · Ping: @Stream alert”. “no channel selected” means you still have to choose a channel in the editor. If a long number follows the # instead of a name, the channel has been deleted in Discord.

When “PROBLEM” appears

The card does not say why. It is one of these:

• No target channel is selected.
• The target channel no longer exists – choose a new one in the editor.
• The bot is missing one of these permissions in the target channel: “View Channel”, “Send Messages” or “Embed Links”.
• The ping role no longer exists – choose a new role or switch the ping off.

You can see the exact cause on the moderation page by hovering over the badge of the “Twitch Live Notification” card – see Badges. That tooltip is currently German only. After fixing the cause, it can take a moment until the badge disappears.

The red error line

If a live notification fails, nothing appears in Discord. Instead, the reason is shown in a red line on the card – exactly as Discord returns it, i.e. in English. The channel stays switched on, and every stream start tries again. The line stays until the next real live notification has worked – even if you have already fixed the problem. A test message does not clear it.

The buttons on a card

• Switch – turns the notifications on or off. This only works here; the editor has no switch. Details under Testing, switching on, removing.
• “Edit message” opens the editor.
• “Send test” immediately sends a test message to the target channel.
• “Link with Twitch” only appears while the channel is not linked.
• “Remove” deletes the entry after a confirmation.

Mit „Nachricht bearbeiten“ öffnest du den Twitch Nachrichten-Editor. Oben stehen die Einstellungen, links die Bausteine der Nachricht und darunter die verfügbaren Platzhalter, rechts die Vorschau.

Die Kopfleiste

Speichern

• Nichts wird automatisch gespeichert. „Übernehmen“ in einem Bearbeiten-Fenster ändert nur den Entwurf. Erst „Speichern“ übernimmt alles; der Knopf zeigt dann kurz „Gespeichert!“.
• Verlässt du die Seite mit ungespeicherten Änderungen, fragt der Editor: „Es gibt ungespeicherte Änderungen. Seite trotzdem verlassen?“
• Speichern schaltet nicht ein. Eingeschaltet wird nur in der Übersicht. Ist der Kanal schon eingeschaltet, gilt die neue Fassung ab dem nächsten Streamstart.
• Ohne Ziel-Kanal fragt der Editor: „Es ist kein Ziel-Channel gewählt. Ohne Channel kann der Kanal nicht aktiviert werden. Trotzdem als Entwurf speichern?“
• Wurde der Ziel-Kanal in Discord gelöscht, zeigt die Auswahl wieder „Kanal wählen“. Speichern klappt erst wieder, wenn du einen neuen Kanal gewählt hast.

Die Bausteine

Die Nachricht besteht aus Bausteinen (Discord „Components V2“) – ein klassisches Embed ist es nicht. Über „Komponente hinzufügen“ fügst du Bausteine hinzu. Ihre Namen stehen auch in der deutschen Oberfläche auf Englisch, nur „Twitch-Button“ ist deutsch.

• Bearbeiten: Stift-Symbol. Es öffnet sich das Fenster „… bearbeiten“; Änderungen gelten erst nach „Übernehmen“. Die Esc-Taste schließt es nicht – nimm „Abbrechen“ oder das X.
• Reihenfolge: am Ziehgriff links ziehen – nur innerhalb derselben Ebene.
• In einen Container: über das „+“ am Container. Dort gibt es alle Bausteine außer einem weiteren Container.
• Löschen: Papierkorb-Symbol – ohne Rückfrage.

„Als Spoiler anzeigen (verschwommen)“ beim Container derzeit ohne Wirkung – die Einstellung wird gespeichert, aber weder die Vorschau noch Discord verbergen den Inhalt. Bei Galerie-Bildern funktioniert „Als Spoiler anzeigen“.

Grenzen

Die Zeile über der Liste zeigt, wie viel Platz noch ist – etwa „2/10 Komponenten oben · 10/40 gesamt · 57/4000 Zeichen“. Die Grenzen stammen von Discord:

• 10 Bausteine auf oberster Ebene – die automatische Ping-Zeile und der automatische Button zählen mit.
• 40 Bausteine insgesamt – auch Bausteine in Containern, Section-Bilder, Galerie-Bilder und der Button zählen.
• 4000 Zeichen Text – alle Texte zusammen, Platzhalter so gezählt, wie du sie schreibst.
• Ein Button und 10 Bilder pro Galerie.

Wird eine Grenze überschritten, färbt sich die Zeile rot und ein Hinweis erscheint, etwa „Discord erlaubt höchstens … Komponenten auf oberster Ebene. Rollen-Ping und Twitch-Button zählen mit.“ Der Editor prüft die Grenzen schon beim Hinzufügen; beim Speichern und beim Einschalten prüft THE GRID sie noch einmal.

Meldungen beim Speichern

“Edit message” opens the Twitch Message Editor. The settings are at the top, the building blocks of the message on the left with the available placeholders below them, and the preview on the right.

The header bar

The tooltips of the two tick boxes are German only: „Twitch-Button unter der Nachricht anzeigen“ (show Twitch button below the message) and „Rolle beim Live-Gehen pingen“ (ping role when going live).

Saving

• Nothing is saved automatically. “Apply” in an edit window only changes the draft. Only “Save” stores everything; the button then briefly shows “Saved!”.
• If you leave the page with unsaved changes, the editor asks: “You have unsaved changes. Leave the page anyway?”
• Saving does not switch the channel on. Switching on only happens in the overview. If the channel is already switched on, the new version applies from the next stream start.
• Without a target channel, the editor asks: “No target channel is selected. Without one the channel cannot be activated. Save as a draft anyway?”
• If the target channel has been deleted in Discord, the selection shows “Select channel” again. Saving only works again once you have chosen a new channel.

The building blocks

The message is made of building blocks (Discord “Components V2”) – it is not a classic embed. Add blocks with “Add Component”.

• Edit: pencil icon. The window “Edit …” opens; changes only apply after “Apply”. The Esc key does not close it – use “Cancel” or the X.
• Reorder: drag the handle on the left – only within the same level.
• Into a container: with the “+” on the container. Every block except another container is available there.
• Delete: bin icon – without a confirmation.

“Show as spoiler (blurred)” on a container currently has no effect – the setting is saved, but neither the preview nor Discord hides the content. For gallery images, “Show as spoiler” works.

Limits

The line above the list shows how much room is left – for example “2/10 top-level · 10/40 total · 54/4000 characters”. The limits come from Discord:

• 10 blocks at the top level – the automatic ping line and the automatic button count towards this.
• 40 blocks in total – blocks inside containers, section images, gallery images and the button count as well.
• 4,000 characters of text – all texts combined, with placeholders counted as you type them.
• One button and 10 images per gallery.

If a limit is exceeded, the line turns red and a hint appears, for example “Discord allows at most … top-level components. The role ping and the Twitch button count towards this.” The editor checks the limits when you add blocks; THE GRID checks them again when you save and when you switch the channel on.

Messages when saving

Platzhalter ersetzt THE GRID beim Senden durch die aktuellen Streamdaten. Sie wirken in Text Display, in Section-Zeilen, in Thumbnail-URL und Alt-Text, in Bild-Adresse und Alt-Text einer Galerie sowie in der Beschriftung des Bausteins „Twitch-Button“. In der Beschriftung des automatisch angehängten Buttons bleiben sie wörtlich stehen.

Schreibe sie genau wie unten – mit geschweiften Klammern und derselben Groß- und Kleinschreibung. {StartedAt} oder unbekannte Platzhalter wie {foo} bleiben wörtlich in der Meldung stehen. Im Bearbeiten-Fenster fügen die Platzhalter-Knöpfe sie an der Cursorposition ein.

Wenn Twitch keine Streamdaten liefert

Liefert Twitch auch nach mehreren Versuchen keine Streamdaten, postet THE GRID die Meldung trotzdem – mit Ersatzwerten:

• {title} wird zu „PDEL_Live ist live“ – immer auf Deutsch.
• {game} bleibt leer, {viewers} wird 0.
• {thumbnail} zeigt das Profilbild.
• {startedAt} nimmt die Startzeit, die Twitch gemeldet hat.

Leere Zeilen fallen weg

Enthält eine Zeile Platzhalter und bleibt nach dem Ersetzen nur Deko übrig – Markdown-Zeichen wie ** oder #, Leerzeichen, Emojis oder Ziffern –, lässt THE GRID die Zeile weg. So verschwindet „🎮 **{game}**“, wenn kein Spiel gesetzt ist, und ein allein stehendes {pingrole} bei ausgeschaltetem Ping. „Spielt: {game}“ bleibt dagegen als „Spielt: “ stehen. Eine Section ohne verbleibende Zeile und ein leerer Container entfallen ebenfalls.

Platzhalter in der Vorschau

Der Editor zeigt statt echter Daten Beispielwerte: „Beispiel-Streamtitel“, „Assetto Corsa Competizione“, 128 Zuschauer, „gerade eben“, „Mein Server“ und als Vorschaubild ein THE-GRID-Banner. Ob eine Zeile beim Senden wegfällt, siehst du dort nicht.

THE GRID replaces placeholders with the current stream data when sending. They work in Text Display, in section lines, in the thumbnail URL and alt text, in the image address and alt text of a gallery and in the label of the “Twitch button” block. In the label of the automatically added button they stay as typed.

Type them exactly as below – with curly brackets and the same upper and lower case. {StartedAt} or unknown placeholders such as {foo} stay in the notification as typed. In the edit window, the placeholder buttons insert them at the cursor position.

When Twitch returns no stream data

If Twitch still returns no stream data after several attempts, THE GRID posts the notification anyway – with fallback values:

• {title} becomes „PDEL_Live ist live“ (is live) – always in German.
• {game} stays empty, {viewers} becomes 0.
• {thumbnail} shows the profile picture.
• {startedAt} uses the start time reported by Twitch.

Empty lines are dropped

If a line contains placeholders and nothing but decoration is left after replacing them – Markdown characters such as ** or #, spaces, emojis or digits – THE GRID leaves the line out. That way “🎮 **{game}**” disappears when no game is set, and so does a {pingrole} on its own line when the ping is off. “Playing: {game}”, on the other hand, stays as “Playing: ”. A section without any remaining line and an empty container are dropped as well.

Placeholders in the preview

Instead of real data, the editor shows example values: “Example stream title”, “Assetto Corsa Competizione”, 128 viewers, “just now”, “My Server” and a THE GRID banner as the preview image. You cannot see there whether a line will be dropped when sending.

Ablauf beim Streamstart

1. Der Stream startet. Twitch meldet den Start an THE GRID – wie schnell, liegt bei Twitch.
2. THE GRID wartet etwa 30 Sekunden, damit Titel, Spiel und Vorschaubild bei Twitch bereitstehen, und holt dann die Streamdaten. Fehlen sie noch, fragt THE GRID bis zu dreimal im Abstand weniger Sekunden erneut nach.
3. Die Meldung erscheint bei allen eingeschalteten Einträgen dieses Twitch-Kanals – auf deinem Server und auf jedem anderen, der ihn eingetragen hat.

Die Meldung kommt also etwa 30 Sekunden nach dem Streamstart, selten erst nach rund 50 Sekunden.

So ist die Meldung aufgebaut

• Absender ist der Bot „THE GRID“. Die Meldung besteht aus Bausteinen (Discord „Components V2“) – ein klassisches Embed oder normaler Nachrichtentext ist es nicht.
• Von oben nach unten: die Ping-Zeile (wenn „Rolle pingen“ an ist und kein {pingrole} in der Nachricht steht), deine Bausteine und zuletzt der automatische Button (wenn „Twitch-Button anzeigen“ an ist und es keinen Baustein „Twitch-Button“ gibt).
• Die Standardvorlage ergibt einen Rahmen mit lila Balken: die Überschrift „PDEL_Live ist jetzt live!“, darunter Streamtitel und „🎮 Spiel“ mit kleinem Vorschaubild rechts, eine Trennlinie und den Button „Zum Stream“, der zum Kanal führt.
• In einer Section erscheint das Vorschaubild klein. Groß zeigst du es mit einer Media Gallery und {thumbnail}.

Wer gepingt wird

• Nur die gewählte Ping-Rolle. @everyone, @here, Erwähnungen von Mitgliedern und andere Rollen im Text pingen nie – auch nicht, wenn sie im Streamtitel stehen.
• @everyone lässt sich nicht als Ping-Rolle wählen.
• Darf die Rolle in Discord nicht von allen erwähnt werden, braucht der Bot in der Regel die Berechtigung „Erwähne @everyone, @here und alle Rollen“, damit der Ping ankommt. Das Dashboard prüft das nicht.

Wann keine Meldung kommt

• Streamende: Beim Ende des Streams passiert nichts. Die Meldung bleibt unverändert stehen – sie wird weder bearbeitet noch gelöscht.
• 15 Minuten Pause: Nach einer Meldung ist derselbe Twitch-Kanal 15 Minuten gesperrt, gerechnet ab dem Posten – nicht ab dem Streamende. Startet in dieser Zeit ein neuer Stream, etwa nach einem Verbindungsabbruch, wird er nicht gemeldet. Denselben Stream meldet THE GRID ohnehin nie zweimal.
• Stream läuft schon beim Einschalten: Für diesen Stream kommt keine Meldung, erst beim nächsten Start.
• Ausgeschaltet: Ausgeschaltete Einträge melden nichts.
• Versand gescheitert: Dann erscheint nichts in Discord, der Grund steht rot auf der Karte – siehe Die Übersicht. Die 15-Minuten-Pause beginnt in diesem Fall nicht.

Gut zu wissen

• Ankündigungskanäle: Die Meldung wird nicht automatisch veröffentlicht. Server, die deinem Kanal folgen, sehen sie in der Regel erst, wenn jemand in Discord auf „Veröffentlichen“ klickt.
• Umbenennung bei Twitch: Anzeigename und Login speichert THE GRID beim Verbinden. Benennt sich der Kanal bei Twitch um, zeigen {streamer}, {streamerlogin}, {url} und der Button-Link weiter den alten Namen bzw. die alte Adresse – nur das Profilbild ist aktuell. Abhilfe: Kanal entfernen und neu verbinden; die Nachricht gestaltest du dann neu.
• Sprache: Die Meldung enthält genau deinen Text. Übersetzt wird nichts – anders als bei anderen Bot-Texten richtet sie sich nicht nach der Sprache deines Servers. Nur {startedAt} zeigt Discord jedem Leser in seiner eigenen Sprache.

What happens when a stream starts

1. The stream starts. Twitch reports the start to THE GRID – how fast is up to Twitch.
2. THE GRID waits about 30 seconds so that title, game and preview image are available on Twitch, then fetches the stream data. If they are still missing, THE GRID asks again up to three times, a few seconds apart.
3. The notification appears for every switched-on entry of this Twitch channel – on your server and on every other server that has added it.

So the notification arrives about 30 seconds after the stream starts, occasionally only after around 50 seconds.

How the notification is built

• The sender is the bot “THE GRID”. The notification is made of building blocks (Discord “Components V2”) – it is neither a classic embed nor normal message text.
• From top to bottom: the ping line (if “Ping role” is on and there is no {pingrole} in the message), your blocks and finally the automatic button (if “Show Twitch button” is on and there is no “Twitch button” block).
• The default template produces a frame with a purple bar: the heading „PDEL_Live ist jetzt live!“ (is live now!), below it the stream title and „🎮 Spiel“ (game) with a small preview image on the right, a divider and the button „Zum Stream“ (to the stream), which leads to the channel.
• In a section, the preview image is small. To show it large, use a Media Gallery with {thumbnail}.

Who gets pinged

• Only the selected ping role. @everyone, @here, mentions of members and other roles in the text never ping – not even when they are part of the stream title.
• @everyone cannot be selected as the ping role.
• If the role may not be mentioned by everyone in Discord, the bot usually needs the permission to mention @everyone, @here and all roles for the ping to arrive. The dashboard does not check this.

When no notification is sent

• Stream end: nothing happens when the stream ends. The notification stays as it is – it is neither edited nor deleted.
• 15-minute pause: after a notification, the same Twitch channel is blocked for 15 minutes, counted from posting – not from the end of the stream. If a new stream starts during this time, for example after a lost connection, it is not announced. THE GRID never announces the same stream twice anyway.
• Stream already running when you switch on: there is no notification for this stream, only for the next start.
• Switched off: switched-off entries announce nothing.
• Sending failed: then nothing appears in Discord, and the reason is shown in red on the card – see The overview. In this case the 15-minute pause does not start.

Good to know

• Announcement channels: the notification is not published automatically. Servers that follow your channel usually only see it once someone clicks “Publish” in Discord.
• Renaming on Twitch: THE GRID stores the display name and login when you connect the channel. If the channel is renamed on Twitch, {streamer}, {streamerlogin}, {url} and the button link keep showing the old name or address – only the profile picture is current. Fix: remove the channel and connect it again; you then design the message anew.
• Language: the notification contains exactly your text. Nothing is translated – unlike other bot texts, it does not follow your server's language. Only {startedAt} is shown by Discord to every reader in their own language.

Die Testnachricht

„Test senden“ in der Übersicht und „Testnachricht senden“ im Editor schicken sofort eine Meldung in den gespeicherten Ziel-Kanal – ohne die 30 Sekunden Wartezeit und auch dann, wenn der Kanal ausgeschaltet ist.

• Gesendet wird der gespeicherte Stand. Hast du im Editor ungespeicherte Änderungen, fragt er: „Die Testnachricht verschickt den gespeicherten Stand. Jetzt speichern und dann testen?“
• Ist der Twitch-Kanal gerade live, nutzt der Test die echten Streamdaten. Sonst setzt er Beispielwerte ein: den Titel „Testnachricht aus dem THE GRID Dashboard“, das Spiel „Just Chatting“, 42 Zuschauer, das Profilbild als Vorschaubild und den Sendezeitpunkt als Startzeit.
• Der Test zählt nicht für die 15-Minuten-Pause und entfernt die rote Fehlerzeile auf der Karte nicht.
• Rückmeldung in der Übersicht: „Testnachricht gesendet“ oder „Die Testnachricht konnte nicht gesendet werden.“ mit dem Grund von Discord in Klammern. Ohne Ziel-Kanal: „Bitte zuerst im Editor einen Discord-Channel auswählen.“
• Rückmeldung im Editor: „Testnachricht wurde gesendet.“ oder „Testnachricht konnte nicht gesendet werden:“ mit dem Grund. Ohne Ziel-Kanal zeigt der Editor derzeit nur den Code „no_channel“ – wähle dann einen Kanal und speichere.

Einschalten und Ausschalten

Ein- und ausgeschaltet wird nur mit dem Schalter auf der Karte in der Übersicht. Beim Einschalten prüft THE GRID:

• Ist ein Ziel-Kanal gewählt? Sonst: „Bitte zuerst im Editor einen Discord-Channel auswählen.“
• Ist im Tarif noch Platz? Hier zählen die eingeschalteten Kanäle. Sonst: „Das Limit deines Tarifs ist erreicht.“
• Hält die Nachricht die Grenzen von Discord ein? Sonst nennt ein Hinweis die überschrittene Grenze, etwa die 10 Bausteine auf oberster Ebene.

Klappt alles, erscheint „Kanal aktiviert“. Direkt danach kann das Abzeichen noch „WIRD BESTÄTIGT“ zeigen; sobald Twitch die Anmeldung bestätigt hat, steht dort „AKTIV“. Ob der Bot im Ziel-Kanal schreiben darf, siehst du erst am Abzeichen: Fehlen ihm Rechte, steht dort „PROBLEM“. Wirf nach dem Einschalten also einen Blick auf die Karte.

• Erscheint stattdessen rot „Gespeichert, aber die Twitch-Anmeldung schlug fehl. Sie wird beim nächsten Abgleich wiederholt.“, ist der Kanal trotzdem eingeschaltet; THE GRID versucht die Anmeldung bei Twitch später automatisch erneut. Sofort geht es, wenn du ihn aus- und wieder einschaltest.
• Andere Fehler: „Der Status konnte nicht geändert werden.“ oder „Aktion fehlgeschlagen.“ – lade die Seite neu und versuche es noch einmal.
• Ausschalten („Kanal deaktiviert“): Ab dann meldet der Kanal nichts mehr. Beim Verbinden belegt er aber weiter einen Platz – siehe Tarife.

Entfernen

„Entfernen“ fragt: „Diesen Twitch-Kanal wirklich entfernen? Die Nachricht geht dabei verloren.“ Nach dem Bestätigen sind Eintrag, Nachricht, Einstellungen und eine Verknüpfung mit Twitch weg („Kanal entfernt“), und in deinem Tarif ist wieder ein Platz frei. Bereits gepostete Meldungen bleiben in Discord stehen. Scheitert es, erscheint „Der Kanal konnte nicht entfernt werden.“

The test message

“Send test” in the overview and “Send test message” in the editor immediately send a notification to the saved target channel – without the 30-second wait and even if the channel is switched off.

• The saved version is sent. If you have unsaved changes in the editor, it asks: “The test message sends the saved version. Save now and then test?”
• If the Twitch channel is live right now, the test uses the real stream data. Otherwise it fills in example values: the German title „Testnachricht aus dem THE GRID Dashboard“ (test message from the THE GRID dashboard), the game “Just Chatting”, 42 viewers, the profile picture as the preview image and the time of sending as the start time.
• The test does not count towards the 15-minute pause and does not clear the red error line on the card.
• Feedback in the overview: “Test message sent” or “The test message could not be sent.” with Discord's reason in brackets. Without a target channel: “Please pick a Discord channel in the editor first.”
• Feedback in the editor: “Test message sent.” or an error with the reason. Without a target channel, the editor currently only shows the code “no_channel” – choose a channel and save.

Switching on and off

Channels are only switched on and off with the switch on the card in the overview. When you switch one on, THE GRID checks:

• Is a target channel selected? Otherwise: “Please pick a Discord channel in the editor first.”
• Is there room in your plan? Here the channels that are switched on count. Otherwise: “Your plan limit has been reached.”
• Does the message stay within Discord's limits? Otherwise a notice names the limit that was exceeded, such as the 10 top-level blocks.

If everything is fine, you see “Channel enabled”. Right afterwards the badge may still show “BEING CONFIRMED”; once Twitch has confirmed the sign-up, it says “ACTIVE”. Whether the bot may post in the target channel only shows in the badge: if it is missing permissions, it says “PROBLEM”. So take a look at the card after switching on.

• If you see the red message “Saved, but the Twitch subscription failed. It will be retried on the next reconcile.” instead, the channel is switched on anyway; THE GRID automatically retries the sign-up with Twitch later. To retry right away, switch it off and on again.
• Other errors: “The status could not be changed.” or “Action failed.” – reload the page and try again.
• Switching off (“Channel disabled”): from then on the channel announces nothing. It still takes up a slot for connecting, though – see Plans.

Removing

“Remove” asks: “Really remove this Twitch channel? The configured message will be lost.” Once you confirm, the entry, message, settings and any link with Twitch are gone (“Channel removed”), and a slot in your plan is free again. Notifications that have already been posted stay in Discord. If it fails, you see “The channel could not be removed.”

Damit du nicht unnötig suchst – Stand heute gilt:

• Deutsche Standardtexte, auch im englischen Dashboard: die Standardvorlage („… ist jetzt live!“, „🎮 …“), der Button „Zum Stream“, der Ersatztitel „… ist live“ ohne Streamdaten und der Test-Titel „Testnachricht aus dem THE GRID Dashboard“. Vorlage und Button-Beschriftung ersetzt du durch eigenen Text; Ersatztitel und Test-Titel lassen sich nicht ändern.
• Kaputte Umlaute: Einige deutsche Fehlermeldungen der Übersicht erscheinen derzeit mit verstümmelten Umlauten, zum Beispiel „Ungültiger Twitch-Login.“ statt „Ungültiger Twitch-Login.“ oder „Der Status konnte nicht geändert werden.“. Gemeint ist dasselbe wie in dieser Doku.
• Section ohne Bild: Der Editor lässt eine Section ohne Bild oder mit mehr als drei Zeilen zu. Discord kann die Meldung dann ablehnen – siehe Nachricht gestalten.
• Zeilen nur mit {viewers} fallen immer weg – siehe Platzhalter.
• „Twitch-Button anzeigen“ wirkt nicht, solange ein Baustein „Twitch-Button“ in der Nachricht steht.
• „Als Spoiler anzeigen (verschwommen)“ am Container ist derzeit ohne Wirkung.
• Kein Zurücksetzen: Die Standardvorlage lässt sich nicht per Knopf wiederherstellen, und eine Verknüpfung mit Twitch lässt sich nicht lösen.
• Fehlerzeile bleibt: Die rote Zeile auf der Karte verschwindet erst nach der nächsten erfolgreichen Live-Meldung. Sie zeigt den Text von Discord unverändert auf Englisch.
• Sprachwechsel: Wechselst du im Dashboard die Sprache, erscheinen die Karten der Übersicht erst nach dem Neuladen in der neuen Sprache. Im Editor springen die Felder für Kanal und Rolle dabei optisch auf „Kanal wählen“ und „Rolle wählen“ zurück – deine Auswahl bleibt aber erhalten. Lade die Seite nach dem Wechsel am besten neu.

To save you some searching – this is the current state:

• German default texts, even in the English dashboard: the default template („… ist jetzt live!“ – is live now!, „🎮 …“), the button „Zum Stream“ (to the stream), the fallback title „… ist live“ (is live) without stream data and the test title „Testnachricht aus dem THE GRID Dashboard“. Replace the template and button label with your own text; the fallback title and test title cannot be changed.
• German-only interface parts: the hint „z. B. thegrid“ in the connect window, the hint in the thumbnail URL field, the tooltips of the two tick boxes in the editor and the badges and tooltips on the moderation page.
• Garbled umlauts in German: if you use the dashboard in German, some error messages in the overview currently show garbled umlauts, for example „Ungültiger Twitch-Login.“ instead of „Ungültiger Twitch-Login.“ (invalid Twitch login). The English texts are not affected.
• Section without an image: the editor lets you create a section without an image or with more than three lines. Discord may then reject the notification – see Designing the message.
• Lines with only {viewers} are always dropped – see Placeholders.
• “Show Twitch button” has no effect as long as the message contains a “Twitch button” block.
• “Show as spoiler (blurred)” on a container currently has no effect.
• No reset: the default template cannot be restored with a button, and a link with Twitch cannot be removed.
• The error line stays: the red line on the card only disappears after the next successful live notification. It shows Discord's text unchanged, in English.
• Switching language: if you switch the dashboard language, the cards in the overview only appear in the new language after reloading. In the editor, the channel and role fields visually jump back to “Select channel” and “Select role” – your selection is kept, though. It is best to reload the page after switching.