Thunder

wiki:  Thunder- Ethertaco Docs

Description

⚡ Thunder is an in-game performance profiler for Casualties Unknown, built on BepInEx + Harmony. It samples frame time, GC activity, world state, engine-component CPU cost, multiplayer network metrics, and the per-Update cost of every loaded BepInEx plugin. Read it live through the graphical HUD overlay (press F1), the in-game console command thunder, or run thunder upload to capture a window and POST a JSON snapshot to a Thunder web viewer for sharing with mod authors and bug reporters.

Installation instructions

1. Install BepInEx 5.x for the game (drop it next to CasualtiesUnknown.exe and run the game once so it generates the BepInEx folder).

2. Download the latest Thunder release.

3. Extract Thunder.dll into:

<GameDir>\BepInEx\plugins\Thunder.dll

4. Launch the game. You should see " ready. Try thunder or thunder help." in the game console.

5. Press F1 for the HUD, or open the console and type thunder help to verify it's registered.

Optional config (auto-generated on first launch at BepInEx\config\com.kanisuko.thunder.cfg):

• []Upload. Endpoint — where snapshots are POSTed (default points at the public Thunder viewer).[/]

  []Upload. Token — optional X-Thunder-Token header for private endpoints.[/]

  []Upload. AutoCopyUrl / Upload. AutoOpenBrowser — UX after upload.[/]

  []Profiler. ProfileOtherMods — patch every other plugin's Update/LateUpdate/FixedUpdate to attribute frame cost per mod GUID. Tiny per-call overhead; turn off if you suspect interference.[/]

  []Profiler. EnableComponentCpu / ComponentCpuPlayerLoopFallback — engine-stage CPU timing via Unity Recorder, with a PlayerLoop fallback.[/]

  []Profiler. DownsampleSections — time game/system sections once every 0. 5s to reduce profiler self-overhead (counts stay per-frame).[/]

  []HUD. — overlay scale, corner anchor, tooltips, GL chart, smoothing, refresh interval, and per-panel toggles.[/]

  []Keybinds. ToggleHud / ToggleSettings — rebindable F1 / F2 hotkeys.[/]

  []Net. EnableNetBridge — reflection-based multiplayer metrics; auto-disables silently in single-player.[/]

Main features

[]Graphical HUD overlay — on-screen panels with a live GL frame-time chart (30/60fps reference lines), 4-corner anchoring, scaling, hover tooltips, and an in-game settings panel (F2). Plain-text HUD fallback included.[/]

[]Live frame stats — avg / best / worst FPS, frame time, and 1% low computed over a configurable last-N-seconds window, backed by a rolling 300-frame history.[/]

[]Engine-component CPU timing — per-stage cost for Scripts / Physics2D / Rendering / Animation / UI / Audio / GC via Unity Recorder, with a PlayerLoop-injection fallback when Recorder reads zero.[/]

[]GPU & memory view — GPU/main-thread frame time, process CPU%, managed heap, per-frame g0/g1/g2 deltas, cumulative GC counts, Mono heap, Unity allocator, system RAM/VRAM.[/]

[]Multiplayer network metrics — ping, connection quality, up/down bandwidth, packets, and peer ping when the multiplayer mod is present (soft dependency; single-player safe).[/]

[]System timings (55+ Sections) — deep-dive profiling across 55+ subsystems: 35+ PlayerCamera Handle methods, 9 WorldGeneration sub-methods, Moodles (Update vs events), Fluid simulation, Body updates, and visible Chunk entity ticks.[/]

[]Per-mod profiler — automatically times Update / LateUpdate / FixedUpdate of every loaded BepInEx plugin and lists the top offenders by avg ms, with friendly plugin names.[/]

[]World snapshot — live entity count, accurate visible chunks, real-time spider count (decrements on kill), current biome layer, and player position.[/]

[]One-shot upload — thunder upload clears history, captures a clean window (≤ 600 s), builds a self-contained JSON snapshot (meta + frame history + sections + mods), POSTs it, and optionally copies the result URL and opens it in your browser.[/]

[*]Console UX — color-coded output (green/yellow/red thresholds), ASCII bars, autofill for sub-commands, and a thu