GsValheimStatsClient (client companion)

Client companion for the self-hosted gs dashboard. Install it alongside your gameplay mods; it posts your personal Valheim stats — the things only the client knows:

• Valheim's built-in PlayerProfile counters (items crafted, structures built, distances walked/run/sailed, enemies slain, deaths, …)
• Skill levels
• Materials gathered (Wood, Stone, ores, …)
• Per-life death details — cause (incl. 🪓 felled-by-your-own-tree and 🦟 Deathsquito), biome, time alive, kills before dying

Pairs with the server-side GsValheimStatsEmitter (per-player boss damage + kill events). The dashboard merges both feeds.

Setup

Install via r2modman/Thunderstore. On first launch it writes BepInEx/config/net.cproudlock.gsvalheimstatsclient.cfg:

[General]
World = vhserver3      # must match the server's world name

[Ingest]
Url = https://gs.proudtech.net/api/valheim/ingest
Token = <bearer token from the dashboard owner>

v0.1.0 — initial release. Per-item craft breakdown lands in v0.2; for now the craft count comes from Valheim's own Crafts counter.

Changelog

0.2.10

• Fixed grossly inflated (and in other cases under-counted) "materials gathered" totals. Materials now come from Valheim's own cumulative, character-persistent pickup counter (PlayerProfile m_itemPickupStats), filtered to Material-type items, instead of a hook on Inventory.AddItem. The old hook fired on every inventory add, so hauling a resource between chests or recovering it from your tombstone re-counted the whole stack (silver was the worst offender), and it was session-only so anything gathered in a previous play session was lost.

0.2.9

• Per-life stats (time alive, kills that life, longest life, best streak) now measure a life from the game's own cumulative counters (active play time + kills) instead of the per-session clock, and the start-of-life snapshot persists across logins. A life that spans multiple sessions is now counted correctly, and offline time is excluded. Previously these reset every launch, so a death only logged the final session's slice.

0.2.8

• Boss-kill detection moved client-side: every kill emits a per-fight event (first blood, top damage, DPS, participants), so the boss-fight chronicle and repeat-kill history work. Fixed the headline boss-kill count.

0.2.7

• Docs: plain-text README (removed em-dashes and emoji).

0.2.6

• Docs: dropped em-dashes and emoji from the changelog and wiki for a plainer style.

0.2.5

• Docs: link to the new Data format & self-hosting wiki.

0.2.4

• Docs: refreshed README ingest examples (reporter, multiplayer combat-only entries, bossSelfDamage) and bundled this changelog.

0.2.2

• Fire / poison / spirit damage-over-time is now credited to the player who applied it - works even when several players stack burns on one boss (each application is attributed at the moment of the hit).
• Capture boss self / environmental damage (lava, the boss's own fire, falls) - damage a boss takes with no player attacker, reported per boss.

0.2.1

• Emit-on-milestone: a new hardest hit or a kill flushes a post within ~15s instead of waiting the full interval, so big moments show up fast.

0.2.0

• Multiplayer weapon attribution: whichever client owns a creature now records the damage every player deals to it, attributed to the real attacker and source-separated by reporter. Combat totals are exact across a group, no double-counting.

0.1.9

• Removed debug logging.

0.1.8

• Fixed hardest hit. Now hooks Character.RPC_Damage (where backstab/crit/armor are actually applied) instead of the Damage forwarder, so post-backstab numbers are captured correctly.

0.1.7

• Boss DPS (active engagement timing), specific weapon items (Bronze Sword vs Iron Sword), trophies, and biggest total swing (cleave/AoE).

0.1.6

• Weapon damage / kills / hardest hit, captured client-side.

0.1.x

• Initial release: Valheim PlayerProfile counters, skills, per-creature kills, per-item crafts, materials gathered, and per-life death details (cause incl. felled-by-tree, biome, life length, kills before dying).