StayClose

StayClose ist ein kleines Addon fuer World of Warcraft Retail. Es richtet sich an Tanks und Schadensklassen in Gruppen und Schlachtzuegen und warnt lokal, wenn kein Heiler mehr sicher erreichbar ist. Spieler mit Heilerrolle erhalten keine automatische Warnung.

Der aktuelle lokale Stand ist fuer World of Warcraft Retail 12.0.7 (Interface 120007) vorgesehen.

Funktionen

• Ueberwacht eingeteilte Heiler in Gruppen, Schlachtzuegen und PvP-Instanzen.
• Ist standardmaessig nur im Kampf aktiv.
• Unterscheidet zwischen:
  • Heiler ausser Reichweite,
  • nicht sicher erreichbaren Heilern,
  • sicher toten oder getrennten Heilern,
  • einer Gruppe ohne eingeteilte Heilerrolle.
• Wartet standardmaessig 1,2 Sekunden, bevor eine Warnung erscheint.
• Blendet die Warnung erst nach einer stabilen Entwarnungsphase aus.
• Verwendet getrennte Reichweiten fuer Gruppe, Schlachtzug und PvP.
• Zeigt den Namen und die Entfernung des naechsten Heilers, wenn WoW diese Informationen zugaenglich macht.
• Nutzt LibRangeCheck-3.0 und faellt bei Bedarf auf WoW-eigene Reichweitendaten zurueck.
• Bietet eine native WoW-Einstellungsseite, einen klassischen verschiebbaren Minimap-Button, ein verschiebbares Warnfenster, mehrere Warntoene, Skalierung und Transparenz.
• Zeigt deutsche Texte auf deutschen Clients und englische Texte auf allen anderen Clients.
• Fuehrt optional eine rein lokale Kampfzusammenfassung. Sie wird nur auf Anforderung im eigenen Chat ausgegeben.

Ausloeser und Begrenzungen

StayClose prueft nur, wenn das Addon aktiviert ist, der Spieler lebt, sich in einer Gruppe befindet und keine Heilerrolle besitzt. Standardmaessig muss der Spieler zusaetzlich im Kampf sein.

Midnight kann Kampfinformationen als geschuetzte oder nicht auswertbare Werte bereitstellen. StayClose trifft aus solchen Werten keine Warnentscheidung und bleibt in diesem Fall neutral. Exakte Namen und Distanzen erscheinen daher nur, wenn der Client sie sicher zur Verfuegung stellt. Rohdaten aus UnitPosition werden im Combat Lockdown nicht fuer eigene Distanzberechnungen verwendet.

Der Warnton wird standardmaessig einmal pro neuem Vorfall abgespielt. Eine Wiederholung ist optional und durch ein einstellbares Mindestintervall begrenzt. StayClose sendet keine automatischen Gruppen-, Schlachtzug- oder Netzwerknachrichten und fuehrt keine Spielaktionen aus.

Einstellungen

Die Einstellungsseite ist erreichbar ueber:

• Escape -> Optionen -> AddOns -> StayClose
• /stayclose options
• /sc options
• den Addon-Knopf im WoW-Addonfach
• Linksklick auf den klassischen StayClose-Minimap-Button

Verfuegbar sind:

• Aktivierung und Kampfmodus
• Sound, Soundauswahl, Wiederholung und Wiederholintervall
• optionale Warnungen fuer ausgefallene oder fehlende Heilerrollen
• getrennte Gruppen-, Schlachtzug- und PvP-Reichweiten
• Warn-, Entwarnungs- und Pruefintervall
• Skalierung, Transparenz, Positionssperre und Positionsreset
• Minimap-Button ein- oder ausblenden, seinen Abstand fein einstellen und seine Position zuruecksetzen
• Testwarnung und lokale Kampfzusammenfassung
• bestaetigter Komplettreset fuer Einstellungen, Positionen und Berichtsdaten

Zum Verschieben die Positionssperre deaktivieren und das eingeblendete Warnfenster mit der linken Maustaste ziehen.

Der Minimap-Button laesst sich auf einer festen Kreisbahn um die Minimap ziehen. Linksklick oeffnet die Einstellungen, Rechtsklick zeigt die Testwarnung. Der Abstand der Kreisbahn kann in den Einstellungen fein angepasst werden.

Slash-Befehle

Alle Befehle funktionieren mit /stayclose und kurz mit /sc.

Befehl	Funktion
/stayclose on	Addon aktivieren
/stayclose off	Addon deaktivieren
/stayclose toggle	Aktivierung umschalten
/stayclose status	Aktuelle Einstellungen und aktiven Kontext anzeigen
/stayclose options	WoW-Einstellungsseite oeffnen
/stayclose test	Warnfenster testen
/stayclose debug	Zugaengliche Heiler- und Reichweitendaten ausgeben
/stayclose report	Aktuelle oder letzte lokale Kampfzusammenfassung
/stayclose range <distanz>	Alle drei Kontextreichweiten setzen
/stayclose party <distanz>	Gruppenreichweite setzen
/stayclose raid <distanz>	Schlachtzugreichweite setzen
/stayclose pvp <distanz>	PvP-Reichweite setzen
/stayclose delay <sekunden>	Warnverzoegerung setzen
/stayclose recovery <sekunden>	Entwarnungsverzoegerung setzen
/stayclose interval <sekunden>	Pruefintervall setzen
/stayclose sound on|off	Warnton ein- oder ausschalten
/stayclose combat on|off	Warnungen auf den Kampf beschraenken
/stayclose minimap on|off|reset	Minimap-Button anzeigen, ausblenden oder wiederherstellen

Distanzbezeichnung

Englische Clients zeigen yd, andere Clients m. Diese Anzeige lokalisiert nur die Bezeichnung; die von WoW gelieferten Reichweitenwerte werden nicht umgerechnet.

Gespeicherte Daten

StayCloseDB wird accountweit gespeichert. Enthalten sind nur Einstellungen, Fenster- und Minimap-Position sowie die Zahlen der letzten lokalen Kampfzusammenfassung. Namen, GUIDs, Chat-Inhalte und exakte Positionsdaten werden nicht dauerhaft gespeichert. Beschaedigte oder ungueltige Werte werden beim Laden defensiv auf sichere Grenzen beziehungsweise Standardwerte zurueckgesetzt.

Der Komplettreset befindet sich unter StayClose -> Werkzeuge und verlangt vor dem Loeschen der Einstellungen und Berichtsdaten eine Bestaetigung.

Abhaengigkeiten und Lizenzen

LibStub, CallbackHandler-1.0 und LibRangeCheck-3.0 werden eingebettet mitgeliefert; eine separate Installation ist nicht erforderlich. Herkunft, Revisionen, Lizenzen und lokale Anpassungen stehen in THIRD_PARTY_NOTICES.md. Die zugehoerigen Lizenztexte liegen unter LICENSES.

Das Symbol und die Warntoene werden ueber von Blizzard bereitgestellte In-Game-Ressourcen referenziert. Es werden keine extrahierten Spieldateien mitgeliefert.

Bekannte Einschraenkungen

• Nicht lesbare oder geheime Midnight-Werte werden nicht ausgewertet. Dadurch kann StayClose in einzelnen Kampfsituationen neutral bleiben, statt eine moeglicherweise falsche Warnung zu erzeugen.
• Reichweiten sind Schaetzungen der jeweils zugaenglichen WoW- und LibRangeCheck-Pruefungen.
• Das Addon trifft keine Spielaktionen, sendet keine Nachrichten und ersetzt nicht die eigene Situationsentscheidung des Spielers.

Installation mit WowUp

1. In WowUp den Bereich zum Installieren ueber eine URL oeffnen.
2. https://github.com/InkVeiled/StayClose eingeben.
3. StayClose installieren und World of Warcraft neu starten.

Manuelle Installation

1. Die aktuelle StayClose-v<VERSION>.zip aus den GitHub-Releases herunterladen.
2. Die ZIP nach _retail_/Interface/AddOns/ entpacken.
3. Kontrollieren, dass _retail_/Interface/AddOns/StayClose/StayClose.toc vorhanden ist.
4. World of Warcraft neu starten oder im Spiel /reload eingeben.

Lizenz

Der eigene StayClose-Code steht unter der MIT-Lizenz. Eingebettete Fremdbestandteile behalten ihre jeweils dokumentierten Lizenzen.

Spielerrelevante Aenderungen werden im CHANGELOG.md dokumentiert.