Lightweight combat meter for WoW 1.12: damage, healing, utility and aura uptime.
Screenshots
What it is
Caw DPS Meter is a compact damage/healing/utility meter for the 1.12 client
(RavenCraft, OctoWoW and other Vanilla private servers). It reads RAW_COMBATLOG
via SuperWoW, so it tracks combat events the default combat log never exposes, and
it can pull data from other players running the addon to fill in what your client
did not see. Up to four independent windows share the same combat data.
Features
- Damage & DPS and Healing & HPS, with per-spell breakdown; pet damage and healing fold into the owner, totem damage is attributed to the caster
- Damage taken and Deaths with killing-blow detail
- Utility modes: interrupts, crowd control, CC breaks (with the breaking ability and its damage), dispels, buff uptime, debuffs cast, debuffs received
- Aura tracking: group buffs, weapon buffs and poisons across the raid
- Segments: current fight, last fight, overall session, plus a rolling
10-fight history (
/cd history) - Caw Sync: shares damage and healing snapshots with other users over SuperAPI addon messages, so late joiners and missed events still get full numbers (damage taken and deaths are local to your client)
- Chat reports to Say, Party, Raid or Guild from the in-window Report button
- Up to 4 independent meter windows, each with its own mode, segment, position, size, scroll offset and lock state
- Optional pfUI docking: right-click a window's lock icon to dock it into the pfUI right chat; multiple docked windows sit edge-to-edge and follow the chat arrow. No pfUI files are modified
- Experimental Threat view with per-target ability accounting, automatic peer discovery and talent-rank exchange, plus an optional server-reference display that does not require TWThreat
- Compact narrow-window layout with adaptive actor-name truncation to keep values readable
- Persistent window layout, lock state and selected mode
Requirements
| Component | Notes |
|---|---|
| WoW 1.12 client | RavenCraft / OctoWoW / Vanilla private servers |
| SuperWoW | client mod, provides RAW_COMBATLOG |
| SuperAPI | addon dependency (declared in the .toc) |
| pfUI | optional — enables right-chat docking |
Without SuperWoW loaded the meter will not receive raw combat data.
Installation
- Download the latest release ZIP.
- Extract it so the folder is exactly:
<WoW>\Interface\AddOns\CawDPSMeter\(the folder must be namedCawDPSMeter, notCawDPSMeter-main). - Make sure
SuperAPIis installed and SuperWoW is active. - Restart the client (version 1.0.9 adds
CawHeader.lua, so/reloadalone is not enough on first update), then type/cd. Existing settings are kept.
GitHub's green Code then Download ZIP button produces a wrongly named folder. Use a tagged release, or rename the folder to
CawDPSMeterafter extracting.
Windows and pfUI
Version 1.0.9 puts selectors and buttons in a single compact header, gives encounter names more space, and moves totals and Threat status into a reserved footer. A persistent watermark sits behind the player bars without intercepting clicks.
Shift-right-click any lock icon to switch visibility modes for all docked windows. The default follows chat visibility; alternate mode shows Caw when chat is hidden and hides Caw when chat is shown. This preference is saved per character. Both normal hiding and pfUI's alpha-only hiding are supported.
Use the + button for additional windows. Each window keeps its own mode, size, position and scroll offset, and all windows use matching bar dimensions and scroll controls.
Right-click a window's lock icon to dock or undock it at the pfUI right chat. Multiple docked windows sit edge-to-edge side by side inside the right chat area, above its status panel, and follow its arrow visibility. Combat recording and sync continue while hidden. Free windows remain independent. No pfUI files are modified; without pfUI the addon works normally.
Threat and Caw Sync
Damage/healing combat snapshots use Caw Sync. Compatible clients also announce their presence and capabilities automatically. Threat tooltips distinguish detected clients, expired replies and actual current talent data. No reply does not prove that someone has no Caw installed.
Threat is calculated locally and remains experimental. All classes exchange talent ranks/max ranks by tree and slot. Feral Instinct is currently the only remote talent applied by the threat engine; other modifiers and several utility/resource/healing rules remain incomplete. Unknown talents stay unknown. TWThreat is no longer required for server calibration: Caw can directly query the API and show a separately labeled server reference while its local engine continues unchanged.
Talent synchronization
Talent layouts are sampled once per second, sent on change and refreshed every 30 seconds. Each tree is one bounded packet; packets are spaced by at least 0.2 seconds. A profile becomes usable only after all trees arrive. Profiles expire after 90 seconds and are removed when the player leaves the group. Layouts contain ranks and maximum ranks by tree/slot, not localized talent names or inferred threat formulas. Up to 200 distinct received actor/layout combinations per calibration session are retained. Talent data is exchanged only with the current party/raid; nothing is uploaded automatically.
Standalone server reference
Disable TWThreat and restart the client to load CawServerThreat.lua. With
calibration enabled (the default), Caw queries the server for hostile NPC combat
targets while in a party/raid. The current Threat view automatically shows
Server reference* when a recent own-request snapshot passes target/segment
checks; otherwise it shows Local estimate. History/overall remain local. The
tooltip identifies the source and, when matched, the parallel local value.
The request uses limit=4, matching the tested TWThreat default request; the
display contains the returned rows, not a guaranteed full raid table. The target
must have been stable for two seconds at request time; snapshots expire after 1.25
seconds. TWTv4 has no target/request ID, so even accepted context is provisional.
After a timeout or parallel-probe ambiguity, server display is suppressed until
reload. With TWThreat loaded, Caw keeps passive calibration and local display
instead.
Local calibration recordings
This release records calibration data automatically unless the character has
disabled it. /cdthreatcal off disables recording and its automatic startup;
/cdthreatcal on enables it again. A startup message confirms active recording.
No files are uploaded automatically. With TWThreat loaded, Caw passively records
its replies; standalone calibration can query eligible combat targets.
The latest 12 sessions are kept, each limited to 12,000 model events, 6,000 casts, 6,000 snapshots, 2,000 actor contexts and bounded supporting traces. Save by reloading or logging out normally. To report a discrepancy, include version, target, ability and relevant saved calibration data. Recordings can contain player names and GUIDs; review them before sharing publicly.
Commands
/cawdps or /cd
| Command | Action |
|---|---|
/cd |
toggle the window |
/cd show / /cd hide |
show / hide |
/cd lock / /cd unlock |
lock / unlock the frame |
/cd reset |
clear the current fight |
/cd resetoverall |
clear the overall segment |
/cd resetpos |
move the window back to the default position |
/cd current / /cd last / /cd overall |
switch segment |
/cd history |
print the last fights to chat |
/cd damage | healing | damageTaken | deaths | interrupts | cc | ccBreaks | dispels | buffs | debuffsCast | debuffsReceived |
switch mode |
/cdthreatcal on / /cdthreatcal off / /cdthreatcal status |
calibration recording and direct server queries |
Chat reports (Say / Party / Raid / Guild) go through the Report button in the window, not a slash command. Window menus also select modes and history.
Window settings persist. Current/overall combat data and fight history do not survive reload/logout. All group clients should update to exchange compatible data.
Reporting a bug
For a fight that ends late, merges with another, or shows wrong numbers:
/cdlog on- Reproduce it (a few pulls).
/cdlog save, then/reload.- Open an issue and attach the
CawDPSMeter.luafrom yourWTF\Account\<name>\SavedVariables\folder.
The log records only the combat-end lifecycle and is off unless you turn it on.
See CHANGELOG.md and the 1.0.9 release notes for the full change list and known limits. The regression suite uses mocked WoW APIs; a live client is still needed for visual and multiplayer verification.
Support
Caw DPS Meter is free. If it is useful to you and you want to chip in, there is a Sponsor button at the top of this repository, or:
Contributing
Issues and pull requests are welcome. Keep changes Lua 5.0 compatible (no #
length operator, no %s gsub tricks that 5.0 lacks) and test against the 1.12
client before opening a PR.
Credits
Built by Huginn & Muninn: NovaElysium and CawDPSMeter.
License
MIT © 2026 Huginn & Muninn


