HelloGuild

HelloGuild ist ein schlankes Addon für World of Warcraft Retail. Es begrüßt Gildenmitglieder automatisch, wenn sie online kommen, und gratuliert ihnen zu Erfolgen. Alle Nachrichten werden ausschließlich im Gildenchat gesendet.

HelloGuild 1.7.0 unterstützt Retail 12.1.0 und führt während des Patchübergangs zusätzlich 12.0.7 (Interface 120100 und 120007).

Funktionen

• zufällige Begrüßungen für online kommende Gildenmitglieder
• zufällige Gratulationen bei Erfolgen von Gildenmitgliedern
• pro Sprache jeweils 120 Fantasy- und 40 lockere Standardtexte für beide Nachrichtentypen
• ausschließlich Lesen und Schreiben im Gildenkontext
• eigene Texte mit dem Platzhalter {name}
• getrenntes Aktivieren und Deaktivieren beider Funktionen
• konfigurierbarer Nachrichtenabstand zum Schutz vor Chat-Spam
• getrennt konfigurierbare Zufallsverzögerungen vor Begrüßungen und Erfolgsgratulationen
• tageszeitabhängige Begrüßungen nach Realm-Zeit: Formulierungen wie „Guten Morgen“, „Good afternoon“ oder „Guten Abend“ werden nur im passenden Zeitfenster ausgewählt und vor einem verspäteten Versand erneut geprüft (Nacht 0–4 Uhr, Morgen 5–11 Uhr, Nachmittag 12–17 Uhr, Abend 18–23 Uhr)
• keine Begrüßungswelle nach Login oder /reload
• der eigene Charakter wird ignoriert
• verschiebbarer Minimap-Button mit gespeichertem Standort
• automatische Anpassung des Buttons an unterschiedlich große runde, quadratische und kombinierte Minimap-Layouts sowie Begrenzung am Bildschirmrand

Bedienung

Die Konfiguration erfolgt im Chat über /hg oder /helloguild. Die bisherigen Befehle /gb und /gildenbegruesser bleiben als Kompatibilitäts-Aliase erhalten. Alternativ befindet sich ein grafisches Menü unter ESC → Optionen → AddOns → HelloGuild. Es lässt sich mit /hg optionen direkt öffnen.

Das Optionsmenü besitzt getrennte Unterseiten für Begrüßungen und Gratulationen. Dort lassen sich Texte direkt auswählen, bearbeiten, sortieren und über eine Sicherheitsabfrage löschen. Eine Vorschau zeigt, wie {name} im Gildenchat ersetzt wird. Eine bestätigungspflichtige Reset-Funktion stellt alle Optionen, Standardtexte und die ursprüngliche Minimap-Position wieder her.

Die Benutzeroberfläche, Hilfetexte und Standardnachrichten werden auf deDE auf Deutsch geladen. Alle übrigen Clientsprachen verwenden Englisch als belastbaren Fallback. Die Sprache der tatsächlich versendeten Begrüßungen und Gratulationen kann im Optionsmenü unabhängig von der Clientsprache auf Deutsch oder Englisch gestellt werden. Beide Sprachlisten werden getrennt gespeichert und bearbeitet; eigene Texte der jeweils anderen Sprache bleiben beim Umschalten erhalten.

Zusätzlich stehen zwei getrennt bearbeitbare Nachrichtenstile bereit: Fantasy verwendet ausführliche atmosphärische Texte, während Locker mit kurzen MMO-üblichen Formulierungen wie „Huhu“, „Heyo“, „GZ“ oder „Gratz“ eher wie eine spontane Nachricht eines Mitspielers wirkt. Sprache und Stil lassen sich unabhängig voneinander wählen; eigene Texte bleiben in jeder Kombination separat erhalten.

Befehl	Wirkung
/hg	Hilfe anzeigen
/hg an / /hg aus	Addon vollständig ein- oder ausschalten
/hg begruessung an|aus	Begrüßungen ein- oder ausschalten
/hg erfolg an|aus	Erfolgsgratulationen ein- oder ausschalten
/hg add begruessung TEXT	eigene Begrüßung hinzufügen
/hg add erfolg TEXT	eigene Gratulation hinzufügen
/hg del begruessung NUMMER	Begrüßung löschen
/hg del erfolg NUMMER	Gratulation löschen
/hg liste	gespeicherte Texte anzeigen
/hg optionen	grafisches Einstellungsmenü öffnen
/hg minimap an|aus	Minimap-Button ein- oder ausblenden
/hg test begruessung|erfolg	zufälligen Text im Gildenchat testen
/hg cooldown SEKUNDEN	Nachrichtenabstand auf 3 bis 120 Sekunden setzen

In eigenen Texten wird {name} durch den Namen des Gildenmitglieds ersetzt:

/hg add begruessung Willkommen zurück, {name}!
/hg add erfolg Stark gemacht, {name} – Glückwunsch!

Die Einstellungen und eigenen Texte werden accountweit in den WoW SavedVariables gespeichert. Im grafischen Menü lassen sich für Begrüßungen und Erfolge jeweils Minimum und Maximum der zufälligen Verzögerung von 0 bis 60 Sekunden festlegen.

Manuelle Installation

1. Das Verzeichnis HelloGuild nach World of Warcraft/_retail_/Interface/AddOns/ entpacken.
2. Prüfen, dass die Datei Interface/AddOns/HelloGuild/HelloGuild.toc existiert.
3. World of Warcraft neu starten oder im Spiel /reload ausführen.

Installation mit WowUp

In WowUp die Funktion Install from URL beziehungsweise Von URL installieren öffnen und folgende Projektadresse einfügen:

https://github.com/InkVeiled/HelloGuild

WowUp installiert dabei das jeweils auf GitHub veröffentlichte Release.

Hinweise

Das Addon benötigt eine Gildenmitgliedschaft. Tests über /hg test ... senden echte Nachrichten in den Gildenchat. Ein kurzer Nachrichtenabstand ist standardmäßig aktiv.

Automatische Chatfunktion und Schutzmaßnahmen

HelloGuild reagiert ausschließlich auf zwei lokale WoW-Ereignisse:

• Ein Mitglied der eigenen Gilde wechselt im Gildenroster von offline zu online.
• Ein Mitglied der eigenen Gilde erhält einen im Gildenkontext gemeldeten Erfolg.

Die daraus erzeugten Nachrichten werden ausschließlich über den WoW-Chattyp GUILD an die eigene Gilde gesendet. Das Addon schreibt weder in öffentliche Kanäle noch in Gruppen-, Schlachtzugs- oder Flüsterchats. Es enthält keine Werbung, keine externe Kommunikation, keine Datensammlung und keine repository- oder accountübergreifende Automatisierung.

Zum Schutz vor unerwünschten oder zu vielen Nachrichten:

• lassen sich Addon, Begrüßungen und Gratulationen jederzeit getrennt deaktivieren,
• gilt ein konfigurierbarer Abstand von mindestens drei Sekunden,
• werden Begrüßungen und Erfolgsgratulationen erst nach einer jeweils konfigurierbaren zufälligen Verzögerung versendet,
• wird der eigene Charakter ignoriert,
• erzeugt ein Login oder /reload keine nachträgliche Begrüßungswelle,
• werden während des Kampf-Lockdowns erkannte Nachrichten bis zum Kampfende zurückgestellt,
• wird Blizzards separater Chat-Messaging-Lockdown vor jedem Versand geprüft; die Warteschlange läuft erst nach Freigabe weiter,
• werden Nachrichten während laufender Encounter und aktiver Mythic+-Schlüssel bis zu einem sicheren Versandzeitpunkt zurückgestellt,
• wird eine wartende Queue nach dem Kampf kurz verzögert erneut geprüft; sind Kampf-, Mythic+- oder Gildendaten noch nicht bereit, erfolgen ausschließlich bei vorhandenen Nachrichten in angemessenen Abständen weitere Versuche,
• bleiben Nachrichten bei kurzzeitig nicht verfügbaren Gildendaten zunächst erhalten, werden aber niemals an eine andere Gilde übertragen,
• gilt eine Nachricht erst nach ihrem eigenen Echo im Gildenchat als gesendet; still von WoW abgelehnte Aufrufe bleiben dadurch in der Warteschlange,
• werden tageszeitabhängige Begrüßungen unmittelbar vor dem Versand erneut geprüft, damit eine lange Warteschlange keine veraltete Anrede versendet,
• verfallen wartende Nachrichten nach zwei Stunden und die Warteschlange ist auf 50 Einträge begrenzt,
• werden dauerhaft fehlgeschlagene oder nicht bestätigbare Sendungen nach fünf begrenzt verzögerten Versuchen verworfen, damit kein endloser Wiederholungs- oder Spam-Pfad entsteht.

Seit Retail 12.x können WoW-Chat- und Gildenrosterwerte zeitweise als geheim markiert sein. HelloGuild wertet solche Werte nicht aus. Bei einem geschützten Gildenerfolg merkt es sich ausschließlich die von Blizzard ausdrücklich freigegebene Chat-Zeilen-ID und fragt den Namen nach Ende der Sperre über die vorgesehene Chat-API erneut ab. Bleibt der Name geschützt oder nicht verfügbar, wird das einzelne Ereignis sicher verworfen. Das Optionsmenü wird während des Kampf-Lockdowns nicht geöffnet; ein Klick wird vorgemerkt und unmittelbar nach dem Kampf einmalig ausgeführt.

Lizenz

MIT