HoldfastCensusLite
Privacy-friendly stats tracker for Holdfast: Nations At War - passively captures only YOUR per-round statistics and reports them to a stats backend of your choice.Changelog — Holdfast Census
All notable changes to the Holdfast Census mods (full tracker and the self-only
Holdfast Census Lite variant; both ship as one release and share one version).
Format loosely follows Keep a Changelog; versions follow
SemVer. The version lives in both csproj and both Plugin.cs files and is bumped together.
[1.7.3] — 2026-11-10
Fixed
- Mid-round disconnect live score capture (
local-left): HookedDisconnectFromServerGracefullyInGameanduLink_OnDisconnectedFromServerprefixes to capture live scores and scoreboard fromClientRoundScoreManager(PlayerScoresDictionaryandLocalScoreAccumulatedCurrentRound) immediately before connection teardown, ensuring mid-round leaves retain their full in-game score (formation bonuses, capture points, flag auras, kills/deaths) rather than staying at-1. - Early event & first kill capture in Lite: Resolved the local player ID proactively from
ClientRoundPlayerManager.LocalPlayer.NetworkPlayerID,LocalNetworkPlayer.id, anduLink.Network.player.idas well asPlayerOwnerspawn component instead of solely waiting for delayed network join packets. Added Steam ID fallback matching on kill events, preventing the first kill or early scorable actions from being dropped when connecting or across map transitions. - End-of-round score capture: Hooked
_SetFactionAttributesonPlayerEndOfMatchListandAllPlayersEndOfMatchListand added fallback toroundScoreManager.PlayerScoresDictionary. Fixed uninitialized 0 scores from_SortEntriesoverwriting action combat points (snapshot_scoresafeguard).
[1.7.2] — 2026-11-10
Fixed
- Initial end-of-round score capture hooks on
PlayerEndOfMatchList.
[1.7.1] — 2026-11-10
Fixed
- End-of-round scoreboard snapshot capture: captures server-authoritative end-of-round totals
(
snapshot_score,snapshot_kills,snapshot_deaths) fromUIEndOfMatchListEntryon the end-of-match screen, fixingsnapshot_score == -1across round reports and ensuring bonuses (line battle formation, flag aura, capture point ticks, round victory) are preserved.
[1.7.0] — 2026-11-08
Added
- Non-melee kill distance (
distancein each entry ofkills[]): captures the server-computed 3D distance in meters for all firearm and artillery kills (muskets, rifles, pistols, cannons, mortars, rockets, explosions). In the Lite mod, distances are recorded for all non-melee kills and deaths involving the local player. Omitted for melee kills (bayonet, sabre, trample, kick). Captured via Harmony prefix onClientRoundScoreManager._ExecuteScoreableActionPacket.
[1.6.0] — 2026-11-06
Added
- Leaderboard placement on your team (
leaderboard_place): captures your 1-based rank on your side of the scoreboard when a round officially ends (flush_cause == "round-end"). Captured via Harmony postfix onPlayerEndOfMatchList._SortEntries()with fallback calculation against the server scoreboard snapshot. - Omitted entirely if leaving mid-game without the round completing (
flush_cause != "round-end", e.g.local-left).
[1.5.0] — 2026-11-06
Added
- Player names in kill records (
killer_nameandvictim_namein each entry ofkills[]). In the Lite variant (Holdfast Census Lite), this ensures the opponent's in-game name is captured and transmitted alongside their Steam ID for all kills and deaths involving the local player. - Serializer fallback to
PlayerRegistryfor killer and victim identities at payload build time, guaranteeing names and Steam IDs are populated even if join events were processed late.
[1.4.0] — 2026-11-05
Added
- Personal per-reporter authentication via
[Tracker] ReporterSecret: binds the reporter's Steam ID to an ingest secret issued by the stats backend admin, preventing identity spoofing. - Sent as
X-Reporter-SecretHTTP header on every ingest POST. - Clear actionable BepInEx error logging and permanent drop handling for HTTP 401/403 responses
from the backend (
reporter secret missing,invalid reporter secret,reporter secret not configured,reporter blocked), preventing endless retries for permanent configuration failures while keeping genuinely transient errors retrying. - Prominent startup warning when
ReporterSecretis not configured.
[1.3.1] — 2026-11-04
Changed
- Renamed the BepInEx plugin identity (GUID) of both variants to the author domain:
- Holdfast Census:
com.holdfastcensus.tracker→dev.gmrrh.census - Holdfast Census Lite:
com.holdfastcensus.tracker.self→dev.gmrrh.census.lite
- Holdfast Census:
- The config filename and the cache/dumps folder derive from the GUID and follow the
rename:
BepInEx/config/dev.gmrrh.census[.lite].cfgandBepInEx/plugins/dev.gmrrh.census[.lite]/cache/.
Upgrading an existing install
- To keep your settings and cached payloads, rename the old files instead of deleting
them:
BepInEx/config/com.holdfastcensus.tracker[.self].cfg→dev.gmrrh.census[.lite].cfg, and theBepInEx/plugins/com.holdfastcensus.tracker[.self]/folder →dev.gmrrh.census[.lite]/. - If you do nothing, the mod starts with a fresh default config (ingest token empty — re-enter it); the old files simply stay behind, harmless.
No capture-logic or payload changes: the wire schema (census.mod.round.v1) and the
signature handling are unchanged.
[1.3.0] — 2026-11-04
Added
- Optional server-name blacklist/whitelist (
UseServerBlacklist/ServerBlacklist,UseServerWhitelist/ServerWhitelist): case-insensitive contains-match on the full server name; the blacklist wins over the whitelist. A filtered round is discarded locally — no payload is created or sent.
[1.2.2] — 2026-10-29
Fixed
- Rounds the local player leaves mid-way are now reported: the game never delivers the leave event for the local client on disconnect, so the final flush is anchored on connection-teardown hooks instead.
[1.2.0] — 2026-10-28
Added
- Standalone self-only variant Holdfast Census Lite (own package, own GUID; payloads
carry
"self_only": true): captures and uploads only the local player's per-round statistics, for players who do not want to report the whole server.
[1.1.0] — 2026-10-23
Added
- HMAC payload signing: every report is signed over the schema id and body so the backend can verify it was produced by the mod. The signing key ships public — the backend must perform its own validation and dedup.
[1.0.0] — 2026-10-22
Added
- Initial release: passive per-round capture of every player on public servers (joins, kills, damage attribution, scoreboard snapshots), on-disk retry cache for offline backends, round-end POST to the configured ingest endpoint, client-side only.
