• • • • • IMPORTANT

This mod must be customized for use. It will not load "out of the box" until you rename/copy "customize.lua". Even then, it will load but will do nothing useful until your guild determines which items are to be tracked, what their DKP is worth, and so on. See "how to maintain" below.

The settings shipped in the example customize.lua are conserative for safety, but disable some features.
***** IMPORTANT


This is a home-grown DKP mod used by the Incursion guild (Horde, Kilrogg realm). Its primary purpose is to add DKP information to the tooltips for items and people. It also allows player scores to be announced to the raid channel, for the players present in that raid. For example, "scores for warriors and rogues" or "scores for players that can use one-handed swords" or "all casters" or "the weekly Thursday PvP group", etc.

The DKP points for items and for people are read from separate files. Whether you maintain them by hand, or by exporting a spreadsheet, or by an external "download the latest version" program, makes no difference to the mod. It's all your responsibility.  :-)

The structure and usage of this addon evolved to meet the needs of our guild. As such, I never added commands for things that we don't need. I'm not particularly interested in adding things that we wouldn't use, but hopefully the code is clear enough for you to modify.

Instructions for setting up, using, and maintaining your guild's copy of the addon are included in the zip file; simply open _incdkp_docs.html in your favorite web browser.


*************** non-ASCII names
When creating the data files, you need to be aware of special problems regarding player names with non-ASCII letters. This is not unique to this addon, and unfortunately, there's nothing the addon can do about it.

The Lua parser does not recognize these special letters as being "letters" (I mean "letters" as distinguished from "digits" or "punctuation" or "spaces", etc). This means that Lua splits up the player's name into two words... which of course will never match anything in the actual game.

There is no way to tell the game which letters to treat as "letters". Lua is normally capable of changing that, but the game imposes more restrictions on an addon than normal Lua programs have.

The solution, apparently, is to be careful when creating the data files. I asked on the Blizzard forum and got this response from another player:
https://forums.worldofwarcraft.com/thread.aspx?fn=wow-interface-customization&t=210712

Please don't ask me for help in creating those UTF sequences. I don't use them myself, and I wouldn't know how to do so. The best example I can give is in the example mypoints.txt file. If you devise a method that works well, feel free to share it here.