Häufige Fragen zur World of Warcraft Raider.io Extension für Streamer.bot — Raider.io Charakter-Lookup direkt im Twitch-Chat mit optionalem OBS-Overlay. Wenn du hier keine Antwort findest, komm gerne auf den Discord Server dort gibt es einen eigenen Support-Channel für diese Extension.

Allgemein

Was macht die Extension?

Die Extension fügt deinem Twitch-Chat den Command !rio <Charakter> <Realm> hinzu. Beim Aufruf werden die Daten direkt bei Raider.IO abgefragt und übersichtlich im Chat ausgegeben inklusive Mythic+ Score, Item Level, Klassen-Rank, Raid-Progression und höchstem getimten Schlüssel. Optional werden die Daten parallel in einem animierten OBS-Overlay angezeigt.

Welche Voraussetzungen brauche ich?

Streamer.bot in Version 0.2.x oder neuer und eine Internetverbindung. Für das optionale Overlay zusätzlich OBS Studio.

Funktioniert die Extension auf US-Servern?

Aktuell ist die Extension auf EU-Region begrenzt.

Welche Daten kann ich im Chat anzeigen lassen?

Jedes Ausgabefeld lässt sich einzeln ein- oder ausschalten, über Set-Argument-Sub-Actions steuerst du was dir wichtig ist. Verfügbar sind: Spezialisierung & Klasse, Item Level, M+ Gesamt-Score, Score-Aufschlüsselung nach Tank/Heal/DPS, höchster getimter Mythic + Key, Class-Rank (Realm & World) und Raid-Progression mit AOTC/CE-Tag.

Verwendung im Chat

Wie rufe ich den Command richtig auf?

Das Format ist !rio <Charaktername> <Realm> — Beispiele: !rio Myxal Antonidas, !rio Vexi Die Aldor oder !rio Thrall Blackmoore. Bei Realms mit mehreren Wörtern (wie „Die Aldor“) einfach mit Leerzeichen schreiben.

Wer darf den Command benutzen?

Standardmäßig jeder Zuschauer. Über die Command-Einstellungen in Streamer.bot kannst du den Zugriff aber einschränken zum Beispiel nur Subscriber, nur VIPs oder nur Moderatoren. Ein Cooldown pro User (etwa 30 Sekunden) ist empfehlenswert, damit der Chat nicht von Lookups geflutet wird.

Was passiert wenn ein Charakter keine M+ Runs hat?

Felder ohne Daten werden entsprechend formatiert ausgegeben. Hat der Charakter keinen Score in der aktuellen Season, erscheint dort eine Null oder der Wert wird übersprungen. Bei Raid-Progression ohne Fortschritt wird der Raid als „not started“ markiert.

OBS-Overlay

Wie richte ich das Overlay ein?

In Streamer.bot unter Servers/Clients den WebSocket-Server aktivieren (Standard-Port 8080). Die mitgelieferte wow-overlay.html irgendwo lokal speichern und in OBS als Browser-Quelle einbinden — Größe min. 500×500 Pixel bzw. Leinwandgröße (1920×1080) wenn du das Position Argument nutzt. Sobald im Chat ein !rio Command ausgeführt wird, erscheint die Card animiert im Overlay.

Das Overlay nutzt den gleichen Port wie die !pvp Extension passt das?

Ja, das ist Absicht. Die wow-overlay.html ist universell für beide Extensions eine einzige Browser-Quelle in OBS reicht, sie zeigt RIO und PvP Cards gleichermaßen an. Wenn mehrere Lookups kurz hintereinander ausgeführt werden, landen sie in einer Queue und werden nacheinander angezeigt.

Kann ich die Position des Overlays ändern?

Ja. Über das Argument rio_overlayPosition lässt sich die Position steuern: bottom-left (Standard), bottom-right, top-left oder top-right. Die Position wird direkt beim Einblenden der Card berücksichtigt.

Kann ich nur Chat oder nur Overlay nutzen?

Ja, beides lässt sich einzeln an- und abschalten. Die Arguments rio_showChat und rio_showOverlay sind unabhängig voneinander. So kannst du zum Beispiel nur die schicke Overlay-Card zeigen ohne dass der Chat mit Textausgaben zugepflastert wird.

Fehlerbehebung

„Character not found“

Der Realm-Slug passt nicht. Raider.io erwartet Realms im Slug-Format — „Die Aldor“ wird intern zu die-aldor, „Der Rat von Dalaran“ zu der-rat-von-dalaran. Die Extension macht die Umwandlung automatisch, aber wenn der Charaktername falsch geschrieben ist oder der Char inaktiv ist, kann Raider.io ihn nicht finden. Einfach direkt auf raider.io prüfen, ob der Char dort existiert.

Das Overlay zeigt nichts an

Drei typische Ursachen: Erstens, der WebSocket-Server in Streamer.bot ist nicht aktiv. Unter Servers/Clients → WebSocket Server prüfen ob ein grüner Status angezeigt wird. Zweitens, der Port im Overlay stimmt nicht mit dem in Streamer.bot überein. Im Overlay-Code steht der Default Port WS_PORT = 8080, beides muss identisch sein. Drittens, die OBS Browser Quelle muss sichtbar und nicht versteckt sein, und in der aktiven Szene liegen.

Rate Limit – was ist die Grenze bei Raider.io?

Raider.IO begrenzt auf etwa 300 Anfragen pro Minute pro IP. Für Chat-Commands völlig unproblematisch — selbst ein sehr aktiver Chat erreicht das nicht. Falls doch ein Rate Limit zuschlägt (HTTP 429), wird eine entsprechende Meldung im Chat ausgegeben und der nächste Aufruf klappt nach kurzer Wartezeit wieder.

Mein Problem steht hier nicht wo bekomme ich Hilfe?

Im Vexi’s World Discord gibt es einen eigenen Support-Channel für die Extension. Dort kannst du auch Bugs oder Feature-Wünsche direkt einreichen.

Weitere Fragen? Frag direkt auf dem Discord Server.