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.
| Date uploaded | a week ago |
| Version | 1.7.2 |
| Download link | Modfast-HoldfastCensusLite-1.7.2.zip |
| Downloads | 7 |
| Dependency string | Modfast-HoldfastCensusLite-1.7.2 |
This mod requires the following mods to function
HoldfastModding-BepInExPack_Holdfast
BepInEx pack for Holdfast: Nations At War. Preconfigured and ready to use.
Preferred version: 5.4.2305README
Holdfast Census Lite
Holdfast Census Lite is a privacy friendly statistics tracker for Holdfast: Nations At War. It passively records your own per round performance stats like shots, accuracy, damage, kills, deaths, score, classes, weapons and reports one summary per round to the stats backend of your choice.
It is built for any player or regiment who wants round data: point it at your community's stats backend and every member who installs the mod contributes their own numbers to your leaderboard. It reads the same game events the client already receives during normal play, no gameplay advantage, no server-side installation, no game-file changes.
This is the self-only variant: it never records other players. The full Census mod did alredy finished development and will be released after i now that its allowed. Never install both mods at the same time, they would report every round twice.
What data does it collect?
Everything comes from data the game client already receives while you play (the official script-mod event bus, the server-replicated scoreboard, and health-change packets). The mod only reads.
Collected (your data only):
- Your per-round stats: shots fired, dry shots, hits, accuracy
(
hits_from_damage / shots_fired), damage dealt/received, kills, deaths, teamkills, suicides, score, classes played, weapons used, plus the server-authoritative scoreboard row for you - Your 1-based leaderboard place on your faction/team when a round completes
- Kill records you took part in: your kills and deaths store the opponent's name and Steam id so your kills/deaths stay attributable on a leaderboard
- Match metadata: round id, server name, map, factions, game mode/type, friendly-fire and stats-tracking flags, round start/end times
- Your Steam id and in-game name; how many players were on the server
Never collected: text chat, voice, admin actions, blocks, ping/IP addresses, hardware or OS info, positions or camera data and nothing about other players beyond the opponent name/id inside your own kill records.
Where is the data sent?
At the end of every played round (round end, map change, or when you leave the
server) the mod builds one JSON document and sends it with a plain HTTP
POST to the URL configured in Tracker.EndpointUrl.
- The payload is plaintext JSON not encrypted. You can audit every byte:
with default settings each payload is also written to
BepInEx/plugins/dev.gmrrh.census.lite/cache/dumps/before sending. - Requests carry an
X-Census-Signatureheader (HMAC-SHA256 over the body) so a backend can reject edited/forged payloads. - Out of the box the mod sends nothing: the default endpoint is a local
testing address (
http://127.0.0.1:8000/...). SetTracker.EndpointUrlto your community's stats backend to enable reporting. Any regiment can run their own backend the contract is a single POST endpoint per round. - If the backend is unreachable, payloads are cached on disk and retried
automatically later (up to
Tracker.CacheMaxFilesfiles). - Rounds played on servers you blacklist, or on servers with stats tracking disabled (if you enable that option), produce no payload at all.
Install
- Install Thunderstore Mod Manager or r2modman for Holdfast: Nations At War.
- Install Holdfast Census Lite from this page the required BepInEx pack is installed automatically as a dependency.
- Play. Round summaries are reported automatically; nothing else to do.
Kurzanleitung (Deutsch)
- Thunderstore Mod Manager oder r2modman für Holdfast: Nations At War installieren.
- Diese Mod installieren das benötigte BepInEx-Pack wird als Abhängigkeit automatisch mitinstalliert.
- In
BepInEx/config/dev.gmrrh.census.lite.cfgdieTracker.EndpointUrlauf die Stats-Backend-Adresse eurer Community setzen (Standard ist eine lokale Testadresse, d. h. es wird nichts gesendet). - Spielen: nach jeder Runde wird automatisch eine Zusammenfassung gemeldet.
First launch check
After a modded launch, BepInEx/LogOutput.log should contain:
[Census] Hook applied: map-init anchor (round details)
[Census] Hook applied: mods-loaded anchor (event registration)
[Census] Hook applied: scoreboard snapshot
[Census] Hook applied: damage attribution (optional)
[Census] Hook applied: client disconnect (local-left flush)
[Census] Hook applied: round-end leaderboard rank
[Census] Hook applied: non-melee kill distance
[Census] Payload signing self-test: ok
[Census] Holdfast Census Lite v1.7.2 (self-only) ready. Endpoint: …
After finishing a round you should see
[Census] Round payload queued (cause=round-end, …) — or
[Census] Server filter: '<name>' blocked (…) — recording disabled for this map.
when the server matched your blacklist/whitelist settings.
Configuration reference
Config file (created on first launch):
BepInEx/config/dev.gmrrh.census.lite.cfg
(your mod manager's config editor can edit it too — changes apply from the
next map load).
[Tracker] — capture & reporting
| Key | Type | Default | Effect |
|---|---|---|---|
Enabled |
Bool | true |
Master switch. false = nothing is captured, nothing reported. |
EndpointUrl |
String | http://127.0.0.1:8000/api/ingest/mod |
URL the round payloads are POSTed to. The default is a local testing address nothing leaves your machine until you change this. Set it to your regiment/community stats backend to enable reporting. |
IngestToken |
String | (empty) | Optional shared token, sent as X-Ingest-Token header. Backends use it for routing/rate-limiting; it is not a secret (the mod is public). |
BearerToken |
String | (empty) | Optional JWT, sent as Authorization: Bearer <token> in addition to the ingest token for backends that require authentication. |
ReporterSecret |
String | (empty) | Personal per-reporter secret, sent as X-Reporter-Secret header. Obtained from your stats backend admin; binds your Steam ID so reports cannot be forged. |
MinPlayers |
Int | 1 |
Rounds with fewer players on the server are not reported (records still exist locally in test mode). Raise this to skip quiet/practice rounds e.g. 10 reports only rounds with at least 10 players. |
SkipServersWithStatsTrackingDisabled |
Bool | false |
Many official servers run with stats tracking off. false (default) = record anyway, the payload notes the server's flag. true = capture nothing on such servers. |
UseServerBlacklist |
Bool | false |
Enables the server-name blacklist: no round on a matching server is captured or reported. The blacklist wins over the whitelist. |
ServerBlacklist |
String | (empty) | Comma- or semicolon-separated server-name fragments (see below). |
UseServerWhitelist |
Bool | false |
Enables the server-name whitelist: rounds are captured only on matching servers. Leave false to record everywhere. |
ServerWhitelist |
String | (empty) | Comma- or semicolon-separated fragments (see below). An empty list with the whitelist enabled allows every server fill it or leave the whitelist off. |
CacheMaxFiles |
Int | 200 |
How many unsent payloads are kept on disk (cache/pending_*.json) when the backend is unreachable, for automatic retry. Oldest files beyond the cap are dropped. |
[Debug] — diagnostics
| Key | Type | Default | Effect |
|---|---|---|---|
DebugDumpPayload |
Bool | true |
Writes every payload JSON to cache/dumps/dump_<time>_<cause>.json before sending, your built-in audit log of exactly what leaves your machine. Set false to disable. |
TestMode |
Bool | false |
Full test mode: journals every captured event to cache/dumps/testrun_*.log, always dumps payloads, and disables network sending entirely. Use to try the mod without any data leaving your PC. |
VerboseEvents |
Bool | false |
Logs every captured game event to LogOutput.log (very spammy, debugging only). Implied by TestMode. |
Server blacklist / whitelist
Matching is case-insensitive "contains": an entry matches when the full server name contains it anywhere. Entries are separated by commas or semicolons. The filter is evaluated once per map load; a blocked server logs one line and produces no payload.
[Tracker]
UseServerBlacklist = true
ServerBlacklist = Training, DuelsOnly
UseServerWhitelist = true
ServerWhitelist = MyCommunity EU, MyCommunity US
UseServerBlacklist = true+ServerBlacklist = Training→ never records on servers with "Training" anywhere in the name.UseServerWhitelist = true+ServerWhitelist = MyCommunity EU, MyCommunity US→ records only on those servers.- Both enabled → a server matching both is blocked (blacklist wins).
Privacy
- Only your own gameplay statistics are captured and sent. Other players appear solely as Steam ids inside your own kill records.
- Everything is stored locally in readable JSON first (
DebugDumpPayload/TestMode), audit any payload before it is ever sent. - The payload and signature are tamper-evidence for the backend, not encryption; the backend you point the mod at receives exactly what you can read in your dumps.
- Uninstalling removes the DLL; leftover config/cache folders under
BepInEx/plugins/dev.gmrrh.census.lite/can simply be deleted.
Links
- Full variant will (hopefully) follow soon
CHANGELOG
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.