GildenGZ

**German description below! / Deutsche Beschreibung unterhalb der Englischen!

Automatic congratulations in guild chat on level-ups — with style!**

GildenGZ automatically posts funny, randomized congratulation messages in guild chat whenever a guild member reaches a new level. No level-up goes uncelebrated!

Note: This addon's messages and UI are in German. Custom messages can be written in any language.
Future Updates may have english UI too and/or "phrases packs" for other languages.

Features

Server-Wide Level Tracking

GildenGZ uses the guild roster API to detect level-ups of all guild members — regardless of where they are in the world. Whether your guildmate is grinding in Winterspring, Nagrand, or Shadowmoon Valley: the addon will notice.

50 Built-In Messages

From epic to absurd, there's something for everyone. Some highlights:

• "Grrrglrlgrrrlglrl [Name] grglgl [Level] (That's Murloc for: GZ on the level-up!)"
• "OMG! [Name] JUST REACHED LEVEL [Level]!!! HOW INSANE IS THAT??? GZ!!!"
• "/kneel We are not worthy! [Name] has reached level [Level]! GZ to our hero!"
• "Breaking News from Azeroth: [Name] has reached level [Level]! Reporters on the scene confirm: No experience points were harmed during this level-up. GZ!"
• …and 46 more!

Add Your Own Messages

You can create, edit, and delete custom messages via chat commands or through the graphical options menu. Simply use NAME and LEVEL as placeholders — order doesn't matter, you can even use them multiple times.

No Spam, No Duplicate Posting

• Anti-Repeat: The last 5 used messages won't be selected again
• Anti-Spam: Only a single player in the guild posts the GZ messages — the highest-ranking online character. If ranks are tied, alphabetical order decides
• Message Queue: If multiple guild members level up at the same time, messages are sent with staggered delays
• Natural Delay: Each message is posted with a random 2–5 second delay so it doesn't feel like a bot

Poster Status Display

On login, a system message tells you whether you are the active GZ poster. If the current poster goes offline, the next player takes over automatically — and you'll be notified when your status changes.

Graphical Options Menu

Full GUI for managing messages, accessible via /ggz options or ESC → Interface → AddOns → GildenGZ:

• Scrollable list of all messages with color coding (default vs. custom)
• Click to select and preview messages
• Double-click or button to edit with live preview
• Create, delete, reset — all within the GUI
• Validation: Messages without NAME or LEVEL placeholders are rejected

Chat Commands

How Does the Level Tracking Work?

GildenGZ requests updated guild roster data from the server every 15 seconds (safely above Blizzard's 10-second throttle). On each update, all member levels are compared against the previous snapshot. If a level increases, a GZ message is triggered.

This means: In the worst case, it takes about 15 seconds for a level-up to be detected — but it works reliably server-wide, no matter where the guild member is located.

FAQ

Can I fully customize the messages? Yes! Use NAME as a placeholder for the player's name and LEVEL for the reached level. Order and frequency don't matter.

What happens if multiple guild members have the addon installed? No problem — only the highest-ranking online player will post. Everyone else stays silent until the status changes.

Does the addon congratulate itself? No, your own level-ups are ignored.

I got new default messages after an update — how do I load them? Type /ggz reset to restore the message list to the new defaults. Note: Custom messages will be lost.

German description / Deutsche Beschreibung

GildenGZ

Automatische Glückwünsche im Gildenchat bei Level-Ups — mit Stil!

GildenGZ postet automatisch lustige, zufällige Glückwunsch-Nachrichten im Gildenchat, sobald ein Gildenmitglied ein neues Level erreicht. Kein Levelup bleibt ungefeiert!

Features

Serverweites Level-Tracking

GildenGZ nutzt die Gilden-Roster-API, um Level-Ups aller Gildenmitglieder zu erkennen — unabhängig davon, wo sie sich in der Welt befinden. Ob dein Gildenkollege in Winterquell, Nagrand oder Schattenmondtal grindet: Das Addon bemerkt es.

50 vorinstallierte Sprüche

Von episch bis absurd ist alles dabei. Einige Highlights:

• "Grrrglrlgrrrlglrl [Name] grglgl [Level] (Das ist Murlocsprache und heißt GZ zum Levelup!)"
• "OMG! [Name] HAT GERADE STUFE [Level] ERREICHT!!! WIE KRANK IST DAS BITTE??? GZ!!!"
• "/knien Wir sind nicht würdig! [Name] hat Level [Level] erreicht! GZ an unseren Helden!"
• "Meinen herzlichen Glühstrumpf [Name] zu Level [Level]! Jetzt ist dein XP Balken wieder leer."
• …und 46 weitere!

Eigene Sprüche hinzufügen

Du kannst eigene Sprüche per Chat-Befehl oder über das grafische Optionsmenü erstellen, bearbeiten und löschen. Verwende einfach NAME und LEVEL als Platzhalter — die Reihenfolge ist egal, du kannst sie sogar mehrfach verwenden.

Kein Spam, kein Doppelposting

• Anti-Wiederholung: Die letzten 5 verwendeten Sprüche werden nicht erneut ausgewählt
• Anti-Spam: Nur ein einziger Spieler in der Gilde postet die GZ-Nachrichten — der ranghöchste Online-Charakter. Bei Gleichrang entscheidet das Alphabet
• Nachrichten-Queue: Leveln mehrere Gildenmitglieder gleichzeitig, werden die Nachrichten zeitversetzt gepostet
• Natürliche Verzögerung: Jede Nachricht wird mit einer zufälligen Verzögerung von 2–5 Sekunden gepostet, damit es nicht wie ein Bot wirkt

Poster-Status-Anzeige

Beim Login wird per Systemnachricht angezeigt, ob du der aktive GZ-Poster bist. Geht der aktuelle Poster offline, übernimmt automatisch der Nächste — und du wirst benachrichtigt, wenn sich dein Status ändert.

Grafisches Optionsmenü

Vollwertiges GUI zum Verwalten der Sprüche, erreichbar über /ggz options oder ESC → Interface → AddOns → GildenGZ:

• Scrollbare Liste aller Sprüche mit farblicher Unterscheidung (Standard vs. Eigene)
• Sprüche per Klick auswählen und Vorschau anzeigen
• Doppelklick oder Button zum Bearbeiten mit Live-Vorschau
• Erstellen, Löschen, Zurücksetzen — alles im GUI
• Validierung: Sprüche ohne NAME- oder LEVEL-Platzhalter werden abgelehnt

Chat-Befehle

Wie funktioniert das Level-Tracking?

GildenGZ fordert alle 15 Sekunden aktualisierte Gildenroster-Daten vom Server an (sicher über dem 10-Sekunden-Throttle von Blizzard). Bei jedem Update werden die Level aller Mitglieder mit dem vorherigen Snapshot verglichen. Steigt ein Level, wird die GZ-Nachricht ausgelöst.

Das bedeutet: Im schlimmsten Fall vergehen ca. 15 Sekunden bis ein Level-Up erkannt wird — dafür funktioniert es zuverlässig serverweit, egal wo sich das Gildenmitglied befindet.

FAQ

Kann ich die Sprüche frei gestalten? Ja! Verwende NAME als Platzhalter für den Spielernamen und LEVEL für die erreichte Stufe. Reihenfolge und Häufigkeit sind egal.

Was passiert, wenn mehrere Gildenmitglieder das Addon installiert haben? Kein Problem — nur der ranghöchste Online-Spieler postet. Alle anderen sind stumm, bis sich der Status ändert.

Gratuliert sich das Addon auch selbst? Nein, eigene Level-Ups werden ignoriert.

Ich habe neue Standard-Sprüche nach einem Update — wie lade ich sie? Tippe /ggz reset um die Spruchliste auf die neuen Standards zurückzusetzen. Achtung: Eigene Sprüche gehen dabei verloren.