Changelog

1.0.1

• Fixed the Stats button in the pause menu sitting on top of Quit game. It lines up under the other buttons now. When the Active moons button is showing there isn't quite room, so Quit drops down a few pixels to make some.

1.0.0

• The stats screen. Open Stats from the main menu or the pause menu, pick Career, Today, Last 7 days or This run, narrow it to a category if you want, and every stat is listed with its value, grouped like a character sheet. Time, distance and money read the way you would say them. Deaths by Enemy, Damage by Enemy and Map Visits open into a top list, and Career starts with a Highlights block: when StatsCore started recording, your most deadly enemy and your favorite level.
• Your career is one record across every mod manager profile. It is saved in the game's own per-user data folder instead of inside each profile's config. The first time a profile runs this version its old career file is added into the shared one and renamed to career.txt.migrated, so profiles you played separately end up summed and nothing is counted twice.
• It lists every stat any mod registers. A stat that never got a name or category still shows, under Other, with a name built from its key.
• Both buttons can be switched off under Stats screen in the config. The screen needs MenuLib, which is a dependency now. Without it StatsCore tracks and syncs exactly as before.
• The library API is unchanged since 0.1.x. This is 1.0.0 because it is the first version with something to look at.

0.1.2

• Updated for the 0.5 game build. The API is the same.

0.1.1

• Career rows belonging to a stat nobody defined this session are kept instead of dropped. Running once without a mod that owns some career stats used to erase its history on the next save; the same went for daily buckets when a stat never called TrackDaily().
• Daily buckets are the machine's local calendar day, not UTC. GetToday read UTC while GetOnDay read the raw date components off whatever you handed it, so the two disagreed between local midnight and UTC midnight. Buckets written by 0.1.0 can sit one day off; everything from here is consistent.
• Slot keys are sanitized. Deaths-by-enemy, damage-by-enemy and map visits key on a display name a content mod can set to anything, and | = ; , in one of those split a save line or a snapshot frame in the wrong place. Those characters fold to _ now.
• Fixed a NullReferenceException every frame between the chainloader and the first level: the driver called SemiFunc.RunIsLevel(), which dereferences RunManager.instance unguarded, before it existed.
• StatsNet attaches to PunManager even when its Awake already ran before the chainloader reached us. It used to leave sync silently dead for the whole session.
• Host migration: the new master pushes a snapshot so the room agrees on the values it is now authoritative for, and pulls the old host had open are dropped rather than firing a half-filled callback.
• A client can no longer answer the same RequestFromClients pull more than once and complete it before the rest of the room replies; a client that leaves mid-pull stops being waited on.
• A networked write naming a career stat is refused. Career never rides the wire, so nothing legitimate sends one, and without the check a peer running a patched build could write straight into another player's permanent record.
• Career files carry a version header and the atomic swap keeps the version it replaced as .bak, which is read back if the live file has gone unreadable. Files written by 0.1.0 still load.
• Mirrors on synced stats are no longer sampled on clients, where the write was dropped and logged every 3 seconds for the whole session.

0.1.0

First release.

• Define a stat once (Stats.Define("author.mod.stat", scope, lifetime)), then read and write it through the returned handle. Keys validate at Define; reserved framing characters throw immediately.
• Four lifetimes: Level, Run and Session sync across the room; Career persists locally to disk.
• Host-authoritative sync (default): the host's writes replicate to every client running StatsCore, late joiners get a full snapshot on entry, and off-host writes drop with a debug log (gate on Stats.IsHost).
• Client-authoritative sync (ClientAuthoritative()): each client owns its own player's slot and pushes changes to everyone; receipts reject any client trying to write another player's slot.
• Host-pull (Stats.RequestFromClients(key, callback)): the host asks every client for its local value of a key and collects the answers, so a scoreboard can gather everyone's Career/local stats on demand.
• Career stats persist to BepInEx/config/StatsCore/career.txt with debounced, atomic writes. First and last timestamps ride along.
• Query by day: opt a Career stat into TrackDaily() and read GetToday, GetOnDay, GetRange, GetLastDays, and DailyHistory. Per-day history persists to career-daily.txt.
• Lifetime resets follow the game's actual scene transitions, including the truck-lobby vs lobby-menu distinction that usually eats run stats.
• Trackers bind game state to a stat in one place: Hook rides a vanilla method (zero per-frame cost), Mirror/MirrorPlayers sample a value the game already keeps. A renamed or removed target disables just that one tracker, logged, instead of crashing.
• Built-in GameStats pack any mod can read without defining anything: deaths (with per-enemy breakdown), knockdowns, spewer faces, damage taken (with per-enemy breakdown), hits, revives, health healed, crown wins, enemies killed, map visits, distance walked/sprinting, objects grabbed, friendly fire, and live synced mirrors of the run's level, currency, and haul.