This project is read-only.


HeadCounter is a program for monitoring attendance and loot in World of Warcraft raids.
Data about each raid is gathered in-game using the popular raid tracking addon HeadCount. This data is then imported into HeadCounter which:
  1. Records each raid, who attended, what loot dropped and who won it.
  2. Calculates useful information about attendance percentages and how much loot each player has received.
  3. Produces simple reports about attendance and looting for posting in your guild forums.

You can think of HeadCounter as a lightweight alternative to DKP. It is ideally suited to a Loot Council approach to looting.

Why HeadCounter?

In the past guilds have used various DKP systems to monitor attendance and effort and award loot. Such systems can work very well but often has the following issues:
  1. DKP can be complicated and time consuming to set up and maintain.
  2. Problems frequently arise with inflation, point hoarding, permanent wealth gaps, etc.
  3. DKP is often unpopular with raiders.

In addition loot distribution in wow is now a far easier problem to manage for a number of reasons. Raids are smaller at 25 and even 10 man and loot is both more homogenised and less contested.
Faced with the above when deciding on a new loot system for our guild we wanted something that:
  • Was quick and easy to implement and didn’t require web hosting and/or php/SQL skills
  • Was both minimal and simple from a raider’s point of view without lots of numbers and feeling like an accounting excercise.
  • Gave the officers the important information they need for organising and running a raiding guild (attendance, loot distribution, etc).

Is HeadCounter suitable for my guild?

HeadCounter is best suited to smaller, more socially cohesive guilds who want to manage loot in a lightweight and low maintenance style.

It is not DKP and does not provide a single number that will tell you “Jim is getting Sword X”.

It is ideally suited to Loot Council or Qualifying Roll style systems. That is HeadCounter provides the information that allows a Loot Council to make good quality decisions


HeadCounter requires .NET Framework 3.5 (Service Pack 1) from Microsoft. You may already have this installed. If not it can be installed via Windows Update or from <Microsoft’s website

Once the .NET framework is installed, unzip the HeadCounter zip file to a suitable location and run HeadCounter.exe.
Select OPTIONS > general and enter your guild name, realm and region (EU, US, etc.). This will allow HeadCounter to download information about your raiders from the Armoury.

You also need to install the raid tracking addon HeadCount available from Curse .
Generally it’s a good idea for 2 or 3 people to run HeadCount in case of Wow crashes which can cause data to be lost.

How to Log a Raid

  1. Go raid, kill some bosses and acquire some loot.
  2. During the raid the HeadCount addon will record both attendance the loot and who won what.
  3. After the raid check the HeadCount data to ensure its correct. You can also edit loot to reassign it, designate as offspec, record d/e’d loot etc.
  4. In game, make sure HeadCount’s export format is set to XML (Export > Export Format > XML).
  5. Select the raid, click the export button and press Ctrl-C to get the raid data into the windows clipboard.
  6. Run HeadCounter. Select DATA > import and press Ctrl-V. You should now see details of the raid. HeadCounter will also start to download details of any loot not currently in it’s loot table.
  7. Optionally you can ignore raiders and loot by selecting the appropriate Ignore check box. This will prevent these raiders or loot being imported into HeadCounter.
#When you are happy, click Import and the data will be imported into HeadCounter.

Using HeadCounter

The first page of HeadCounter under your guild name contains information about your guild and the raids you have imported. This is divided into three sections players, raids and roster.


This page lists each player in your raid along with the following information:
  1. ATT% - the percentage of raids attended. This can be set to show 6 week, 12 week or lifetime attendance by selecting the default period option in the OPTIONS page.
  2. LOOT – the number of items looted in the default period
  3. RATE – How many items, on average, that person has acquired per raid over the default period. (I.e. LOOT / number of raids attended).
  4. GEAR – A number indicating the level of gearing that player has relatively to the base level specified in OPTIONS > Gear Scores.
  5. PRORITY – A number indicating the overall loot priority relative to the average member of your raid. This is Loot count modified by attendance percentage. Positive blue numbers indicate raiders who have received less loot than average, negative red numbers indicate raiders who have received more than average. A value of 0.00 would indicate a raider who had received exactly the average amount of loot.

These numbers are explained in more detail in following sections.

Player Details

If you select a player in the players list you will find more detailed information about that player divided into three sections, OVERVIEW, GEAR and ATTENDANCE.

OVERVIEW shows all the attendance and loot metrics calculated for that player. Each metric is show for all three periods (6 week, 12 week and lifetime).

GEAR shows the gear that player has and some simple metrics (average iLevel, an overall gear score, number of low level items, etc). This feature is currently experimental

ATTENDANCE shows which raids a player attended or did not attend and which items they looted on which raids. This is the best view of a players overall raiding and looting history.


The raids page shows a list each raid imported into HeadCounter. Selecting a raid will show you the loot that dopped, who attended that raid and who won what loot.
You can reassign loot to different raiders by dragging the loot item and dropping it onto a raiders name in the list on the right. You can also mark loot as disenchanted, offspec or banked by dragging it to the icons at the bottom left.

Finally you can grant attendance credit to players not in the raid by selecting EXTRA ATTENDANCE and setting the toggle button to ‘Yes’.


Currently the roster page just allows you to mark players as Inactive. Doing this will remove that player from the various tables and reports, for example if a player quits the game or leaves your guld.

Data for inactive players remains in the system and they can be reactivated at any point.

HeadCounter Numbers

???? More details on the numbers, how they are calculated, etc.

Exporting Data

Generally in HeadCounter the details who raided when and won what are the concern of the Officers and/or Loot Council. However, summary information can be exported for guild members either by posting to tour guild forums or by making a simple HTML only website.

Forum Posting

At various places in HeadCounter you can click a “POST...” button and this will insert a formatted forum post into your Windows clipboard. You can then post this information on your guild forums by making a post and hitting Ctrl-V to paste the data into your post.

The types of posts available are as follows:
  1. Overall attendance and gear metrics. From the players page click the POST ALL button (top right). The exact numbers included in this report are determined by the options selected in OPTIONS > export.
  2. Raid Reports From raids, select a raid and click POST RAID. This will show who attended, what loot dropped and who won which loot, for that raid.
  3. Raider Reports From the players page select a raider and click POST RAIDER. This post will contain loot and attendance metrics for that player, along with an attendance and looting history.

HTML Output

HeadCounter can also export a simpe HTML only report via DATA > Export > Export Html.
_This feature is underdeveloped at the moment as it’s not currently used. Forum posting is currently the recommend way to output data from HeadCounter.

HeadCounter Numbers

???? More details of all the various numbers

Other Features


Syncing data

The HeadCounter addon.

Last edited Feb 28, 2010 at 10:15 AM by mathematically, version 2


No comments yet.