This How-To is a combination of several sources all lumped into one. Special thanks to Krellmax for his How-To, which originally got me started.

This How-To provides an in-depth review of how to administer DKP for Mafioso Guild. Any questions not related to Mafioso should be directed to Guildomatic's Forums.

First, make sure you have the latest version of the DKP mod from Guildomatic's website. Install this just like you would any other mod into your interface/addons folder.

The DKP mod is a bit tricky, I'm not going to lie to you. That being said, it isn't particularly difficult once you get used to a few commands. You might want to print out this guide and just have it next to you for reference.

First, while not completely necessary, it's a good idea to make sure you are hosting the latest DKP. I have a How-To set up here that shows you how to configure your machine to pull down the current DKP every time you launch WoW. I also have a public-post of this how-to located here, for general Guildomatic users.

First off, once you load into WoW, make sure you have the mod installed right. Type in:

/gmatic

This should return some of the options of the mod. If not, you installed it wrong. YOU'RE DOING IT ALL WRONG!

To enable people to do DKP lookups, simply type in:

/dkp on

Initially, we'll want to customize the mod a bit. First, we want to make sure it only pays attention to purple items in raids. This command is:

/snapshot loot purple

Likewise, I recommend you set the mod so it ignores purple items we don't assign DKP for, such as badges and/or nether vortexes:

/snapshot ignore badge of justice

/snapshot ignore Nether Vortex

/snapshot ignore Void Crystal

/snapshot ignore Emblem of Valor

/snapshot ignore Emblem of Heroism

/snapshot ignore Abyss Crystal

(Please note, the above items can also be ignored through your Administration Console --> DKP Settings.)

Now, you'll see that its the SNAPSHOT command that we'll be using most often to record Items and DKP values.

First, and before you try to distribute loot for any raid, you'll want to make sure you type the following to ensure that you don't have any old Snapshots:

/snapshot clear

The rule is that Loot will show up in the mod under the last Snapshot. Snapshots will be automatically created once a boss is killed, and therefore the items looted after that boss show up under that snapshot. What if, however, you get some Trash loot before you kill the first boss? Basically, it won't show up, so I've created a "trash" snapshot event to capture these items.

When you first start an instance, or after having updated DKP (and cleared your snapshots), you'll want to create a Trash snapshot. Please note that you will need to create a "Trash" raid event under Admin Console--> Raid Snapshot Events. I likewise have another event created, called "On Time."

/snapshot trash 0

And, you can see the snapshot we just created by typing the following command:

/snapshot list

It will return something like this:

1. Trash - 7/22/08  22:56:06

Now we're prepared for items to show up under that snapshot.

Upon killing a boss, an new snapshot will automatically be created. If you do a "/snapshot list," you'll see the new snapshot, and as you distribute loot, those items will show up underneath that bosses Snapshot.

After you've distributed loot (please write down the player and bid-value as a backup), I recommend exiting the game, and uploading the DKP module. Once you're at the web-page, you can edit the values people spent. If you choose not to upload at this moment, I HIGHLY recommend at least performing a reload, so that if WoW were to crash, your data would still be saved to disk. You can do this as following (set up a macro):

/script ReloadUI();

Currently, the built-in auction module sucks, so we're just manually taking whispers for DKP. Please note, that as long as you set up your machine so that its pulling down the DKP automatically, you can easily check someone's bid before they are distributed loot. That command is:

/dkp username

Please make a habit of checking the top two bidders before distributing loot. Deliberate Looting eliminates GM tickets, so take your time.

Once you've announced the winning bidders and all loot is distributed, you should be able to see that loot in your DKP mod. Try the following command:

/snapshot list

This should return something similar to:

 

1. Hydross the Unstable - 4/14/08 21:14:00

.. 1.  JoeSchmoe - [Purple Ring of Awesomeness] -  -

.. 2.  RaiderGuy  - [Good Mace of Mediocrity] - -

.. 3.  MikeHunt  - [Wand of Off-Spec] - -

Since you recorded each user's DKP manually on paper (right?), now you just have to assign it to the snapshot. Assuming that JoeSchmoe paid 10 DKP for the [Purple Ring of Awesomeness], here's how you'd record it:

/snapshot note 1 1 10

Which means "Make a DKP note for Boss 1, Item 1, of 10 DKP"

Then you'd assign the rest:

/snapshot note 1 2 12

/snapshot note 1 3 0

Your /snapshot list command should return something like this now:

 

1. Hydross the Unstable - 4/14/08 21:14:00

.. 1.  JoeSchmoe - [Purple Ring of Awesomeness] -  10 DKP

.. 2.  RaiderGuy  - [Good Mace of Mediocrity] - 12 DKP

.. 3.  MikeHunt  - [Wand of Off-Spec] - 0 DKP

So, now you're ready to exit WoW, and upload DKP to the website...

Point your web-browser to: http://www.mafiosoguild.com/raids/upload

Browse to your GuildomaticDKP.lua as the path shows on that page, and click "upload."