Get an Epic Experience with Premium

Guild Delta

Guild Login to Add Favorites
  • 1 Like
  • World of Warcraft
  • 59 Monthly Downloads
  • Supports: 6.2.0
  • 24,005 Total Downloads
  • Updated 06/28/2015
  • Created 08/31/2007
  • 132 Favorites
  • Project Site
  • Comments
  • Release Type: Mature
  • License: MIT License
  • Newest File: 6.2

About Guild Delta

When you login, Guild Delta displays changes ("deltas", in math terms) to the guild roster since the last time you logged in. Specifically, names of players who have joined the guild or are no longer in the guild. See below for tracking other kinds of changes.

If you're here about 5.4.2 changes, read Oddities below!

I didn't like being unaware that people had left my (large) guild merely because I happened to not be online at the time they left. And I kept being surprised to find that people I knew had joined the guild when I was offline. So I wrote this simple tool to discover changes in the roster.

Guild Delta only updates its list when you login. After that, it becomes totally inactive and removes as much of itself from memory as it can. This means that even players who join/leave the guild while you are online will be listed the next time you login. This is deliberate.

By default, text is printed to the combat log window so that it won't get lost in the flood of crap that shows up in the main chat window during login. You can use the /guilddelta command to change this, or from the Escape->Interface->AddOns menu.

Starting in release 4, there is basic support for logging all of the deltas for later review. This is disabled by default, use /guilddelta to activate it. The logging is somewhat primitive.

You can dump the guild roster to a text window using the Snapshot button or '/guilddelta output snapshot'. The text is suitable for pasting into a text editor using a fixed-width font. (Line endings are a little weird, that's just how WoW does it and there's nothing I can do about that. Any strings using high-ASCII letters will cause the spacing to be odd; that's also a WoW quirk.)

If you have downloaded this addon from anywhere other than directly from Curse or WoWInterface, then it is outdated at best and infected with viruses at worst. Clone sites not only leech bandwidth, lately they've been adding malware as well. Get your addons from safe sites with a good reputation!

Notes and Oddities

  • In game version 5.4.2, Blizzard changed the guild roster API to always include the realm name of a player, in order to support connected realms. Unfortunately this means that all your guildmembers will look like they've left, and a brand new roster all joined. It's a one-time flood of noise that they didn't document in patch notes (before, or ever).
  • If you are promoted to officer rank, any existing officer notes will all be printed out the next time you login, even though they haven't "changed" recently.
  • Public/officer notes which are erased get no special mention; that is, there is no notification such as PlayerX's note used to be "complete noob spec" but is now empty when logging in.
  • If GuildDelta reports that a player has left the guild, but Blizzard's builtin Guild Log window makes no mention of the departure, it means that the player has transferred to another faction/realm.
  • Players who rename their character will be reported as the old player name leaving and the new player name joining.
  • If you are no longer in a particular guild, you can (and should) clear that guild's information from memory; use the /guilddelta command to see the list of known guilds. If, however, a player is not in any guild at all when logging in, then the addon will not even register itself and in fact unloads itself from memory as much as Blizzard permits. This means that there will not be a /guilddelta command available! Either log on to a character in a guild (any guild), or if you have no characters anywhere in any guild, then... stop loading a guild-related addon. :-)


If you're a reasonably proficient speaker of non-English languages, any translations you can do would be welcome! Just make changes at and then send me a PM to notify me. I can offer nothing in return except public credit, my appreciation, and a beverage of your choice if you're ever in town.

2015-06-28  Farmbuyer of US-Kilrogg  <>

[0a25d1f44f55] [6.2]
* GuildDelta.toc

TOC bump for 6.2

Addon Packs Containing This...


First Previous Page 2 of 5 Next Last
  • #44
    Using 4.0.2-nolib in Cataclysm:

    Every so often when logging onto a character, Guild Delta will show that officer notes were changed, and then lists all the officer notes that were changed. The list it shows are every toon that has an officer note, but none of them were touched.

    If I log in again, it will say no changes were made. I can log in 15-20 times without it showing any changes, but on the 21st login, it will show officer notes changes when no changes were actually made.

    I've already cleared out the guild data and had it reinitialize, but it's still happening.
  • #45
    I think I just realized what's going on. One of my alts hasn't been promoted to officer status yet, and I just saw all the officer note changes when I logged onto my main toon (which is an officer).
  • #46
    I have this issue as well... It is possible that it is caused by a non officer alt... hmmm :(
  • #43
    @Maziel: That's why Window 2 (combat log, etc) is only a changeable default and not etched in stone. Guessing what a player may or may not have visible is a risky business. Defaulting to the General chat tab would defeat the purpose, as the description explains.

    The most recent version tries to handle the "minimized" windows; whatever chat window the user has chosen is used as a starting point, and the addon will look for a non-minimized window for displaying.

    @Zidomo: Good ideas, and thank you. Confirmation-of-no-change is easy to add; a color picker may take a bit longer.
  • #42
    Great work on the development of this.

    Two things so far. The default chat text color of the output is really hard to see. Am not color-blind; the very dark magenta is only slightly better than true black in the visibility department :D.

    Sure some may like it, but not everyone. So I modified the RGB values on line 195 in gd.lua to get something more visible. Went green here (0/255,255/255,0/255); others may prefer powder blue, etc.. I'm sure others will run into the same issue. So maybe change those default values? Or have access to the Blizzard color picker integrated?

    And one more request. Have an option to print out a line in chat telling that no changes have occurred instead of only printing when they have?

    Basically so you can confirm that no changes have happened when offline and not be questioning whether there is a problem with the mod, some other chat mod interfering with the output, lag interfering, etc.. Its an option the Guild Check mod had and is reassuring to those who like positive confirmation on nil values :).
  • #41
    I never have my combat log up, I went in to the options and changed the channel telling it to print in the general channel.

    Most people have the general channel up upon log in, and since Guild Delta reports changes upon log in, my personal feeling is that Guild Delta should be defaulted to print in the General Channel not the Combat Log (which a lot of us hide until we are in a raid or whatever).

    Anyhoo, works well, great addon.
  • #37
    This addon doesn't work for me. It doesn't display any changes in combat log window.
  • #38
    Does /guilddelta bring up the options window? Or, does the addon appear in the AddOns menu if you hit escape and click Interface?

    If not, then it's not even installed or loaded.

    If it does, then click "Print Chatframe Numbers" and try moving the setting to a window that's visible. Not everybody has the same number for their combat log.
  • #35
    Howdy! This addon is a good one, but I have a request / suggestion for you. There used to be an addon called Guild Log, which kept a complete history of changes, and displayed them in its own window. You could configure that window to display every time you log in, or you could open it with a button on the guild page.

    Once you had the Guild Log window open, you could show any or all of guild joins/leaves, rank changes, not changes, and toons leveling. You could turn each type on or off at will - so if you wanted to check out when ____ joined, it was really easy. With that window, a complete history of every change is kept.

    What do you think?
  • #36
    It sounds like a complete duplication of the built-in Guild Log window, to be honest.
  • #39
    I used to use Guild Log, until it stopped working for me, and then I picked up Guild Check which reported changes on log-in but didn't store them. Yes and no. All the changes listed in the "official" log are there, though more succinctly (both add-ons would list starting and ending rank of a promotion, not every step in the middle), but level changes would be there as well and a longer time period listed. Additionally, Blizzard's log (at least as of pre-4.0, haven't had opportunity to cross check yet) does *not* report when someone disappears from the guild roster via faction/server (and account, I think) transfer - being able to catch those is nice. If storing all this isn't something you're interested in having in your mod, (Guild Log's file did get rather large eventually) would it be possible to add a way to easily copy the delta? Been running a standalone text file of changes and it's nice to be able to go back and find out when something happened.
  • #40
    I'm going to have to implement *some* kind of persistent storage; clearly there's interest and demand for that kind of thing. :-)
  • #34
    Sorry about that. I'd done up a brand new version about two weeks ago, and then forgot to actually upload it. /facepalm

    New file uploaded, it'll take a little while for the servers to propagate it out to curse.
  • #33
    Another LUA error in 4.0.1, about 5 mins after logging in:

    1x GuildDelta\GuildDelta.lua:15: attempt to index upvalue 'chatframe' (a nil value)
    (tail call): ?:
    GuildDelta\GuildDelta.lua:197: in function `GuildDelta_OnEvent'

    (*temporary) = "GUILD_ROSTER_UPDATE"
    (*temporary) = "GUILD_ROSTER_UPDATE"
    (*temporary) = defined =[C]:-1

  • #32
    Any thoughts on this LUA error with 4.0.1 client:

    1x :"GuildDelta:OnLoad":1: attempt to index global 'this' (a nil value)


  • To post a comment, please login or register a new account.
Login to Curse

Don't have an account? Create One.

Get an epic experience with Curse Premium
  • Faster addon downloads
  • Premium-Only Beta Giveaways
  • Ad-Free Curse experience
  • Premium Curse Client
  • and many More Features
  • Learn More »

Darkest Dungeon Wiki Editing Contest