Proudlock_Technology-GsStatsEmitter icon

GsStatsEmitter

Posts run summaries (stages, items, stats, bosses, mods, equipment) to a self-hosted gs dashboard on every run end. Heartbeats while playing.

Last updated 5 hours ago
Total downloads 11
Total rating 0 
Categories Tools AI Generated
Dependency string Proudlock_Technology-GsStatsEmitter-0.8.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

bbepis-BepInExPack-5.4.2103 icon
bbepis-BepInExPack

Unified BepInEx all-in-one modding pack - plugin framework, detour library

Preferred version: 5.4.2103

README

GsStatsEmitter

A small BepInEx mod that POSTs Risk of Rain 2 run summaries to a self-hosted gs dashboard. Only the lobby host emits, so installing on a non-host has no effect. Source: https://github.com/cproudlock/gs-stats-emitter-ror2.

What it captures

On every run end (Run.onRunDestroyGlobal):

  • Run metadata: seed, difficulty, eclipse level, stage clear count, run time, ended-on scene
  • Per-stage breakdown: time per stage, scene name, stat deltas per player (kills, damage, healing, gold, items collected during that stage), items picked up during the stage
  • Per-player snapshot: character body name, dead/alive, items by internal name + count, killed-by (attacker body name), host flag
  • Stat sheet totals: total kills, elite kills, deaths, damage dealt/taken, healing, gold collected/spent, distance traveled, minion damage, damage blocked
  • Final character build: maxHealth, maxShield, damage, attackSpeed, moveSpeed, crit, armor, regen, jump power, level
  • Loadout: primary / secondary / utility / special skill choices + equipped Q item
  • Boss kills: counts per boss body name (Mithrix, Voidling, Aurelionite, …)
  • Run-level: artifacts enabled, currently-loaded mods (GUID + version + author + folder), full item-tier map for the run's catalog

Heartbeats fire every 30 seconds during an active run so the dashboard can show a "currently playing" banner.

Setup

Install via r2modman, or drop the DLL into BepInEx/plugins/ manually.

After first launch the mod generates BepInEx/config/net.cproudlock.gsstatsemitter.cfg. Edit the two values:

[Ingest]
Url = https://gs.proudtech.net/api/ingest
Token = gsk_xxxxxxxxxxxxxxxxxxxxxxxx

Without a valid token the dashboard returns 401 and nothing is recorded.

Getting an ingest token

The dashboard owner mints a gsk_* key for each friend at /admin/api-keys on the gs instance. Ask them for one. The key is yours, do not share it. If you ever leak it, the owner can revoke and re-mint in a few seconds.

Privacy

The mod only emits when you are the lobby host. If you join someone else's lobby it stays quiet. All payloads include your Steam display name and the names of everyone else in the lobby. Self-host the dashboard if that matters to you.

License

MIT.