The final stop on my whistle tour of gear ranking updates is Shaman_hep. You might say that I saved the best for last. In truth, though, I just needed to collect more data before I was ready to do a report. And to do that, I needed to raid. This week I have been to Onyxia 25, VoA 25, ToC 25, heroic ToC 25, ToC 10, and Ulduar 25. I think I’m ready.
Shaman_hep is different from most addons in that it does not run in game. It is a free-standing program (Perl script, technically) that analyzes your combat log, to see what statistics matter to you. After a night’s raiding, you pull the WoWCombatLog.txt file from your game’s Logs directory and feed it to Shaman_hep. In just a few moments it will spit out a comprehensive analysis of what you did, uptimes on all your procs, how much oomph you’re getting from your talents, trinkets and glyphs, and what you should be looking for in gear.
It’s a lot of data. But it’s remarkably easy to read, concise where it needs to be, verbose where it helps, simple to configure, and authoritative in its results.
You may recall that I had some experience with Shaman_hep back in May. At the time I was suspicious about the variability of its results, especially when compared with other Ulduar-healing Shamans. I now understand that I simply took a different road through that raid instance than most of my brethren. My current results are much more in line with expectations.

So let’s set it up.
- You need to make a config file to tell the program who you are. Make a copy of shaman_hep.cfg, and open it in your favorite text editor.
- From the top of the file to the bottom read through the comments (lines beginning with #) and fill in the information requested. Any values it needs from your character sheet should be unbuffed. When you come to the CALC_MP5 field, you’ll have to make a decision. When set to 1, the program will calculate an ideal SP/MP5 ratio for your healing. Alternatively, you can set it to 0 and specify your own ratio. I recommend trying some of both to see what kinds of results you get. High volatility in this ratio resulting from different bosses can lead to unsettlingly wild gear ranking changes from run to run.
- In game, during a raid, capture your combat log. There’s a command you can type to enable logging, but I recommend getting the addon Loggerhead to automate the procedure.
- What? Your operating system didn’t come with Perl installed? I guess you’ll have to pick up some aftermarket solution. (Hahahahaha!)
- On the command line, invoke the program, feeding it both the config file and combat log. There’s an example.bat showing you what the command line looks like. Use your local file names and fire away. The right angle bracket (>) redirects program output to a named file. I suggest giving that file a more meaningful name than “report”. Pick something like “HTOC25.txt” that you’ll be able to identify later.
- Open up the report file to reap the benefits.

The report will be broken down into 3 major sections. The first is simply a recitation of every heal it sees from you in the log. This is noise data and you can delete it. The second section, possibly many thousands of lines later, provides analysis of the log. This can get pretty beefy with useful data, so take some time to explore and familiarize yourself with what it says. For instance, when it tells me that Replenishment had a 31.85% uptime in my hardest fight, that’s a vital deviation from the assumed 100% uptime in the various theorycraft formulas.
The third—and smallest—section gives the Gear Ranking Report. Here is where everything comes together. After it has figured out how much mana you went in with plus how much you regenerated and comparing that with how much you used, on each fight, it can asses how important it is for you to gather more regen gear. Remaining budgeting can be spent on throughput. These budgets are cooked down into 3 gear weighting formulas: Max HPS, Mana Regen, and a balanced build that is a blend of the two.

Simple as pie. A word of caution, however. The results you get are representative only of the healing you feed it. Don’t rebuild your gear based on report from pugging Naxx 10 and expect it to serve you well the next night for hard mode Freya. Rebuild only when you’ve got a report for the hardest healing you’ll be doing. Where there is pain, this way will point to growth.