Monolith DKP

MonDKP is a DKP system written with intent to track all aspects of DKP and looting within WoW. Every member of the guild can have it and have full access to real-time DKP values as well as loot and DKP history. This is my first official go at writting an addon despite 15 years of playing the game. So if any bugs or errors show their face, please let me know. Any suggestions or requests are also welcome! You can submit bugs at https://github.com/Roeshambo/MonolithDKP/issues.

NOTE: This AddOn is compatible for the 8.x.x client and can be tested there prior to 1.13 release. Please read the change log for 1.2.0 added features. Thank you to those that have been submitting bug reports!

Video Tutorial: https://www.youtube.com/watch?v=9-fUeRRXALk. This is just covering the basic key operations of the addon. Be sure to check the description for additional information.

If you enjoy the addon and would like to donate it is tremendously appreciated!

Features

- DKP Table entries provide a tooltip showing the players recently spent and earned DKP

- Filter the table by certain classes or show only those in your party / raid. Table columns can also be sorted by Player, Class or DKP

- Loot history. What item was won, by whom, from what boss/zone, and how much they spent on it. Can be filtered by player.

- DKP history. Comprehensive list of all players that received (or lost) dkp for each event.

- Bid timer displaying what is currently up for bid as well as it's minimum bid.

- Option to allow Sub Zero Bidding in "/dkp bid" window - Allows players to bid below their available dkp enabling them to go into the negative. But only if their available DKP is greater than 0. (with option shut off, any bid that is greater than available DKP will be rejected)

- Indicator on the bottom left of the GUI telling you if you have the most recent information. Green = Up to date; Red = Out of date, request update from an officer.

Officer only features

- Bid window (opened by SHIFT+ALT clicking an item in the loot window or by typing /dkp bid [item link]) that starts bidding, collects all bids submitted, and awards the item. NOTE: Shift+Alt clicking an item only works if the item is in one of the first 4 slots of the loot window due to restrictions at the moment. If the item you wish to bid on isn't on the first page, either loot all items on that first page, close and reopen window. Or simply use /dkp bid [item link]

- Default minimum bid values can be set by slot (Neck, head etc) in the Options tab.

- Adjust DKP tab (awarding DKP). Also includes a DKP Decay option that reduces all entries by X% (default set in options or change on the fly in the Adjust DKP tab)

- Manage Tab. Used to broadcast complete tables to everyone in the guild if required as well as add/remove player entries.

- Shift+Click entries in the table to select multiple players to modify.

- Right click context menu in Loot History to reassign items (if minds are changed after awarding) which will subsequently give the DKP cost back to the initial owner and charge it to the new recipient

- Boss Kill Bonus auto selects the last killed boss/zone

- Options window has additional fields to set bonus defaults (On time bonus, boss kill bonus etc)

- Every time a modification, loot entry or DKP entry is made, that information is automatically broadcasted to the guild and their GUI is updated.

Redundancies

- All entries can only be edited / added by officers in the guild (this is determined by checking Officer Note Writing permissions).

- If the addon is modified to grant a player access to the options available only to officers, attempting to broadcast a modified table will notify officers of this action.

- Every time an officer adds an entry or modifies a DKP value, the public note of the Guild Leader is changed to a time stamp. That time stamp is used to notify other users if they do or do not have the most up-to-date tables. Attempting to add to an "out-of-date" table will prompt the player of such, as well as prompt any other officers receiving their broadcast to accept or deny that broadcast.

Commands

/dkp ? - Lists all available commands

/dkp - Opens Main GUI

/dkp timer - Starts a raid timer (Officers Only) IE: /dkp timer 120 Pizza Break!

/dkp reset - Resets GUI position

/dkp export - Exports all entries to HTML (To avoid crashing this will only export the most recent 200 loot history items and 200 DKP history items)

/dkp bid - Opens Bid Window. If you include an item link (/dkp bid [item link]) it will include that item for bid information.

Recommendations

- Due to the volatile nature of WoW Addons and saved variables, it's recommended you back up your SavedVariables file located at "WTF\Accounts\ACCOUNT_NAME\SavedVariables\MonolithDKP.lua" at the end of every raid week to ensure all data isn't lost due to somehow losing your WTF folder. Even if you do lose it, another officer with updated tables can broadcast them (Manage DKP Tab) to you to bring you back up-to-date. So there are multiple redundancies to ensure data isn't lost.

- Export DKP to HTML at the end of a raid week and paste into an HTML file and keep a week by week log in Discord for players to view outside of the game. This will also give you a backup of the data to reapply in the event data is lost.

- DKP table validation is done by using an epoch timestamp (a string of 10 numbers) to check the age of a DKP table. That timestamp is stored in the Guild Leaders public note. Don't allow players to edit the public notes to avoid this being modified (Officers will need permission to do so, however). If you delete this note or change it to zero, all tables, regardless if they haven't been updated in weeks, will be considered "up-to-date" and therefore valid for broadcasting. Inversely, if an issue arises where the number was tampered with and no one is showing with "up-to-date" tables even though you know you have the most up to date one, simply set this value to 0 in the note and then broadcast the DKP table (Manage Tab). This will set it back to the proper timestamp.

If you'd like to change the Monolith DKP Title image to one for your own guild, you're more than welcome to. It simply requires you replace "MonolithDKP\Media\Textures\mondkp-title-t.tga" with your custom tga image (MUST be 256 x 64).

Release Note: While this addon was predominantly developed in retail, all features have been tested extensively in the Classic Beta. Obviously raid triggers were not able to be tested. But bidding has all been verified and there doesn't appear to be any change to the API to suggest the triggers wouldn't work. The trigger in question is the auto switch "last boss killed" when a boss dies. This can be triggered manually in Adjust DKP > Boss Kill Bonus (Reason) > Select boss from dropdown, prior to bidding.