GuildPoints 2
Important Info!
PLEASE NOTE: The latest version of GuildPoints2 is not compatible with the older versions! You will have to either manually update all the instances of "GP" in the officer's notes to "CTs" or you will have to reset your guild's GP entirely.
Please run /gpreset after updating to version 2.5
Sorry for any inconvenience.
About
GuildPoints 2 is a simple addon to help a guild master, and his officers to manage a guild currency called GuildPoints or GP. It doesn't have any SavedVariables, and very few Global Vars, so it's light weight, and has no UI, whatsoever. It can automatically promote, demote, and remove members, should their GP balance be adequate. All guild altering actions do require your input through various confirmation dialogues, explained below.
Please Note! This addon has only been tested in a live guild with 10 ranks, I cannot guarantee that it will work for your guild setup, but, should you want to change the setup, or make this addon work with your guild, the instructions can be found here.
Slash commands
- /gphelp - Shows a simplified version of this help text in game
- /gpaward number - Award the selected member with number GP. Does not accept 0 as an award
- /gpawardall number [online] - Awards all players with number GP. If you omit online, or pass anything but "true" to it, it will award to every member, otherwise, just the online ones. Does not accept 0 as an award. Only the guild master can award to all members.
- /gptoggleban - Simply appends an ! in front of the selected member's GP, or removes it if there's one there, thereby preventing the addon from awarding that player GP.
- /gpfix - Scans the Officer's Note of every player in the guild, and makes sure that the addon can read their GP values.
- /gpsetvalue number - Sets the selected member's GP to number. Only the guild master can do this function.
- /gpreset - Resets the Officer's Note of every player in the guild to the predefined rank minimums, making sure the GP is readable at the same time. Only the guild master can preform this function.
Slash Command functions
/gpaward number
Basic Functions
This slash command requires that you have a player selected in your guild roster in order for it to work.
It awards the selected player with number GP, negative awards are acceptable.
Should the member's GP exceed the maximum or minimum for that rank, a confirmation dialogue will pop up and ask you if you wish to take the appropriate action.
Required Privileges
- View/Edit Officer's Note
- Promote Member
- Demote Member
- Remove Member
/gpawardall number [online]
Basic Functions
This slash command awards all members with number GP. Negative awards are accepted.
Passing "true" to online will allow you to just award online members.
Should any member's GP exceed the maximum or minimum for that rank, a confirmation dialogue will pop up and ask you if you wish to take the appropriate action. After clearing all the dialogues, due to a limitation in the addon, please run a /gpfix until no more dialogues are shown.
Required Privileges
Awarding to All members
Awarding to Online Members
- View/Edit Officer's Note
- Promote Member
- Demote Member
- Remove Member
/gptoggleban
Basic Functions
This slash command requires that you have a player selected in your guild roster in order for it to work.
Basically, it renders the Officer's Note unreadable to the /gpaward commands. /gpfix will recognize that it is in fact a disable, and not try to fix it.
Should the selected member's GP already be disabled, it removes the disable for you.
Required Privileges
- View/Edit Officer's Note
- Promote Member
- Demote Member
- Remove Member
/gpfix
Basic Functions
This slash command does a quick evaluation of all of the members' Officer's Notes, and passes them through the GPAward function, so that it can check the integrity of the data stored in the Officer's Note, and restore accurate values, and the member's proper rank, for their GP level
This function does not actually change any player's GP, unless it does not recognize the string stored in the player's officer's note, in which case, you will receive a chat notification stating that the player's GP was set to a specific value(the rank's minimum value).
Required Privileges
- View/Edit Officer's Note
- Promote Member
- Demote Member
- Remove Member
/gpsetvalue number
Basic Functions
This slash command requires that you have a player selected in your guild roster in order for it to work.
This command sets the selected player's GP to number, awarding any necessary promotions/demotions.
Required Privileges
/gpreset
Basic Functions
This slash command resets the GP for the entire guild, to the rank's minimum values. There is a confirmation box, so that you can't accidentally reset the GP.
It is followed by another confirmation box, asking you if you want to notify the guild of the reset. Currently there is not a way to configure the message, aside from editing the GUILDPOINTS2_GUILDNOTIFY variable, in GuildPoints2_GlobalStrings.lua. The default message is:
GUILDPOINTS2_GUILDNOTIFY = "((ALL MEMBERS: " .. GUILDPOINTS2_GP .. "s have been reset, guildwide.))"
Required Privileges
Version 2.5.2
FIX The promotion dialogue should now play the LevelUp sound again when you click the button.
Version 2.5.1
FIX The promotion dialogue now plays the sound file every time you click the "Promote" button. Changed PlaySound to PlaySoundFile.
Version 2.5
FIX The promotion and demotion feature should now work correctly, and not try to continue promoting members.
FIX Fixed up the GlobalStrings, removed Debug messages, and unnecessary variables.. A little spring cleaning if you will.
NEW The promotion and demotion process now waits for GUILD_ROSTER_UPDATE, like it should have from the start. (Thanks to Nafe for this one)
NEW This feature renders GuildPoints 2 incompatible with older versions. Please /gpreset after installing. The new term used for the GP has been changed to Commendation Token. A long and short version of this has been added to the globalstrings file.
REM The "Success Dialog" has been removed entirely, as it is no longer needed, and gets in the way. The messages are now routed to the DEFAULT_CHAT_FRAME
Version 2.3
FIX Another attempt at fixing the success dialogue. It should now properly function, without awarding some arbitrary member the GP that the promoted/demoted member had. It now implements a very crude, but effective GetGuildRosterIndexByName(PlayerName) function. Basically searching the Guild Roster, by player name, one at a time, until it finds a match, and returns the index.
Version 2.2
FIX The not-so-real-only-half-asked fix for the Success Dialogue.
Version 2.1
FIX Jumped to version 2.1 because of an improper version number from version 1.
FIX Fixed a minor bug in the success dialogue, when promotion/demotion without a member selected in the Guild Roster would throw an error.
Version 1.0
NEW Addon Released
Legend
NEW New Feature.
FIX Fixed Feature.
REM Removed Feature.
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)...
