Van32's GuildPoints

Important Info!

This project was originally called GuildPoints2. It is still the same addon, with the same features, just under a new name!

Yeah... This was a horrible mistake. I hope you learn from my lesson and choose not to use an addon like this... Using points systems for your members might work in theory, but it drives half of them away.

About

The information here pertains to version 2.5 of GuildPoints.

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

• Guild Master

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

• Guild Master

/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

• Guild Master