AutoDKP is Dragon Kill Points software (DKPSoft) used to facilitate administration and management of DKP points attributed in instances. It is a Java application (not an in-game AddOn) that runs on the same computer that World of Warcraft is installed on. Guild record keepers will use AutoDKP to automatically calculate points after raids are finished.
The program can be used to manage the entire record keeping and point calculation process (for both Boss Kill and Zero Sum systems), or it can be used as a simple out-of-game RaidTracker viewer, or as a calculator to determine points before they are entered into other point system software.
AutoDKP requires CT RaidTracker, because it reads the CT RaidTracker log to automatically fill in the raid information - such as what loot dropped, who got what loot, and which bosses were killed.
Use any CT-modified Raid Tracker version 1.25.xx, where xx is 8 or higher.
(For example, valid versions are 1.25.8, 1.25.9, 1.25.10, 1.25.11, and so on...)
Do not use any version lower or higher than version 1.25.xx (i.e. don't use versions 1.0, 2.00, etc.).
Get the latest version here:
http://www.curse-gaming.com/mod.php?addid=1836
AutoDKP is available from Curse Gaming and the World of War Mod Community websites.
How to install and run the program:
AutoDKP has a few main concepts that need to be understood before you'll be able to effectively work with the tool.
First is that of raids. AutoDKP is raid-based, thus, you will always be working with one particular raid at a time. This raid corresponds directly to an in-game raid. Thus, if you went to Molten Core on Saturday, then you would open AutoDKP and select the Saturday Molten Core raid. AutoDKP makes it easy to determine which raid is which by incorporating the use of icons:
Once you select a raid, the player table will appear. This essentially displays the RaidTracker info for the current raid. AutoDKP does not allow you to modify this data. The info displayed is player name, player class, join times, leave times, and loot. Join times represent each time the player joined the raid, and leave times show the times the player has left the raid. If a player disconnects, or leaves and rejoins a raid, leave/join times are added for that player. In the Boss Kill system, if a player is not in the raid at the time the boss was killed, the player will not receive points for that boss. For Zero Sum, if a player was not in the raid (perhaps the player left the raid temporarily) at the time a loot was distributed, then that player will not get credit for that loot.
The player table is the central view of AutoDKP. It shows all players and the loot each player received, as well as all calculations and totals. Certain columns in the table are modifiable. Keep in mind that in the player table, each modification is saved as you make it. There is no need to explicitly save any changes to the table.
You may choose to show only a certain level of quality or above within the player table. In order to filter loot in this manner, use the Loot Filter box. See Figure 1.
When you are working with the player table, you may find it convenient to sort table data. Do this by clicking on the header of the column you wish to sort. If you wish to sort multiple columns, hold down the CTRL key while clicking the second column. This makes it more convenient, for example, to view which players of a certain class have the most points. One note to keep in mind is that the exported HTML is in the same sort order as the player table itself. Thus, sort the player table to appear the way you want, and then export to HTML. This will ensure the HTML data appears in an easy-to-read order.
Often, loot needs to be sharded, or loot is accidentally given to the wrong player. Also, it is possible for loot to get missed by RaidTracker (this occassionally happens if your character is too far away from the recipient of the loot, in which case your RaidTracker will be missing this data). Or, perhaps you just want to add in a special bonus or penalty on a player. This requires the flexibility of the Formula Editor. On an unlocked raid point sheet, double click on the formula cell for the desired player. The formula editor, see figure above, will open. This editor will allow you to add, modify, or delete items from the formula. For example, you can remove line items that were sharded, or add line items that are not somehow in RaidTracker. Note that line items that come from RaidTracker are not removable, and instead, you can only deactivate them (because remember, AutoDKP does not modify your RaidTracker log). Custom line items that you create, however, can be deleted.
Point Systems
The next main concept is point systems. To record points for any particular raid, you need to define the formulas and values that form the rules of how points are determined. This is called a point system. Typically, guilds may only have one active point system at any one time. However, some guilds use different point systems for different instances. For example, you could use a Boss Kill system for Molten Core, and a Zero Sum system for Blackwing Lair. Or, you could use two different Boss Kill systems - each having different boss and loot values. AutoDKP supports having any number of simultaneous point systems. But before you can record points, you must have your point system defined within AutoDKP. Go to the Advanced - Preferences menu item to open up the Preferences Window. From there, you can define your point system(s).
To record points for a raid, you must have selected both a raid and a point system. AutoDKP grabs the raid information from RaidTracker and the point rules from your point system settings. However, point calculation doesn't start until you officially start points for a raid. When you start points, the current raid is "promoted" (extracted from RaidTracker and saved), and a special points file will be created for the raid that corresponds to the selected point system. If you ever choose to delete points (and thus reset points) for the raid, you can hit the delete button.
The figure above displays info for a raid where points were not yet started. There may be many raids that have points that were never started. For example, Zul'Gurub may not be a point-producing raid for many guilds. In such a case, points will never be started on that raid. If you change the top tab from "DKP" to "Bosses", you will see all bosses that were killed for that raid.
The figure above displays info for a raid where points were started. Notice you may delete the points for the raid and start over. You may also link points from a previous raid as well as lock formulas (see below).
Another major concept is that of raid-linking. Usually you always want to base the points of the current raid off of some previous raid. In other words, the final total from a previous raid needs to be the incoming total for the current raid. In order to specify this, you must use the Link feature. If you are using AutoDKP for the first time, or if you start a new point system, you instead will probably want to enter in the incoming (initial) point values manually.
Linking raid points effectively connects the output of one raid to the input of another. Instead of having to manually copy over the resulting totals from the previous raid into the current raid, you can simply link the current raid to the previous raid with the push of a button.
Linking to a previous raid allows you to bring the final totals of the previous raid into the current raid. It also copies players from the previous raid into the current raid, such that players from the previous raid who are not in the current raid are still saved into the current raid. These non-raid members do not gain any points for the current raid, yet their points will be available to be linked by later raids. Thus, the link mechanism creates a chain of raids that are linked together. Raid C might be linked to raid B, raid B might be linked to raid A... and thus all player points in raids C and B are automatically available to raid A.
Points, formulas, and adjustments for non-raid members can be edited just as they can for raid members. This can be useful for adjusting points for players who receive loot for non-raid sources, such as from the guild bank. You can also add new non-raid members to the raid.
The "Show Non-Raid Members?" button allows you to show or hide non-raid members in the player table.
See Figure 1
After you link a raid, you may be finished with points. However, guilds usually employ special bonuses or penalties that cannot be automatically applied. These subjective points are called "adjustments". When you define your point system, you are allowed to specify a certain number of adjustments. Each adjustment will show up as a separate column in the point table. Adjustments are positive or negative numbers that can be added to the total. For example, you could add a punctuality/duration column in which players get 2 points for being both punctual and staying the entire raid duration (and perhaps 1 point for one of the two, 0 for none).
In Figure 2 above, the "P/D" and "Misc" columns were defined by the user in point system preferences as the adjustments. "P/D" is short for punctuality and duration. "Misc" is a catch-all column where all other adjustments should go.
After adjustments, you should be done with points. At this time, you should lock points by pushing the Lock button. This effectively freezes your formulas, which prevents any future changes to formula rules from effective the calculations of the raid points you just finished. Locking points also prevents accidental modification of the player table.
You will probably want to share points with fellow guild members, and AutoDKP provides a feature to export points into an HTML format. Typically, guilds will have a website (either their own or hosted by sites such as GuildPortal) upon which you can post your HTML file.
The Item Manager stores all loot that AutoDKP has discovered. It also shows the value of each loot for each point system.
Exports the current point system for the given raid into an HTML format. This will show the HTML Viewer window (see HTML Viewer below).
Exits AutoDKP. Whenever you exit, your current settings are saved, there is usually no need to explicitly save anything unless you are asked to.
Allows you to import previously exported AutoDKP data. This data can consist of raids, points, point-systems, items, etc. The Import menu item will open up the Importer window that will guide you through the steps involved in importing AutoDKP data (which is in the form of a Zip file).
Allows you to export some or all of your AutoDKP data to a special Zip file. This file can be sent to a friend, who can then import your data via the Import menu item. The Export menu item will open up the Exporter window that will guide you through the steps involved in exporting your AutoDKP data.
Allows you to change the CT RaidTracker lua file setting. AutoDKP obtains all if its raid data from the CT Raid Tracker log. However, multiple logs may exist if, for example, you have multiple WoW accounts on the same computer. This menu item allows you to change from one log to another.
Opens the Preferences Window, which allows you to define new point systems and to set up alternates. Point systems are central to AutoDKP, and you must define your point system within AutoDKP before you can tally points using it for any specific raid. A point system basically defines how points are calculated (i.e. Boss Kill or Zero Sum), and what values each loot/boss has. Alternates allow you to merge mains and alts so that they appear as one character (the main). Thus, points will be deducted from one character's point total.
When you reload a raid, you re-fetch the CT Raid Tracker data for the selected raid. This re-fetched data will overwrite the pre-existing raid data, so that any changes that CT Raid Tracker picks up for the raid will be reflected. It is important to note that the CT Raid Tracker log file (the file where AutoDKP obtains its CT Raid Tracker information from) is usually not updated until you log out from the game.
When you "promote" a raid, you effectively store the raid data permanently. Thus, you can delete a raid in Raid Tracker without it being removed from AutoDKP. AutoDKP "promotes" raids automatically whenever you start points for a raid. It is important to know that "promoted" raids take precedence over the same raid in Raid Tracker (hence the word "promote").
Deletes the selected raid. If the raid is promoted, it removes AutoDKP's working copy of the raid. If a raid is deleted in AutoDKP, it may still exist within CT Raid Tracker. Thus, to delete a raid permanently, delete the raid in both AutoDKP and in CT Raid Tracker. Sometimes, a raid may only exist within AutoDKP, such as when raids are imported or created from merged raids. In such cases, deleting the raid from AutoDKP will permanently remove the raid.
Creates a new raid from the merging of two other raids. Merging is performed automatically.
Adds a new non-raid member to points for the selected raid.
Removes the selected player(s) from points for the selected raid. Sometimes, you may wish to ignore certain players that may have joined the raid but were not to be included in points. Or, perhaps a player left the guild, in which case you would want to remove the player.
Opens up basic information about AutoDKP, including version number info.
The Preferences Window allows you to define point systems and set up alternates.
When you first use AutoDKP for your guild's point system, you will first need to tell AutoDKP what that point system is. The point system settings that AutoDKP provides should allow you to define most any point system, including Boss Kill and Zero Sum (including a combination of the two).
The figure above displays point system creation. When you create a point system, a key is generated based upon the name that you gave to the point system. The key will never change from this moment on, however, you can change the name of the point system as much as you like without impacting any point data that may already have been saved. Thus, the key serves as the true identifier of your point system. You probably will never need to know what your point system key is, however.
Point systems come in two basic varieties: Boss Kill and Zero Sum.
Zero Sum comes in two varieties. There is a small difference between the two, choose which variation best suits your guild.
PersonA receives an item that has a cost of 60 points: PersonA: -60 item cost = -60 points PersonB: +(60/3) distribution = +20 points PersonC: +(60/3) distribution = +20 points PersonD: +(60/3) distribution = +20 points ----- total = 0 points (the sum is zero)
PersonA receives an item that has a cost of 60 points: PersonA: -60 item cost + (60/4) distribution = -45 points PersonB: +(60/4) distribution = +15 points PersonC: +(60/4) distribution = +15 poitns PersonD: +(60/4) distribution = +15 points ----- total = 0 points (the sum is zero)
The Bosses Tab allows you set point values for each boss. You may also specify "Generic Boss Points", which is the point value for any boss that is killed (if a specific boss has a point value, that value overrides the "Generic Boss Points" setting).
The Loot Categories Tab allows you to set up groupings of loot values on a per point system basis. Loot Categories are a handy way of assigning values to loot. Instead of assigning a value to each individual item, you can define a Loot Category, and then assign the category to many items. This allows you to group items with the same values together, so that you can easily change loot values for multiple items at once. For example, all class-restricted BOE (bind on equip) items can be assigned the same value. A loot value can be entered as a positive or negative point value, or as a percentage. If a loot value is entered as a percentage (by entering a number followed by the "%" sign), then that percentage is always applied to the incoming (previous raid) points. Note that loot values for individual loot is never entered in preferences, instead, they are entered in the Item Manager. The preferences for point systems only handles categories, not individual loot value.
The Adjustments Tab allows you to set up custom columns in your player table. These custom columns allow you to set aside special column in the spreadsheet where you can enter in custom point values. These point values are editable even after formulas are locked (i.e. points are finished) for any given raid. For example, you could add a column for punctuality where bonus points would be entered for all members who were not late to the raid. Adjustments are automatically incorporated into calculations. You can even specify an initial value for the adjustment column to save some typing when recording points.
Sometimes, players will have their alternate characters participate in guild raids. How points are handled for alternates may vary from guild to guild. By default, AutoDKP will treat alternates as separate players, and each alternate will have its own points. However, by using the Alternates preferences, you can combine alternates into one player, such that AutoDKP will treat a player's alternates as being the same as his/her main character. Thus, the points for all a player's characters can be pooled.
The figure above shows the preferences for alternates. Set up alternates such that the player's main character appears on the left, while all of the player's raid-attending alternates appear on the right. Once you specify alternates for a player, that alternate will never be shown in the player table again (unless you delete the alternates setting for that player). Instead, the player's main character will appear in the alternate's place.
The Items Manager is an important aspect of AutoDKP. The Item Manager displays all loot that AutoDKP knows about. It also shows the value, per point system, assigned to each loot item. The purpose of the Item Manager is to allow you to view and modify loot values on a per-item basis. You can enter in direct loot values, or you can assign a loot category (as defined in your point system preferences) to each loot. There are also handy filters that allow you to navigate through hundreds of potential loot items easily.
Note that you must explicitly hit the Save button to save your changes. Changes are not saved as they are made, and this allows you to recover from accidentally changing the value of a loot, and then forgetting what you may have changed. Unlike the player table, which saves each modification as you make it, the Item Manager requires an explicit Save.
The HTML Viewer allows you to view your raid points in HTML form. By pressing the "Copy to Clipboard" button, you copy all the HTML to your computer's clipboard, which you can then paste into another application or web page. The idea is that once you have finished points (remember to Lock them), you will usually want to post them somewhere. Typically, guilds post their points on websites, such as GuildPortal. You can copy this HTML to the website and everyone will be able to view the points.
The Preview button allows you to view the HTML as it would actually look inside a web browser. It is a quick way to verify that you did points correctly.
No amount of automation can provide the correct answers for every situation, and thus complete manual intervention is needed. A customizer exists for each point system to fine tune your calculations. Customizers are accessible from the Customizer button below the raids list. The Customizer button will appear and be enabled when points have been started for a raid, and if Formulas are unlocked.
See Figure 1 for where to look for the Customizer button.
The Boss Kill customizer allows you to apply or unapply the kill points for each boss on a per player basis. Though Boss Kill points are calculated automatically, it may be necessary to remove/add a player as contributing to a boss kill. As you click each checkbox, the changes to the raid points are applied (and saved) immediately.
The Zero Sum Distributions customizer allows you to apply or unapply the distributions from each player's loot on a per player basis. Though distributions are calculated automatically, it may be necessary to remove/add a player as receiving distribution points from any particular loot. As you click each checkbox, the changes to the raid points are applied (and saved) immediately.
AutoDKP is designed to be easily sharable among those who might record points for a raid. The Exporter and Importer allow you to export and import AutoDKP, respectively.
The AutoDKP Exporter allows you to export as much AutoDKP data (including points, raids, point systems, loot, alternates settings, etc.) as you need. When you export data, that data is saved into an export Zip file. That Zip file can then be sent to a friend (i.e. via email) who also has AutoDKP. Thus, your friend can thereby use the Importer feature of AutoDKP to import your export Zip file, and his/her AutoDKP will then have all of your exported AutoDKP data.
When you import data, you overwrite your own data with that of the imported data except when importing items and alternates settings. When you import items or alternates, the imported data is appended to your data, such that you don't lose these settings.
The Raid Merger allows you to merge two raids together in order to create a new merged raid. This merged raid contains everything from each raid, minus the duplicate information.
Merging raids is useful when you want to combine information from multiple Raid Tracker raids. For example, sometimes you may end up with multiple Raid Tracker raids if you switch from one character to another (i.e. you log off your main character to log on your alt). Also, perhaps you have imported raids that come from separate sources yet, each refers to the same raid. In theses situations, it's handy to be able to combine raids into one.
AutoDKP written by Anarch of Silvermoon / Drano of Spinebreaker (Josh Sandusky)
Contact me in-game or send emails to: joshsky@gmail.com