Quick DKP
Quick DKP V2 is an addon for World of Warcraft that handles every aspect of the DKP management of a guild. Its goal is to stay completely in-game, storing points and time amounts in the officer or public notes fields of the guild's chart, in a clear format readable by everyone without using the mod.
Features List:
- Completely Ingame: You won't need an external PHP server to store DKP or stuff like that.
- Very easy to use and maintain: You can learn to use it in few minutes.
- Independent: No dependances are required, and no more mods are needed for the DKP management.
- Flexible: you can adjust many parameters of the mod to best suit your guild's needs, adapting it to every points or roll based loot system known. ALL options are kept in a single file (Options.ini). Once configured, you can easily share this file with other officers to work with the same settings.
- Automated Awarding and Charging systems:
- Boss Bonus DKP table, to award the raid when the given boss is killed
- Give DKP on a hourly base (Hourly bonus)
- Award the most hard-core gamers with the IronMan bonus, which gives DKP to the players who stayed for the whole raid.
- For guilds with fixed item prices, compile a table of item prices basing on the instance and the difficulty level.
- Give custom raid awards as a bonus, just with a click.
- Redistribute DKP from a member to other Raid members with the ZeroSum function.
- Fully configurable Bid Manager: The integrated bid manager support every dkp or roll bidding system known, like open/silent bid, pure or modified roll, random influenced bid, ni karma or shroud loot systems, "spend one more" policy and so on.
- Dynamic and Interactive Log System: Keep a unique and complete history of your raids! The log will store every modification, and you'll be able to view and edit those modifications at any time. QDKP will update the data as requested, in real time. It will also monitor and log the killing of bosses, bids, loots, raid members who joins, leaves and goes on or offline.
- Info Center: Guildmembers who don't have the addon installed can whisper you to know their DKP amounts, the dkp they earned and spent in the current session or get a DKP top ten of their rank or class, or an overview of their personal log. You can output detailed reports of any log view to any channel. You can even set QDKP to actively announce DKP modifications and events to the raid chat, or to push notifications via whispers.
- DKP values exporter: You can export a table with the DKP table for the whole guild, in both plain text or HTML format, or in a convenient XML format useful to be imported in a database. You can copy the table and paste it in your guild site, or in a forum, or wherever you like.
- Alternatives Support: You can easily define alts, to implement a Player-based DKP pool. Each alt is related to a Main Character, and will share his DKP amounts and his Log.
- External Support: Add players that aren't in your guild to QDKP's local Guild Roster, and add players that aren't in the current raid as standby players, enabling them to get DKP awards.
....And more....
FAQ
- I am an officer, but QDKP won't let me edit DKP, it only show a list of players.
To enable the officer mode, your guild rank must have the rights to edit Officer notes AND guild notes. If you don't, Quick DKP assumes you are not allowed to edit DKP and put itself in read only mode. The only way to change this is to ask your guild master to edit the guild permissions of your rank, or to be promoted to a higher rank that has the needed rights.
If you hover the cursor over QDKP's minimap icon, you'll see the status of your guild rights. The command "/dkp permissions" will do the same.
Please Note:If your guild stores DKP values in the public notes rather than officer notes, then you need the rights to edit public notes.
- How do I configure the mod?
Quick DKP configuration is in a .ini file, that you can find in the QDKP_V2 addon directory (usually under c:/Program Files/World of Warcraft/Interface/Addons). There you'll find a file named "Options.ini": open it with notepad or any other text editor. There you'll see a huge amount of configuration options. There are a lot of comments, so it should be easy to set it up. Once done, you can mail the file to your officers, or put it on your guild site (if any). That way, all your DKP officers will work with the same configuration.
REMEMBER: To apply the changes you make to the options file, you have to relog WoW. While you are in the process of setting things up, I suggest you to disable all mods except for Quick DKP, and use the WoW command "/reload" to import the changes you do to the options file without relogging each time.
Should you make an error setting up the options.ini file, QDKP won't be able to read it and will fall back to the default values. If your settings don't appear to be used, then probably this is what is happening. Enabling the display of LUA errors (under WoW interface options->help) can help you spot bugs in the options file.
A GUI configuration tool is in the ToDo list.
- Do I need to edit the options file each time I update the addon?
No you don't, unless the update has some new setting you need to modify from the default value. QDKP has default values for every setting, so you can just save the options file somewere on your computer (or in your guild site), update the addon, and copy back the options file over the default in the QDKP_V2 directory, overwriting it.
- Regular players can't view the DKP amounts
Have you enabled all ranks to view officer notes? If you don't want to do it, you can set QDKP to use the public notes instead. Remember to back up DKP amounts before switching storing system!
- How do I reset dkp/log/hours/everything?
The command to reset stuff is "/qdkp reset x", where x is one of these keywords: log to clear the log, dkp to reset all guild's DKP to 0, hours to do the same for the raiding hours, local to clear the data stored locally (the log, the guild externals and some settings), and all combines the previous to completely reset all QDKP related data.
The reset command has only effect with the data related to the guild you currently are in.
- Where did the "+1 Hours" button go?
You can find it under the "Quick modify" voice of player's menu in the roster. Please mind that it works with multiple selections: all of the selected members will get 1 extra raiding hour.
- I get the chat frame spammed with "xyz is not in the guild", and I have set the hide ranks OR min level filters in the options.ini.
That is a known bug that has been fixed in version 2.6.0. Update now to fix it.
- I have problems setting up the bid manager to suit my guild needs
I know, setting up the bid manager can be tricky, especially if you have no programming experience. I had to make it that way to be as flexible as possible. If you're having problems, you can mail me or post a request here on Curse with your needs.
To Do List:
-
Revisited GUI (2.6.0)
-
New Session system (2.6.0)
-
Flexible built-in bid manager (2.6.0)
-
Export of guild's dkp amounts in TXT, HTML and XLM formats with a copy/paste system. (2.6.0)
- Upgraded log window, with statistics and other advanced views (2.6.x)
- EP/GP column in the roster view, disabled by default, to make QDKP compatible for relational dkp systems. (2.6.x)
- Synchronization of Log and External's data (2.7)
- GUI Options editor with support for synchronization among guildmembers (2.7)
- Localization (Support is there, miss some strings and, most of all, contribution. Please translate the /QDKP_V2/Local/enGB.lua file and mail it to me)
- Graphs with various dkp-related data like players history, guild trend, drops etc. (maybe)
- Multiple DKP Systems (sooner or later, probably later)
Installation Guide
- Exit "World of Warcraft" completely
- Download the mod you want to install
- Make a folder on your desktop called "My Mods"
- Save the .zip/.rar files to this folder.
- If, when you try to download the file, it automatically "opens" it... you need to RIGHT click on the link and "save as..." or "Save Target As".
- Extract the file - commonly known as 'unzipping'
Do this ONE FILE AT A TIME!
- Windows
- Windows XP has a built in ZIP extractor. Double click on the file to open it, inside should be the file or folders needed. Copy these outside to the "My Mods" folder.
- WinRAR: Right click the file, select "Extract Here"
- WinZip: You MUST make sure the option to "Use Folder Names" is CHECKED or it will just extract the files and not make the proper folders how the Authors designed
- Mac Users
- StuffitExpander: Double click the archive to extract it to a folder in the current directory.
- Verify your WoW Installation Path
That is where you are running WoW from and THAT is where you need to install your mods.
- Move to the Addon folder
- Open your World of Warcraft folder. (default is C:\Program Files\World of Warcraft\)
- Go into the "Interface" folder.
- Go into the "AddOns" folder.
- In a new window, open the "My Mods" folder.
- The "My Mods" folder should have the "Addonname" folder in it.
- Move the "Addonname" folder into the "AddOns" folder
- Start World of Warcraft
- Make sure AddOns are installed
- Log in
- At the Character Select screen, look in lower left corner for the "addons" button.
- If button is there: make sure all the mods you installed are listed and make sure "load out of date addons" is checked.
- If the button is NOT there: means you did not install the addons properly. Look at the above screenshots. Try repeating the steps or getting someone who knows more about computers than you do to help.
Translations
When you download a mod, please be sure that the mod is compatible with your translation of wow. Some mods only work on the US versions, while some only work on some of the various European versions. These variations are called "Localizations".
TOC Numbers (Out of Date Mods)
When Blizzard patches WoW, they change the Interface number. This means that all mods will be "out of date" unless or until the author releases a new version for that interface. Some people go into the .toc files and update the numbers themselves, but this is STRONGLY advised against as it will cause problems locating possible incompatibilities addons. When you log into WoW after a patch, you DO NOT have to delete your interface directory. All you have to do is simply tell WoW to ignore the interface numbers and load all the mods anyway. All you have to do is, while at the "character select" screen, look in the lower left corner and click on the "addons" button. A window will pop up listing all your installed mods.
If you look in the upper left corner of that window there should be a box that says "Load Out of Date AddOns". You want to CHECK this box. Now simply go into WoW normally and all your mods should load. As of the 1.9 patch, you will have to do this after EVERY patch/update that Blizzard posts! If you encounter any problems with a mod after a patch, please be sure to let the author of the mod know so they can fix it.
See also: About "Out Of Date AddOns"
Mac Support
WoW addons are not platformed based. As such, they can be used on either Mac or PC. You can extract both .zip and .rar files on a Mac using StuffitExpander.
Directory Structure
World of Warcraft
|_ Interface
|_AddOns
|_*AddonName*
|_ *AddonName*.toc
|_ *AddonName*.xml
|_ *AddonName*.lua
|_ (possibly others as well)...
