CombatMeter

CombatMeter 1.1.2 provides host-authoritative PvE combat statistics for Valheim 1.0.16 in single-player and Listen Host multiplayer.

Compact combat meter

The compact HUD shows your current combat group: player damage, contribution, personal active-time DPS, damage taken, encounter state and elapsed time. Optional Maximum Crit (largest accepted hit) and Deaths columns are available. Contribution bars use deterministic player colors, and the HUD can be moved and scaled.

Combat starts and finishes automatically from PvE activity. Players fighting unrelated enemies can have separate encounters; groups merge when their combat interactions connect. Recovery is tracked by the host, and the compact meter hides after the encounter finishes.

DPS uses personal active damage time: a short configurable activity window counts after damage, while longer idle gaps are excluded. Dodging, repositioning or recovering stamina does not make DPS fall indefinitely.

Combat Details — hold LeftAlt

Hold LeftAlt to inspect the current or most recent encounter and select a player. Three tabs show:

• Damage: total damage, encounter DPS, Maximum Crit, and all nine damage categories ordered by damage, including zero values.
• Defense: damage taken, blocked damage, successful blocks, parries and dodges, barrier absorption and barrier breaks.
• Enemies: enemy types and the selected player's personal kills. Zero-kill entries are hidden; visually identical enemy names combine personal kills and sort by kills descending, then name.

Damage and Defense use grouped sections, consistent numeric alignment and subdued zero values. Player scoreboards also include kills and deaths.

Combat Statistics — toggle F7

Press F7 to open a persistent statistics window; press F7 again or Escape to close it.

• Summary shows the current shared host/server session: completed encounters, combat time, enemies killed and player totals. Select a player for Damage, Defense and Enemies. Session totals include finalized encounters only and do not show Session DPS.
• Combat History lists completed encounters newest first, grouped by their recorded day. Load further pages on demand and select a historical encounter to inspect its scoreboard and player details.

Combat history is saved by the host between game restarts. The current session starts fresh when the host enters a world; reconnecting a client does not reset the host's continuing session. The active encounter remains in the compact HUD and Combat Details until finalized.

Statistics load when needed and refresh after completed encounters or a manual Refresh click. The window does not periodically poll history.

Controls and configuration

• F8: show or hide the compact meter.
• Ctrl+F8: enter or leave HUD edit mode; drag the header to move it.
• Shift+F8: reset HUD position.
• Escape: leave edit mode or close Combat Statistics.
• Hold LeftAlt: Combat Details.
• F7: toggle Combat Statistics.

Hotkeys, HUD scale, width, opacity, bars, visibility and position are configurable local preferences in BepInEx/config/Likhtenvald.CombatMeter.cfg. In [UI], Show Largest Hit and Show Deaths are independent compact-HUD options disabled by default; the host records both regardless of visibility. Combat Details uses its configurable Hold Key, and Combat Statistics has its own configurable key.

While an interactive CombatMeter window owns the mouse, the cursor is visible, mouse look and combat/world actions are suppressed, and the wheel belongs to the UI. Vanilla W/A/S/D movement remains available. Inventory, map, menus and other major vanilla UI take priority.

Host-controlled defaults are Combat Timeout = 20, Recovery Timeout = 180 and DPS Idle Timeout = 6. Client timing settings do not override the host. Diagnostic logging is disabled by default; enable the relevant category only for troubleshooting.

Installation and multiplayer compatibility

Install using a Thunderstore-compatible mod manager, or manually place CombatMeter.dll under BepInEx/plugins/CombatMeter/ with these dependencies installed:

• Valheim BepInEx pack 5.4.2350.
• Jotunn 2.30.2 or later.

Current supported target: Valheim 1.0.16. Supported modes: single-player and Listen Host multiplayer. Dedicated servers are not currently supported.

Every multiplayer participant must have CombatMeter and use the exact same public version and network compatibility generation. CombatMeter 1.1.2 uses compatibility generation 2. Missing mods, older builds and version mismatches are rejected during connection; there is no bypass setting.

The host calculates combat statistics and distributes each player's own combat-group view. Combat Details and Statistics use authoritative host data, including when a remote character is outside the host's loaded scene. CombatMeter is intended for cooperative play and is not an anti-cheat system.

Upgrade from development builds

Remove the old DiagnosticDamageProbe.dll before installing CombatMeter; do not keep both DLLs in the same profile. Recognized legacy settings are imported on first launch only when the new config has no user settings. The old config is left untouched.

Known limitations

• Summon and magic attribution covers implemented provenance paths; unsupported sources can remain unattributed.
• Summons that existed before the current network session may lack provenance.
• Extremely late DPS events older than compacted activity history receive bounded handling.
• Fall, drowning and smoke do not contribute to combat encounters. Other environmental sources retain their existing policy.

License

CombatMeter is distributed under the MIT License included in this package. Technical documentation is available under docs/ in the source repository.