- Lets you view and manage guild members on a person basis, rather than character by character.
- Adds the main name to incoming messages from known alts.
- Allows you to use your real name or nickname as a main name if you wish.
- Officers and guildmasters can read officer notes for, promote or guild-kick all of a person's characters in one step.
- Core feature: Uses =Name. format information in the guild character Notes. Information is accessible throughout the guild, everyone can contribute, data is computer-independent, and not everyone must have the addon.
How to make it work
World of Warcraft does not allow addons to directly access which characters belong to the same account. You (and others in your guild) must provide that information. In the guild window, left-click your character to bring up its box, and use the Note field. This example shows how.
Example
Player Ellinor has the characters Blinky, Pinky, Inky and Clyde in the guild. She has several options:
- A) Being known by her main (which is Blinky), she writes =Blinky. in the Notes of Pinky, Inky and Clyde. Writing =Blinky. in the Note for Blinky is optional.
- B) Being known as Ellinor Blade to her guildies, she writes =Ellinor B. in the Notes of Blinky, Pinky, Inky and Clyde.
- C) Being known under her online alias "Peter" to her guildies, she writes =Peter. in the Notes of Blinky, Pinky, Inky and Clyde.
People with no alts in the guild
For people who have only one character in the guild, adding =Name. is optional. GuildPeople will use the character's name as default, and assume it is a main.
Should accept all letters usable in WoW names at your locale, as well as spaces, - and most other things you can write.
There are basically only two things to avoid:
- Don't try to use = in the Note before the = in =Name. Example: =P =Donald. (will result in the name "P =Donald")
- Don't try to use . in the Name itself. Example: =Alfred E. Newman. (will result in the name "Alfred E")
Remaining space in the Note field can still be used for whatever you like (GuildPeople will ignore it).
The Note field only allows a maximum of 31 letters, limiting names to 29 letters. Names of max 12 letters (the WoW name limit) look best in the current interface. The end of very long names may get hidden.
Tip: If all characters in the guild are provided with =Name. info at the beginning of the Note field, the guild list can be sorted alphabetically by person (by sorting by Note column).
Name your friends (optional)
If you like, you can also write names in the =Name. format in your Friends list note fields. This is only used for incoming chat messages (see below). Convenient for friends you know in real life but who are not in your guild.
GuildPeople will not give error messages or otherwise make trouble if the provided information is not complete. It works with what it gets. It will of course be more useful if all alts are properly defined. The Audit function will help you check if provided name data are in order (see below).
Functions
Main name in chat messages
When you get an incoming chat message from someone in your guild (or on your friends list), the main name will be provided within parenthesis (if there is one, and it is not redundant).
Example
When Ellinor says Hi everyone! you may (depending on what name she has provided) get one of:
- [Clyde]: (Blinky) Hi everyone!
- [Clyde]: (Ellinor B) Hi everyone!
- [Clyde]: (Peter) Hi everyone!
If she uses her main and the name Blinky, you get:
- [Blinky]: Hi everyone!
[Blinky]: (Blinky) Hi everyone! is never shown
The GuildPeople window
GuildPeople adds a tab marked "People" to the window Social -> Guild. Click it to open the GuildPeople window. Here you get a list of all (presumed) individuals in the guild, the number of characters associated to them, and which one of their characters is online at the moment. Right-clicking a name will give you a list of the characters' names, levels and classes.
Color-coded names
The names of individuals are color-coded as follows:
- Blue: Has a non-character name (real name/nickname).
- Green: The main character has been explicitly defined as main (with its own name as main name in the Note field).
- Yellow: A main with one or more alts referring to it.
- Orange: A (presumed) main with no alts or information whatsoever.
- Red: A (presumed) main with no alts or information whatsoever, and who's rank privileges don't allow him/her to change his/her own Note (a signal to officers to either promote or fix the Note themselves).
Officer options
If you have the appropriate privileges, right-clicking a name will also bring up the options to read all Officer Notes, change a person's rank or kick them out of the guild. This is a smooth way of handling officer duties in a guild with many alts.
View Officer Notes
A table of the characters and their Officer Notes will appear in the smaller box below, for you to read and compare.
Change rank for all to >
With one selection, you will promote/demote all of the person's characters to a given rank. Checkboxes mark the current rank(s) of the person's characters.
Guild-kick all
This will remove all of the person's characters from the guild (a confirmation box will appear first).
The rank-change and guild-kick functions may take a few seconds to complete if the person has many alts.
The Audit function
When clicking the Audit button, GuildPeople retrieves the true number of accounts represented in the guild (available through the /ginfo command) and compares it to the number of (presumed) individuals. Numbers are presented in the chat window. When all alts have their mains defined in their Note fields, the numbers will match. GuildPeople will essentially give you the number of "mainless alts". They are most likely to be found among the orange- and red-colored names. This is a way of checking if you are done finding them all.
Developement & future additions
GuildPeople is an addon in developement. All functions have been tested by me, and they work as far as I know. GuildPeople has not been tested in large guilds yet, which is why this addon is currently in a pre-1.0 version. Also, many functions yet unimplemented can be added if there is a demand for them.
0.4 ALPHA:
Fixed malformed TOC number.
0.3 ALPHA:
Updated for patch 3.1. Changed to comply with new list of message filter function arguments.
0.2:
Fixed a bug in the list sort function that gave an error if an update was in progress while the sort was being done (rare error).
0.1:
First release.
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)...
