World of Warcraft PvP Extension · Installation Guide

Diese Anleitung führt dich Schritt für Schritt durch die Installation und Einrichtung der World of Warcraft PvP Extension. Plane etwa 10 bis 15 Minuten ein — der Hauptteil geht auf die einmalige Einrichtung der Blizzard API Credentials. Wenn du unterwegs Fragen hast, schau dir die FAQ an, solltest du darüber hinaus noch Fragen haben findest du auf meinem Discord Server einen Support-Channel.

Voraussetzungen
  • Streamer.bot in Version 0.2.x oder neuer
  • Ein kostenloser Battle.net Developer Account
  • Optional: OBS Studio für das Overlay
01

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 im Actions-Tab eine neue Action namens WoW PvP Stats Request und im Commands-Tab einen !pvp Command der damit verknüpft ist.

Der Command wird beim Importieren automatisch Deaktiviert und muss vorher Aktiviert werden. Wenn du ihn später deaktivieren oder auf bestimmte User-Rollen beschränken willst, geht das direkt im Commands-Tab in Streamer.bot.
02

Blizzard API Credentials erstellen

Öffne das Blizzard Developer Portal und melde dich mit deinem normalen Battle.net-Account an — kein extra Account nötig, es funktioniert der gleiche den du auch für WoW nutzt.

Oben auf „API Access“ klicken, dann auf „Create Client“. Im Formular folgende Werte eintragen:

  • Client Name: frei wählbar, zum Beispiel „StreamerBot PvP“
  • Redirect URIs: http://localhost
  • Checkbox „I do not have a service URL for this client“ anhaken
  • Intended Use: kurz beschreiben wozu — „Twitch chat command for WoW character lookup“ reicht

Auf „Save“ klicken — du landest auf der Client-Übersichtsseite mit deiner neuen Client ID und Client Secret. Beide kopieren und sicher aufbewahren.

Achtung: Client Secret niemals öffentlich posten oder in Screenshots zeigen. Wer damit spielen kann, kann deine Rate Limits verbrauchen oder API-Missbrauch betreiben.
03

Credentials in Streamer.bot hinterlegen

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
04

Ausgabe konfigurieren (optional)

Standardmäßig werden Chat und Overlay aktiviert. Wenn du das anpassen willst, öffne die WoW PvP Stats Request Action und passe die Set-Argument-Sub-Actions oben an:

  • pvp_showChat — Chat-Ausgabe an/aus (Standard: true)
  • pvp_showOverlay — Overlay-Card an/aus (Standard: true)
  • pvp_overlayPosition — bottom-left, bottom-right, top-left oder top-right

Wenn du nur die Overlay-Card ohne Chat-Flut willst, setze einfach pvp_showChat auf false.

05

Ersten Test im Chat

Streamer.bot mit Twitch verbunden? Dann direkt im Chat aufrufen:

!pvp Charaktername Servername

Die Ausgabe sollte etwa so aussehen (nur Brackets mit Rating werden angezeigt):

⚔️ Myxal-antonidas | Frost Mage | ilvl 639 | Honor 342 | 2v2 1833 (47W/29L) | 3v3 2102 (62W/41L) | Shuffle 1924 (31W/27L)

Klappt’s? Dann ist die Basis-Installation fertig.

Blizzard aktualisiert PvP-Stats nicht in Echtzeit — es kann 5 bis 30 Minuten nach einem Match dauern und ggfs. einen Relog erfordern, bis neue Werte in der API auftauchen. Das ist normal.
06

Optional: OBS-Overlay einrichten

Dieser Schritt ist optional — wenn dir die Chat-Ausgabe reicht, kannst du ihn überspringen.

Das Overlay ist eine animierte Card die beim Command-Aufruf eingeblendet wird. Sie ist universell — die gleiche HTML-Datei wird auch von der World of Warcraft Raider.io Extension genutzt, falls du die ebenfalls einsetzt.

Einrichten in drei Schritten:

  • In Streamer.bot unter Servers/Clients → WebSocket Server den Server aktivieren (Standard-Port 8080)
  • Die mitgelieferte wow-overlay.html irgendwo lokal speichern (zum Beispiel in einem Stream-Assets-Ordner)
  • In OBS eine neue Browser-Quelle anlegen, „Lokale Datei“ aktivieren und die HTML auswählen. Die Größe sollte auf Leinwandgröße gestellt werden, das wird bei den meisten Breite 1920, Höhe 1080 sein
Nutzt du einen anderen Port als 8080? Dann musst du die Variable WS_PORT mit einem Editor ganz oben in der wow-overlay.html Datei entsprechend anpassen — Streamer.bot und Overlay müssen identisch sein, sonst kommt keine Verbindung zustande.
07

Optional: Overlay-Position und Sichtbarkeit steuern

Standardmäßig erscheint die Card unten links. Über Arguments in der WoW Raider.io Request Action lässt sich das anpassen:

  • rio_showOverlay — Overlay an/aus (Standard: true)
  • rio_overlayPosition — bottom-left, bottom-right, top-left oder top-right

Wenn du das Overlay komplett nutzen, aber keine Chat-Ausgabe willst, setze einfach rio_showChat auf false. Umgekehrt genauso.

✓

Fertig — deine Extension läuft

AbViel Spaß beim Streamen.

Zur FAQ Support auf Discord Zurück zur Übersicht