KeystoneWheel

KeystoneWheel sammelt die Mythic+-Schlüssel einer Gruppe und lässt ein animiertes Glücksrad einen davon auswählen. Das Addon ist für World of Warcraft Retail ausgelegt.

Funktionen

• Erkennt den eigenen Mythic+-Schlüssel direkt über die WoW-API.
• Zeigt Oberfläche, Tooltips, Chatmeldungen und Diagnose auf deutschen Clients auf Deutsch und auf englischen Clients auf Englisch an.
• Tauscht Schlüssel mit anderen KeystoneWheel-Nutzern direkt über KSWheel1 und zusätzlich über das gemeinsame LibKS-Protokoll aus.
• Synchronisiert das Ergebnis eines Drehs automatisch mit allen KeystoneWheel-Nutzern in Gruppe, Raid oder Instanzgruppe.
• Vergleicht den sichtbaren Stein-Pool aller erkannten KeystoneWheel-Nutzer und zeigt den Synchronstatus direkt über dem Rad.
• Verwendet vorhandene LibKeystone-Daten, wie sie unter anderem BigWigs und BossHelper bereitstellen.
• Erkennt als Fallback Keystone-Links im Gruppenchat.
• Unterstützt manuell eingefügte Keystone-Links.
• Lässt einzelne Steine per Linksklick ignorieren und wieder zulassen.
• Bietet optional einen rundenweisen Wiederholungsschutz und zeigt die letzten drei Ziehungen kompakt unter dem Rad.
• Zeigt ein animiertes Glücksrad mit kompakten quadratischen Steinkacheln, gut lesbaren Stufen-Badges, hochauflösender Radgrafik, Sound, Konfetti und optionaler Ergebnisnachricht im Gruppenkanal.
• Kann Drehungen auf Gruppenleitung und Assistenzen beschränken oder ein Ergebnis 30 Sekunden besiegeln. Ein vorzeitiger Neudreh benötigt dann eine Mehrheit der erkannten KeystoneWheel-Nutzer.
• Unterstützt reduzierte Animation und eine UI-Skalierung von 75 bis 115 Prozent.
• Bietet beim ausgewählten Dungeon einen Port-Button mit Zaubericon und Cooldown. Noch nicht freigeschaltete Portale werden deaktiviert angezeigt.
• Bietet einen verschiebbaren Minimap-Button, einen Eintrag im Blizzard-Addonfach und Diagnosebefehle.

Die Datenquellen werden pro Spieler in dieser Reihenfolge verwendet:

1. Eigener Schlüssel und direkte Kommunikation mit KeystoneWheel
2. LibKeystone
3. Im Gruppenchat verlinkte Keystone-Items
4. Manuell eingefügte Keystone-Links

KeystoneWheel versucht für Schlüssel, Pool-Status und Dreh-Ergebnisse das eigene Kommunikations-Prefix KSWheel1 zu registrieren. Parallel werden die Sync-Nachrichten über LibKS übertragen. Ist der begrenzte Prefix-Pool durch viele andere Addons bereits voll, bleibt damit der gemeinsam genutzte LibKS-Weg als Fallback erhalten. Doppelt empfangene Nachrichten werden anhand ihrer Kennung zusammengeführt.

Andere LibKeystone-Addons ignorieren die eindeutig markierte KeystoneWheel-Erweiterung, während KeystoneWheel-Nutzer in derselben Gruppe das gleiche Ergebnis sehen.

Installation mit WowUp

1. In WowUp den Bereich Get Addons öffnen.
2. Install from URL auswählen.
3. Die Repository-URL https://github.com/InkVeiled/KeystoneWheel einfügen.
4. Das gefundene Addon importieren und installieren.

WowUp erkennt nach der ersten GitHub-Installation neue getaggte Releases und kann sie automatisch aktualisieren.

Manuelle Installation

1. Die ZIP des neuesten GitHub Releases herunterladen.
2. Das Archiv in World of Warcraft/_retail_/Interface/AddOns/ entpacken.
3. Prüfen, dass die Datei Interface/AddOns/KeystoneWheel/KeystoneWheel.toc existiert.
4. World of Warcraft neu starten oder im Spiel /reload ausführen.

Nicht die von GitHub automatisch angebotene Source code-ZIP verwenden, sondern das Release-Asset KeystoneWheel-vX.Y.Z.zip.

Bedienung

Der Minimap-Button öffnet das Rad mit Linksklick und sammelt die Gruppenschlüssel mit Rechtsklick neu ein. Die Zahl am Button zeigt die aktuell gefundenen Steine.

Dieselben Aktionen stehen im Blizzard-Addonfach am Minimap-Rand zur Verfügung. Der eigene Minimap-Button kann deshalb in den Optionen ausgeblendet werden.

Ein Linksklick auf eine Steinkarte markiert genau diesen Stein als ignoriert. Er bleibt sichtbar, wird aber nicht mehr gezogen. Ein weiterer Linksklick lässt ihn wieder zu. Ändern sich Dungeon oder Stufe des Spielers, gilt der neue Stein automatisch als eigener, nicht ignorierter Kandidat. Chat- und manuelle Einträge können weiterhin mit Rechtsklick entfernt werden.

Nach einem Dreh wird das Ergebnis an andere KeystoneWheel-Nutzer in der Gruppe übertragen. Ist deren Rad geöffnet, springt es auf denselben Stein und zeigt die Ergebnisanimation. Bei geschlossenem Rad erscheint nur eine kurze Chatmeldung; das Fenster wird nicht ungefragt geöffnet.

Ist „Ergebnis posten“ aktiv, dient die normale deutsche oder englische Gruppenmeldung zusätzlich als Notfall-Fallback. Fällt der Addon-Transport aus, ordnet KeystoneWheel Gewinnername und Stufe einem lokalen Stein zu. Trifft die reguläre Synchronisierung ebenfalls ein, wird das doppelte Ergebnis automatisch unterdrückt.

Der Sync-Wert über dem Rad zählt ausschließlich erkannte KeystoneWheel-Nutzer. Ein Klick auf die Statuszeile fragt deren aktuellen Pool erneut ab; der Tooltip zeigt, bei wem Zahl oder Inhalt der Steine abweichen.

Der optionale Wiederholungsschutz pausiert einen gezogenen Stein bis zum Ende der aktuellen Runde. Sobald alle zulässigen Steine einmal gezogen wurden, beginnt automatisch eine neue Runde. Der Verlauf kann über das kleine Schließen-Symbol oder in den Optionen zurückgesetzt werden.

Im Schicksalsmodus bleibt ein Ergebnis 30 Sekunden gesperrt. Ein Klick auf das besiegelte Rad startet vor Ablauf eine Abstimmung. Die eigene Stimme zählt bereits; weitere erkannte KeystoneWheel-Nutzer erhalten einen Zustimmen/Ablehnen-Dialog. Bei einer Mehrheit dreht das Rad des Anfragenden erneut.

Der Port-Button erscheint beim Ergebnis, sobald für den Dungeon ein Teleport-Zauber hinterlegt ist. Ein freigeschalteter Port kann direkt angeklickt werden. Im Kampf wird der geschützte Button vorübergehend ausgeblendet und danach automatisch wiederhergestellt.

Befehle

• /kwheel oder /steinrad: Fenster öffnen oder schließen
• /kwheel drehen: Rad drehen
• /kwheel neu: Gruppendaten neu abfragen
• /kwheel fragen: Gruppe um Keystone-Links bitten
• /kwheel add Spieler [Keystone-Link]: Link manuell hinzufügen
• /kwheel clear: Chat- und manuelle Fallbacks entfernen
• /kwheel minimap: Minimap-Button einblenden und zurücksetzen
• /kwheel minimap off: Minimap-Button ausblenden
• /kwheel optionen: Spielregeln und Darstellung öffnen
• /kwheel verlauf leeren: Verlauf und Wiederholungsrunde zurücksetzen
• /kwheel debug: Diagnosebericht und erneute Abfrage starten
• /kwheel debug on oder off: Live-Protokoll ein- oder ausschalten

Releases

Kurzfristige Änderungen werden zuerst lokal gesammelt und gemeinsam im Spiel getestet. Version, Commit, Tag und Push erfolgen erst, wenn der gesamte Release Candidate freigegeben ist. Der verbindliche Ablauf steht in der Release-Checkliste. Die lokale Paketprüfung kann ohne Commit oder Upload ausgeführt werden:

powershell -ExecutionPolicy Bypass -File .\tools\Test-Release.ps1

Ein Tag im Format v1.2.3 startet den Workflow .github/workflows/release.yml. Vor dem Taggen muss die Zeile ## Version: in KeystoneWheel.toc dieselbe Version ohne führendes v enthalten.

Beispiel:

git tag v1.2.3
git push origin v1.2.3

Der Workflow:

1. prüft das Tagformat und die TOC-Version,
2. erzeugt KeystoneWheel-v1.2.3.zip,
3. prüft KeystoneWheel/KeystoneWheel.toc im Archiv und
4. übernimmt den passenden Eintrag aus dem Changelog und
5. erstellt daraus das GitHub Release.

Lizenz

KeystoneWheel steht unter der MIT-Lizenz.

Die Zuordnung der Dungeon-Teleporte wurde mit DungeonTeleport abgeglichen, das ebenfalls unter der MIT-Lizenz veröffentlicht wird.