Die Extension fügt deinem Twitch-Chat den Command !pvp <Charakter> <Realm> hinzu. Abgefragt wird die offizielle Blizzard API — die Ausgabe enthält Spec, Klasse, Item Level, Honor Level und alle aktuellen PvP-Ratings: 2v2, 3v3, Solo Shuffle (spec-spezifisch), Blitz (spec-spezifisch) und RBG, jeweils mit Win/Loss-Statistik. Parallel lässt sich eine animierte Card im OBS-Overlay einblenden.

Blizzard verlangt eine App-Authentifizierung für jede API-Nutzung. Wenn ich in der Extension ein zentrales Credential ausliefern würden, würden alle Nutzer zusammen dessen Rate Limit teilen und bei Missbrauch wäre das Credential sofort weg. Mit eigenen Credentials hast du deine eigenen Rate Limits (36.000 Anfragen pro Stunde, das reicht locker) und bist auf niemanden angewiesen. Der Setup dauert ~5 Minuten und ist einmalig.

Streamer.bot in Version 0.2.x oder neuer, einen kostenlosen Battle.net Developer Account und eine Internetverbindung. Für das optionale Overlay zusätzlich OBS Studio.

Aktuell ist die Extension auf die EU-Region begrenzt.

Auf develop.battle.net mit deinem normalen Battle.net-Account einloggen. Oben auf „API Access“ klicken, dann „Create Client“. Beim Formular einen beliebigen Namen vergeben (zum Beispiel „StreamerBot PvP“), als Redirect URI http://localhost eintragen und die Checkbox „I do not have a service URL for this client“ anhaken. Nach dem Speichern bekommst du Client ID und Client Secret angezeigt.

Sofort im Developer Portal den Client bearbeiten und auf „Regenerate Secret“ klicken. Der alte Secret wird invalidiert. Danach den neuen Secret in Streamer.bot eintragen. Deswegen: Niemals Client Secret in Screenshots oder Logs posten.

Blizzard erlaubt 36.000 API-Anfragen pro Stunde pro Client. Ein einzelner !pvp Aufruf erzeugt etwa 6 bis 10 API-Requests (Profil, deutsches Profil, PvP-Summary, 5 Brackets). Das Limit ist praktisch nicht erreichbar.

In Streamer.bot unter Actions & Queues -> Actions -> WoW PvP Stats Request -> Sub Actions findest du diese Zwei Variablen, dort fügst du deine Client ID und dein Client Secret ein.

Variable 1:

• Name: blizz_clientId
• Value: deine Client ID

Variable 2:

• Name: blizz_clientSecret
• Value: dein Client Secret

Format: !pvp <Charaktername> <Realm> — zum Beispiel !pvp Myxal Antonidas, !pvp Vexel Die Aldor oder !pvp Thrall Blackmoore. Bei Realms mit mehreren Wörtern (wie „Die Aldor“) einfach mit Leerzeichen schreiben.

Brackets ohne Rating werden automatisch ausgeblendet du siehst also nur die Brackets in denen der Charakter diese Season tatsächlich gespielt hat. Das hält die Chat-Ausgabe kompakt und verhindert unnötiges Scrollen, wenn jemand nur 2v2 spielt aber kein 3v3 oder Shuffle.

Standardmäßig jeder Zuschauer. In den Command-Einstellungen von Streamer.bot kannst du das einschränken zum Beispiel nur Subs, nur VIPs oder nur Mods. Ein Cooldown pro User (30-60 Sekunden) ist empfehlenswert, damit der Chat nicht geflutet wird.

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 !pvp ausgeführt wird, erscheint eine Card in der passenden Farbe der Fraktion.

Ja. Die wow-overlay.html ist universell — eine einzige Browser-Quelle in OBS zeigt sowohl RIO- als auch PvP-Cards an. Werden mehrere Lookups kurz hintereinander aufgerufen, landen sie in einer Queue und werden nacheinander eingeblendet.

Ja. Die Arguments pvp_showChat und pvp_showOverlay sind unabhängig voneinander. Wenn du nur die Overlay-Card möchtest, setze pvp_showChat auf false oder umgekehrt.

Blizzard lehnt die Authentifizierung ab. Drei typische Ursachen: Client ID oder Secret falsch eingetragen (etwa mit Leerzeichen oder Zeilenumbruch) oder der Client im Developer Portal wurde gelöscht oder regeneriert. Argumente in Streamer.bot prüfen und bei Bedarf neu setzen.

Der Realm-Slug oder der Name stimmt nicht. Deutsche Realms mit Sonderzeichen werden von der Extension automatisch umgewandelt („Die Aldor“ → die-aldor), aber bei Tippfehlern im Namen oder bei inaktiven Charakteren meldet die API einen Not-Found-Fehler. Einfach auf worldofwarcraft.blizzard.com prüfen, ob der Char dort existiert.

Blizzard aktualisiert PvP-Stats nicht in Echtzeit — es kann 5 bis 30 Minuten nach einem Match dauern bzw. manchmal einen Relog erfordern, bis die neuen Werte in der API auftauchen. Wenn ein Char gerade frisch geranked ist, einfach etwas warten und nochmal abfragen.

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.

>

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