ShowDKP2 v.0.96
Description
This is a 3.x version of the fantastic ShowDKP mod by Softpile. The concept is very simple: it displays EQDKP data in a table format that can be easily sorted based on name/DKP and filtered based on class. Names can be selected either manually or through the use of a "#bid" command, and the selected names can then be used to declare winners of a bid auction. DKP values can be adjusted on the fly by simply right clicking a name in the table and entering the amount to
adjust by. Auctions can also be performed, in which case showdkp can automatically deduct DKP from the winner based on the type of auction. New bidders are automatically added to the table as well, and several options are available to customize the usability.
ShowDKP also supports relational DKP. If relational DKP is turned off, the total DKP per player is determined as
earned + adjustment - spent
. If, however, relational DKP is on, the amount of DKP per player is determined as
(earned + adjustment) / (spent + initial gear value)
. See
http://www.wowwiki.com/Relational_DKP for more information regarding Relational DKP.
Installation
1. If you have access to your EQDKP website, upload dkp_list.php to the base directory containing your EQDKP install (NOTE: this dkp_list.php file is different than the dkp_list.php from GetDKP). Also included are a dkp_list_phpbb.php for Ippeh's phpBB3/EQDKP integrated version - see http://sourceforge.net/projects/phpbb3-eqdkp/... and a dkp_list_eqdkpplus.php for Corgan's EQDKP plus - see https://sourceforge.net/projects/eqdkp-plus/...
2. run showdkp.exe and add/edit as many EQDKP sites as you'd like. If you are unable to upload dkp_list.php to your EQDKP website, set the URL to:
"http://webpath/to/eqdkp/listmembers.php?show=all"
and uncheck the box under the URL input area (however, this method may not work if your EQDKP website is heavily modified or the character names contain special characters such as accents. If this is the case, you must upload dkp_list.php to your website). If you did upload dkp_list.php, set the URL to:
"http://webpath/to/eqdkp/dkp_list.php"
and check the box under the URL input area.
3. repeat step 2 for as many EQDKP data sites as you'd like - each is saved to showdkp.ini.
4. click "fetch" in showdkp.exe.
5. in WoW, run /showdkp to bring up the GUI. (the /showdkp command can also be bound to a key, see the keybindings in-game to set this).
supported bot commands:
"#bid [amount]" or "bid [amount]" - selects the message sender's name from the table, optionally bidding "amount" DKP (this is capped at the players total DKP)
"#cancel" or "cancel" - cancels a bid.
"#need" or "need" - specifies an item as need, but not necessarily for spending DKP on. This option can be used as desired by the user(s).
"#dkp [raid] [name1 or class1] [name2 or class2]..." or "dkp [raid] [name1 or class1] [name2 or class2]..." - with no options, returns the requestor's DKP value. The "raid" flag only returns DKP values for members in the raid.
in-game interface changes:
alt-clicking an item in the loot window or an item link starts a DKP auction on that item, as long as the option to allow alt-clicking looted items is turned on. This operates the same as typing "/showdkp auction itemtooltip" - however, a DKP value for the item cannot be entered manually using this method of starting the auction.
an additional submenu is available when right clicking a player, which can be used to set the flag (need/greed/bid) for that selected player.
supported console commands:
/showdkp - brings up the DKP table (this command can also be bound to a key, see the keybindings in-game to set this).
/showdkp auction itemtooltip [dkp] - starts an auction for the pasted item tooltip taking an optional DKP value for the item. The priority for determining the cost of the item takes the following order:
1. If the auction type is the classic bid type (see the GUI configuration options), the winner of the auction will be charged the amount they bid.
2. If a dkp value is provided, showdkp will use that as a fixed price for auctioning.
3. If itemlevelDKP is available, then the mod will determine the fixed price using the itemlevel.
If Deadly Boss Mods is available, showdkp will broadcast a timer to the raid, so everyone knows how much time remains on the auction. The auction lasts for however many seconds are specified (see /showdkp bidtime or the GUI configuration panel to set this). At the end of the auction, showdkp automatically announces the winner. If the autoupdate option is on, then the winner will automatically be charged DKP depending on the type of auction (see above).
/showdkp stop - manually stops an auction and announces the winner.
/showdkp award X - awards X dkp to the raid
/showdkp #dkp [raid] [name1 or class1] [name2 or class2]... - operates exactly like the "#dkp" bot command, only the results are spammed to raid chat.
the following are also configurable via the "config" button on the ShowDKP GUI:
/showdkp bidtime X - sets the amount of time before an auction closes.
/showdkp dkprange X - sets the announce button to display the top DKP value and all those within X DKP of the winner (default: 20.0).
/showdkp newdkp X - sets new bidder DKP value to X (default: 0.0)
/showdkp relinitgear X - sets the relativeDKP initial gear value to X (default: 1.0)
/showdkp altclick on/off - turns on/off the ability to alt-click looted items to start auctions (default: on)
/showdkp announceinc on/off - if on, then all incoming bids are immediately announced to raid chat, and the current leader is re-announced after each bid (default: off)
/showdkp announcereset on/off - if the announce button is clicked and this setting is on, then the bids/needs are reset as well (default: off)
/showdkp autoupdate on/off - turns on/off auto updating of DKP values when a DKP adjustment is made (default: off)
/showdkp clickreverse on/off - if on, then left clicking the announce button will spam the full list of bidders (or need/greeders if there are no bidders) to raid chat, and right clicking will announce just the winner. Off reverses the behavior. (default: off)
/showdkp privatedkp on/off - if on, then #dkp commands can only return the requestors DKP, and no others. (default: off)
/showdkp relational on/off - turns on/off the use of relational DKP (default: off)
/showdkp suppresswhisper on/off - turns on/off suppression of incoming and outgoing whispers, unless an error is encountered (default: off)
/showdkp options - brings up the configuration options (same as clicking the "config" button in the showdkp GUI)
/showdkp export - brings up the log export GUI (same as clicking the "export" button in the showdkp GUI)
configuration GUI
the type of auction can be specified in the auction type pulldown in the config GUI - the type can be either fixed price (using either itemlevelDKP or a manually entered value, with the latter taking priority) or a standard bid auction (in which case whoever bids the highest will be charged that amount of DKP).
lesser-known GUI options:
the empty field in the lower left can be used to search for names. Pressing enter while in the field will select all the names currently displayed. Pressing escape will exit focus.
Left click a user name to select it from the list (or right click their name from a window, and you should have the option to select them in the showdkp GUI). Right click a user name to adjust DKP on the fly.
Left clicking the announce button only outputs the top bidder, while right clicking the announce button spams the top bidder and all bidders within dkprange (see the configuration GUI or the /showdkp dkprange parameter) to raid chat.
However - if the announce button is clicked and no one has bid, then the mod will output a /random for everyone in the raid, with those that sent "#need" commands flagged as "need" rollers. This is useful for assigning common loot or loot no one wants to spend DKP on, for example. Again: left clicking the announce will only output the highest roller, while right clicking the announce will output rolls for everyone in the raid.
Export GUI
Clicking the "export" button in the ShowDKP GUI brings up the export window, which can be used to export raid information for EQDKP and bulletin board posts. The export window is broken up into 3 smaller windows - the top scroll frame contains all the raids that have been recorded, listed by date (newest raids are at the top). Click on any raid, and the second scroll frame lists all the attendees, and the third scroll frame lists all the loot from the raid. If you click on an attendee or a piece of loot, you can edit information regarding that person/drop in a popup window (e.g. join/leave times, level, DKP price, greed/need/bid status, etc.), or that item can be deleted entirely.
To export the raid, just select the output format (EQDKP or bulletin board format), just click the "export" button, which brings up a textwindow containing the highlighted text that can then be copied (Ctrl-C) to wherever you'd like to post it.
dkp_list.php files
Several php files are available to generate DKP listings for ShowDKP:
dkp_list.php - generates DKP listing from EQDKP
dkp_list_phpbb.php - generates DKP listing from Ippeh's phpBB3/EQDKP integrated version
dkp_list_eqdkpplus.php - generates DKP listing for Corgan's EQDKP plus using the multiDKP table extension to EQDKP (needs to be edited to set the proper multiDKP pool to use)
dkp_list_window.php - generates DKP listing from the previous N days (default: 90 - edit the script to change this)
Changelog
v0.96
- fixes for 3.0.2
- consolidate options
v0.95
- update TOC for version 2.4.0
v0.94.1
- fix output of special characters from EQDKP tables - dkp_list.php
updates
v0.94
- fix a bug with logging need rolls
- improve need roll output
- log "/showdkp award" events
v0.93
- fix bug in logging players during raid
- minor fixes to string formatting
- fix bug in showdkp.exe
v0.92
- fix class colors
- fix a nasty bug when adding new players
v0.91
- add support for relational DKP - if you want to use this, re-upload
the dkp_list.php file (if you use dkp_list.php to parse EQDKP data)
- auctions broadcast a timer using the deadly boss mod API, switch
from using ct_raidassist to the blizzard RAID_WARNING API for
announcing auctions
- minor changes in BB export output
- fix in determining when a raid has ended and a new one started
- bugfixes in returnDKP command
v0.90
- add function ShowDKP_returnDKP(name, channel) that will return DKP
for the given name and (optional) channel - useful for calling
showdkp from other mods
- add /showdkp award [dkp] command - award DKP to the raid
- fix bug in message output
- fix bug in EQDKP output
- fix whisper suppression bug
v0.89
- minor changes/bugfixes/corrections to bidding/announce functions
- minor changes/fixes to raid tracking
- add export GUI for logs
- reorganize data/functions into separate files
v0.88
- update TOC to 20300
- add option to turn off alt-clicking of looted items
- add option to announce bids to raid chat as soon as they are received
- can now parse "#command" as well as "command"
- no longer start auctions if not in a raid
- initial logging ability implementation (needs a GUI!)
v0.87
- allow clicking on item loot window or item link itself to start
auctions.
- exe file updates
v0.86
- add keybinding for the GUI
- add alt-clicking functionality on looted items to start auctions
- include dkp_list_phpbb.php for Ippeh's integrated phpBB3/EQDKP mod
and dkp_list_eqdkpplus.php for Corgan's EQDKP plus mod.
v0.85
- added additional auction functionality (support for manual DKP,
itemlevelDKP and bid DKP)
- updated TOC to 20200
v0.84
- added auction functionality with itemelevelDKP integration
- fixed sorting of DKP type for need/greed types
v0.83
- added privatedkp and clickreverse options
- add ability to sort by DKP type (need/greed/bid)
v0.82
- added configuration GUI
- option to suppress whispers
- update to .exe to properly parse accented characters
v0.81
- added "lock" button so the show raid/checked only checkboxes stay
checked when the reset button is clicked.
- added "announcereset" option, so clicking announce also resets the
list.
- added some text to the DKP deduction window, so its obvious what the
heck that XML frame is for.
v0.80
- add support for "#need", allow optional bidding quantity
- several bugfixes (dropdownmenus, "friend" unitpopup)
v0.78
- update TOC to 20100 (2.1.0)
v0.77
- fixed an error with the UnitPopupMenu introduced in 0.76
v0.76
- all XML line frames are dynamically generated
(prevents errors on console reloads with new players in the database,
showdkp.exe does not need to modify showdkp.xml)
- round earned DKP for autoupdates to 3 decimal places
v0.75
- showdkp.exe includes a WoW launcher
v0.74
- add "autoupdate" option
- move close window box
- update TOC to 20003
v0.73
- fix parser with host sites that add html header/footer data
(showdkp.exe 0.31)
v0.72
- fix empty string when right clicking for DKP adjust
- fix right clicking announce button
- fix selecting all names from the name field using enter when the
"raid only" button is checked
- doc updates
v0.72beta
- change dkp_list.php output to include quotes (showdkp.exe 0.3)
- fix parser bugs (showdkp.exe 0.3)
- add "/showdkp #dkp" command
- right clicking Announce button produces a full list of
bidders to raid
v0.71beta
- localization additions
- add "raid" option to #dkp
v0.7beta
- add dkp_list.php to distribution (must be uploaded to your EQDKP
for ShowDKP to work)
- rewrite showdkp.exe parser (0.2)
- add optional arguments to "#dkp"
v0.61
- fix CHAT_MSG_WHISPER in xml
v0.6
- Update to WoW 2.0 (Sonath, Softpile)
- Fix focus problem with name entry (Sonath)
- UTF8 encode player data (Sonath)
v0.5
- Bug fixes (Softpile)
- add commands/fixes: "#dkp" "#bid" "#cancel" (Sonath)
v.0.3
- Added command "/showdkp dkprange X"
v.0.2
- Initial public release