NOTE about congratulating for achievments
This is a feature that gets requested about every second week. Yes, I agree, it would be really neat to do. Catching when guild mates get an achievment is trivial. But adding the stuff to define messages and such would be a fairly big effort as the GG UI is totally full for defining these messages so I would be looking at a major rewrite. I don't currently have time for this, so this feater won't be available anytime soon. I know this sucks, but such is life.
Rest of description
Alternate download link
Just in case Curse has load issues (as occasionally happens on patch day) I have set up an alternate download page carrying the latest version of my addons. You can find it under http://www.ursbeeli.ch/m_addons.shtml
Description
Guild Greet is an addon that keeps track of main and alt characters in your guild and reminds you to greet them and congratulate them on level up. You can also store an alias for your guildies.
Credit
This addon was originally written by Greya and I helped him with some of the German localisation. Greya did not seem to update GuildGreet for the pre-BC LUA changes. This was done by Mordikaiin and Rozak.
I had already made some modifications to Greya's version but never published them. I sent Mordikaiin a message suggesting he integrate those in a new release but never heard from him. This is the reason why I am creating this branch of GuildGreet
Extension
I loved the main and alt management features of the original GuildGreet. I extended it to print a list of the main and all alt chars whenever a guildie logged in. This helped me to learn who was who in my guild.
A typical login line would look like the following:
[Urbin] has come online.
GuildGreet: [Urbin: Hunter, 70] Sunh Mymule Juran
Later I extended this feature to allow me to query a certain guild member through the command line (/gg <name>), to print a list of the alts of all members of the guild (/gg guild all) or only those online (/gg guild show).
If you change your guild or your guild needs to reform for some reason, GuildGreet unfortunately looses all its main-alt associations. To help you rebuild the database I added the possibility to print all information to a list from which you can copy-past the information (/gg guild list)
Later I added a keybinding to bring up the GuildGreet configuration dialog (/gg) and the possibility to use the context menu on player names in the chat frame to print the main and alias list for that player.
I also added two greetings (or better goodbyes) for players leaving during the day and a night which can be accesses through the player menu in the chat frame as well.
Friend list support
I have added support for your friends. It works just the same as the guild member features.
User channel support
Many guilds that have co-operations with other guilds have a common user channel. I added support for such a channel to 20100.4, you can enable this in the "General" tab and define the channel name to use. You must join the channel before you can enter it in the configuration. The channel members (except for guild members) will be managed in a separate list and their own tab.
Automatic assignment of main/alt chars based on guild notes
This is a feature requested by Dhugal
If this feature is enabled (checkbox on general tab) *AND* no manual main/alt
information has yet been added, then the guild note will be parsed.
The following keywords will be understood:
Main[ <any other text>]
It is important to note that if <any other text> follows, there must be a
space after the "Main" keyword. Any other text will be discarded.
--> this marks the character with this guild note as a "main" char
alt-<main name>[ <any other text>]
It is important to note that if <any other text> follows, there must be a
space after the <main name>. Any other text will be discarded.
--> this marks the character with this guild note as an "alt" char to the indicated "main" char
Summary of original features
This part is copied 1:1 from the original GuildGreet page and was written by Greya
This is a guild tool: it's useless if you are not in a guild
As soon as you go online, the addon loads the list of players in your guild and starts to monitor all changes. As soon as a player comes online or joins the guild, the name is added to a small list onscreen.
If you leftclick on the name, one of the possible greetings (at random) is written in the guild channel and the name is removed from the list. if you
rightclick on the name, it's removed from the list without sending a greeting.
These color codes are used for the list:
- red: players joining the guild both during your session and earlier. These players will also be indicated by the word NEW at the end of the line.
- orange: players logging in for the first time during your current session
- green: players relogging. They logged on before during your current session
- blue: players gaining a higher level both during your session and then earlier. These players will also be indicated by the word LEVEL at the end of the line.
- purple: players getting a higher guildrank then previous session and earlier. These players will also be indicated by the word RANK at the end of the line.
Notes:
- the list shown on the screen can be dragged anywhere you want by using the red titlebar to drag.
- the onscreen list shows a maximum of 5 players by default, but GuildGreet will store the names of any further players needing a greeting.
- mousing over the names in the list will display a tooltip with usefull information regarding the player
For detailed information on changing the configuration (like greeting texts), see the file manual.txt
Greeting guild and channel members
This feature was requested by Yongpeng
There are two key bindings that can be used to send a greeting to your guild chat
and your selected channel and to say goodbye to the two channels. You can also
greet selectively using slash commands. You can configure a guild name alias which
can be used in the guild greetings instead of the full guild name.
Temporarily supressing certain greetings
This feature was requested by Oakayam
If a category (log-in, relog, joining of guild, level up, guild rank promotion)
has no greetings defined, a character will not be placed in the greet list upon
a corresponding event.
However, you might want to supress a certain category without deleting all its
greetings. This is now possible as you can supress the corresponding events for each category (meaning a player who levels up will not be placed in the greet list if the level-up category is being suppressed)
Todo list (none of these are likely to soon be added)
- Use /who interface to get details for channel names
- allow time dependent greetings similar to goodbye feature (suggested by Balsta) [not likely to be implemented in the near future]
- add smart main name matching algorithm when automatically building main-alt relations (suggested by Kortanis) [not likely to be implemented in the near future]
- some people get erratic greetings if they have a guild member in the friends list (reported by Oakayam, jrc3 but could so far not reproduce)
- fubar/titan plugin instead of GreetList (suggested by Kobihunt) [not likely to be implemented in the near future]
- Synch between officers (suggested by Kobihunt) [not likely to be implemented in the near future]
- add auto-assignment notes to guild/officer notes (suggested by Kobihunt) [not likely to be implemented in the near future]
- add guild roster support (suggested by Kobihunt) [not likely to be implemented in the near future]
- prepend main name in chat in main-class-colour (suggested by nimisha) [will not implement, this information cannot always be retrieved locale indpendently]
- show guild member info (player/officer note) in char list (suggested by Sentinelum) [not likely to be implemented in the near future]
- improved grats strings (%c = char name, %a = alis name (like %c if no alias), %C = Char name of the main char (or current char if no main defined), %A = Alias name of the main char (if no alias, like %C->%a->%c), %l = current level, %r = guild rank, %g = guild name, and then timed macro like %{12,13,18=morning,,afternoon,evening}, this would display "morning" from 0-11:59, nothing from 12-12:59,"afternoon" from 13-17:59, and "evening" from 18-midnight. An alternative to the last one, even more flexible, would be to make greetings execution controlable by conditional expressions, so one could congratulate differently for level 70 for example. (suggested by Sentinelum) [not likely to be implemented in the near future]
- add an invisible character to the end of each message, so people can filter them to stop clutter in their chat frame (" " (alt-255) or " " (alt-0160)) (suggested by Natronx77) [don't think this can be done]
- add a "fader time" after which old entries are removed from the greet list (suggested by ImmortalDragon2)
- toggle addon on/off (suggested by ImmortalDragon2) [already partially implemented]
- add automatic main-alt detection based on special guild rank (suggested by Kortanis)
- add support to monitor multiple channels (suggested by Epophis)
- auto-assignment without the need for the [main] tag (suggested by Kobihunt)
- let the user decide whether to use the "public" channel or whisper for each event instead of globally (suggrested by nighttar)
- support "alt - <name>" as well (suggested by mdsandler)
- add more flexible replacement codes for the greetings such as <guild rank>, <character name> and <level> instead of %s (suggested by AcmeHeroesInc)
- add new "keys" to greet strings for alias (%a), main, alt, level, rank etc (suggested by Keith)
- allow for more than 500 guild members (reported by Dima_todd)
- add option to not congratulate alts (suggested by Thomas Richter)
- add support for grats on achievments (suggested by Jesterbob)
Important hint
In the interface options (advanced options) there is a setting in the Chat section called Guild member alert. Make sure that this features is enabled as GuildGreet will not detect guild members coming online or going offline if this is disabled.
REPORTING ERRORS
If you encounter errors, please report them by including the following information:
- the file name and line number where the error ocurred
- the function name in which the error ocurred
- the exact error message
- the call stack of the functions
Some of this information is not available using the default Blizzard error frame but if you use an addon like Swatter from Auctioneer you should get all this information. If you don't have it, just provide what you can get.
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
