| Syncing |
Zhinjio |
Zhinjio |
16 May 2009 |
| Before I get into any details on the specifics for SKG, I should just mention that this is, far and away, the one thing that causes the most problems for users of this plugin. However, with taking a bit of care, establishing good practices and diligence ... you can avoid them. Syncing is the act of merging (or, possibly, replacing) the data you have in your Roll lists with the data that another person has. The Sync Status Frame is where syncing operations and status can be done. This panel is... |
| SyncKey |
Zhinjio |
Zhinjio |
16 May 2009 |
| A SyncKey is an identifying string that indicates the current state of a Players List or a Roll list. The formats for SyncKeys are very different depending which list is being viewed. For the Players List, the format is as follows: wwwwwwww(xxx)yyyyyyyy(zzz) wwwwwwww is the hash of the Player's List xxx is the number of people in the Player's List yyyyyyyy is the has of the Alt's List zzz is the number of people in the Alt's List For a normal Roll list, the format is very different. In this... |
| SuicideExample |
Zhinjio |
Zhinjio |
16 May 2009 |
| Visual Example of a Suicide In this over-simplified example, players that are not present for the raid are greyed out. Note that in each case, only those players present actually have changed positions. Players not present do not change every change positions. |
| Suicide |
Zhinjio |
Zhinjio |
16 May 2009 |
| Using the "Suicide" button on the List Management panel is generally only for "After the Fact" list manipulation to repair a list that did not receive some loot events that occurred, and as such, should be used with great caution. This button has two different behaviors, depending on whether you are in a current raid, or not. Behavior while in a raid While in a raid, the suicide works as you would expect. The "selected" player becomes the "winner" of the suicide event, and any other players... |
| Snapshot |
Zhinjio |
Zhinjio |
16 May 2009 |
| Taking a snapshot of a list is a manner of keeping your roll lists, and especially the logs, tidy. The basic logic is this: Make a snapshot of the current lists, and store it in a special "snapshot" savedvariable for that list Make a snapshot of the "last modified" data, and also store that Clear out all "log" entries of all events and reduce them to just a single "SYNSS" (snapshot) sync event Once thing that is important about those "SYNSS" events is that they are considered a list... |
| SecurityTiers |
Zhinjio |
Zhinjio |
16 May 2009 |
| SKG Security is implemented in two tiers: User Syncer You will see the term SKG Admin used loosely around this site to refer to Syncer group listed above. User Tier Users are the general raiding populace, and can perform the following functions: View Player and Roll Lists Set Viewing Options, Button Texture and Profile Options View Help System View Primary Bidding Panel Bid/Retract on an item in an Open Bid Syncer Tier Syncers have access to all functions in the client. This includes... |
| RewriteDifferences |
Zhinjio |
Zhinjio |
16 May 2009 |
| This page will attempt to detail the principal differences between old (pre 5.0) and new (post 5.0) versions of SKG. You should also refer to this page if you are previewing alpha or beta releases, since many of these differences will be new to you. Main Panel Switching Button The round button on the top left corner is the main panel switching button This switcher will only allow you to switch to panels that you are authorized to use Security system By default, all users of SKG are considered... |
| Reserve |
Zhinjio |
Zhinjio |
16 May 2009 |
| The idea of reserving a player was borne out of a desire to reward players who were present and ready to raid at raid time, but not included because the group was otherwise full. The may have been listed as "Standby" or "Backup" on a raid signup, and were ready to go during the raid times, despite not getting to participate in the raid. Function By setting a player "Reserved", that players moves through the list when someone else suicides, even though they are not in the active raid. This... |
| Profiles |
Zhinjio |
Zhinjio |
16 May 2009 |
| There are two options for how you save your settings, Account Wide and Per Character. The primary reason to use Per Character settings is if you have characters on the same account, in different guilds, that both use SKG (presumably, with different lists). The difficult thing with Per Character settings is the characters that are in the same guild do not necessarily have the same lists, since they could not both have been logged in during the most recent changes. You will need to be more... |
| Players |
Zhinjio |
Zhinjio |
16 May 2009 |
| There is now the concept of a "Players" list. This was added as part of the effort to manage Mains and Alts. No player may be in a Roll list if they aren't in the Players list. Adding a player to the Players list (via the List Management panel), allows you to specify several options. If you have a player selected (as your target) prior to clicking on "Insert Player", the name and class fields will already be filled in. Assuming there are already players in the Players list, and you elect to... |
| Overview |
Zhinjio |
Zhinjio |
16 May 2009 |
| Like with many loot distribution systems, SKG provides a mechanism to fairly distribute loot when a boss is killed or another loot event occurs. Unlike many systems, it does NOT require you to track values for items, or maintain some sort of "score" for individual users. In the simplest form, when a loot event occurs, any player on the appropriate Roll List may elect to Bid on an item. The bidder who is highest in the list (or has the lowest numbered list position) wins the bid. What occurs... |
| OldReadme |
Zhinjio |
Zhinjio |
16 May 2009 |
| IMPORTANT NOTE Although the information from this original readme is included below "as is", much of the information included herein is NO LONGER ACCURATE. Please do not consider this document useful for anything other than its historical value. You have been warned. Rationale I was experiencing a number of different problems with the 'default' version of SK, and decided to try and fix them myself. In short, Ive removed all the custom channel functionality of the old plugin, and forced it... |
| OldChangelog |
Zhinjio |
Zhinjio |
16 May 2009 |
| Note This changelog is only present for historical purposes. The new changelog is visible on the description page for each version. 78882 created by zhinjio on 21 July 2008, 17:44:49 -0700 next release candidate. MANY bug fixes jira tickets SKG-77, 95, 96, 99, 100, 105, 107, 111, 113 jira tickets SKG-114, 115, 118, 121, 122, 123, 128, 129, 136 jira tickets SKG-139, 141, 143, 145, 146, 151 75389 by zhinjio on 28 May 2008, 13:06:31 -0700 bugfix release jira tickets( SKG-94, 92, 88, 87, 85 )... |
| NewSecurity |
Zhinjio |
Zhinjio |
17 May 2009 |
| The Problem By far one of the largest complaints about the security system that was in place up to now was the fact that it required a Guild Leader to be involved at least to set the system's security, and/or a proxy. In theory, after this point, they needn't have been involved. However, as Murphy's Law states, that was not always the case. Errors would occur, people would (for no reason that I've been able to figure out) lose their security settings, etc. So the new system gets rid of... |
| ManagingMainsAlts |
Zhinjio |
Zhinjio |
16 May 2009 |
| One of the most requested features for the rewrite of SKG was for the ability to have associations between Mains and Alts. Many guilds were managing this previously by reserving mains for every raid, and having many positions in the list move at the same time to simulate this behavior. The newer versions of SKG now support this functionality natively. Please note that you do not have to use this feature at all. Simply inserting all toons into the Players List as mains will mean that you will... |
| Main |
wowaceSVN |
Zhinjio |
16 May 2009 |
| Documentation I'm redoing the current documentation. Please be patient as some links will not work until this is completed. IMPORTANT SECURITY CHANGES Based on feedback received over the course of this addon's development, the security model that was in use has been scrapped for something far simpler. For both new and existing users of this addon, the following topic should be considered REQUIRED READING: New Security Model What is SKG? Suicide Kings Geo is a plugin that manages loot... |
| LootExceptions |
Zhinjio |
Zhinjio |
16 May 2009 |
| The following items are ignored by SKG's looting mechanism, and will not be added to the list of items to be bid upon: ZG Bijous and Coins AQ Scarabs and Idols AQ Naxxramas Armor Scraps Spirit Shard Badge of Justice Emblems of Heroism/Valor/Conquest Soul Essence Primal Nether/Nether Vortex Heart of Darkness Sunmote Mark of the Illidari Amani Hex Stick |
| ListCreation |
Zhinjio |
Zhinjio |
16 May 2009 |
| Lists are created in one of several ways. First, the "Players" is created when the addon first initializes, and it is always present, and unable to be deleted. Second, a manual "Create List" or "Clone List" operation from an SKG Admin. The lists will be automatically created for anyone who is currently logged in. Finally, through the so-called SYNPL/SYNAL events. These stand for "Ping Lists" and "Ack Lists". On initial login, all SKG clients send out the SYNPL request to be informed of what... |
| ListCorruption |
Zhinjio |
Zhinjio |
16 May 2009 |
| With the release of 6.24, several things became clear pretty quickly. The main thing, though, was that people were finding ways to get the list management to break in a whole variety of ways I had not predicted. As a result, reports of list corruption were coming in with many different kinds of behaviors. After reviewing all this data, several primary types became evident: Somehow having duplicate entries in the Players and Roll lists Somehow being able to move a player beyond the "end" of a... |
| ImportingLists |
Zhinjio |
Zhinjio |
16 May 2009 |
| By following the procedure defined below, you will be able to safely move lists from the older version of SuicideKingsGeo (pre 5.0 versions) into the new addon. It is important to understand the limitations of this import process before doing so. It is also strongly recommended that you follow this procedure before making any other lists, and use them as your starting point with the new addon. Limitations Characters imported using this process are ALL considered Mains. The import process does... |
| History |
Zhinjio |
Zhinjio |
16 May 2009 |
| The original version of this plugin was created by JoeHunk of The Black Company on the Whisperwind server. Earliest comments from him on his forums date back to August of '06. He actively maintained and supported the plugin until May of 2007, when he announced he was ceasing development and support. Shortly thereafter, Zhinjio took over development and support. Four versions were released using the old codebase, and updating to account for Blizzard patches and user bug reports, ranging from... |
| GoodSyncingPractices |
Zhinjio |
Zhinjio |
16 May 2009 |
| Here are a series of suggestions for making sure that your lists never run into corruption and syncing issues: Initial Setup Be careful when creating new lists. One common reason for corruption is when a new list is being used for the first time. Only use Auto-Add Mode during initial list creation. Because of the way an Auto-Add list insertion is stored, it can cause corruption if used after initial list creation. Pre-Raid Preparation It is absolutely essential prior to running a raid that... |
| FindAddMissing |
Zhinjio |
Zhinjio |
16 May 2009 |
| The "Find Missing" and "Add Missing" buttons make it easy to add players from your current raid into your lists. In previous versions, this wasn't possible without jumping through a bunch of hoops and doing manual work. In order for a character to be added to a Roll list, it must first be added to the Players List. So, if you have a Roll list selected, and click on either the "Find" or "Add" Missing buttons, it will first check to see if the player's in the raid are missing from the overall... |
| FAQ |
Zhinjio |
Zhinjio |
16 May 2009 |
| What is Suicide Kings? A loot system "template" designed for World of Warcraft - easily customizable for your guild's requirements A WoW UI addon that runs the system - allows for the easy administration of the looting system within the guild without the need for spreadsheets and a Master's Degree in Business Administration A general philosophy for loot distribution for the raiding aspects of WoW (and other MMO's). Why Suicide Kings? The Suicide Kings system was designed to fill an empty... |
| DisplayOptions |
Zhinjio |
Zhinjio |
16 May 2009 |
| The main options frame allows you to configure various options about the way SKG behaves or displays data. The top two checkboxes affect the way Roll lists are displayed when in a raid group. If you are not in a raid group, you will always see the whole Roll list. The final checkbox under "List Behavior:" determines whether or not you will see the class colors, or just the default blue. Note that the Players List is always displayed in the default blue color. The button in the center allows... |
| Detail |
Zhinjio |
Zhinjio |
16 May 2009 |
| Detailed Documentation This is a fairly generic table of contents for the various detailed documentation topics. General Display Options Profiles List Management List Creation Players List Importing Lists Managing Mains/Alts Auto-Add Mode Using Player Reserve Find/Add Missing Player Suicide Snapshot List Corruption Bidding Bidding Bid Filtering Looting Loot Exceptions Loot - Class Filters Syncing Keeping lists synced Good Syncing Practices Security New Security Security Tiers |
| ClassItems |
Zhinjio |
Zhinjio |
16 May 2009 |
| The following loot will have loot auto-filtering assigned (this can be manually over-ridden before opening bidding): AQ Quest Items Naxxramas Desecrated Armor Pieces "Tier" tokens |
| Bidding |
Zhinjio |
Zhinjio |
16 May 2009 |
| Managing a Loot Event occurs in 5 steps: Select an Item to be bid on Select the appropriate Bid Filtering for the item Open Bidding, and wait for bids Close Bidding Pass out Loot Item |
| BidFiltering |
Zhinjio |
Zhinjio |
16 May 2009 |
| SKG now supports bid filtering, effectively replacing the old concept of Class Lists as well as providing some new features. Managing bidding is done through the Bid Admin panel, used by the SKG Admin when processing a loot event. Class Filtering Prior to opening the bidding on an item, the Admin may set the Class Filter, restricting which classes may bid on the item. The Modify Class Filter button currently lets you select (or deselect) any individual class, or use one of the presets (Tanks,... |
| AutoAdd |
Zhinjio |
Zhinjio |
16 May 2009 |
| There are two modes available when inserting players into a Roll list, "Normal" and "Auto-Add" mode. "Normal Mode" inserts players at the end of the roll list, "Auto-Add Mode" inserts players into a random position into the list. This is, to some extent, a holdover from previous versions of the plugin, and not necessary to ever use. In prior versions, the initial setup of a roll list involved players rolling a /random 1000 to determine their initial position in the roll list. In the new... |
| 423Readme |
Zhinjio |
Zhinjio |
16 May 2009 |
| Rationale I was experiencing a number of different problems with the 'default' version of SK, and decided to try and fix them myself. In short, Ive removed all the custom channel functionality of the old plugin, and forced it instead to use the GUILD ADDON channel (hidden) for its communication and syncing. Restrictions, Assumptions and Benefits Only people who are IN THE SAME GUILD will get automatic sync messages This DOES work for multiple raids going on simultaneously. Like before, only... |
