Rudeman-PerfWatcher icon

PerfWatcher

Performance overlay (P): frame time per mod, hotspots, engine steps, network objects, with logging to file. Plus a Day Info panel (I) that explains today's moon, weather, interior and events without spoilers. Local only.

By Rudeman
Last updated 4 hours ago
Total downloads 2
Total rating 0 
Categories Mods BepInEx Performance AI Generated
Dependency string Rudeman-PerfWatcher-1.5.1
Dependants 0 other packages depend on this package

This mod requires the following mods to function

BepInEx-BepInExPack-5.4.2305 icon
BepInEx-BepInExPack

BepInEx pack for Mono Unity games. Preconfigured and ready to use.

Preferred version: 5.4.2305
Rune580-LethalCompany_InputUtils-0.7.14 icon
Rune580-LethalCompany_InputUtils

API/Library for creating Unity InputActions with in-game re-binding support. Provides an alternative UI that allows for supporting mods to have in-game re-bindable keybinds.

Preferred version: 0.7.14

README

PerfWatcher

Two panels in one mod. The first is for finding out why a big modpack stutters; the second is for the player who just wants to know what kind of day they've landed on.

Performance overlay (P)

Press P to open the overlay and start logging; press it again to close it and finish the log.

Pages (Shift+P to cycle):

  • Summary: FPS, frame time and stutters, with a 10-second frame-time graph.
  • Mods: CPU time per frame for each mod, measured by temporarily patching mods' per-frame code, Harmony patches, coroutines and RPCs. Everything is unpatched when the overlay closes.
  • Hotspots: the most expensive individual methods.
  • Scene: enemies, network objects, grabbables and scrap, awake rigidbodies, lights (and how many cast shadows), audio and particles playing, cameras, draw calls, batches, triangles.
  • Network: players, round-trip time to the host, RPCs.

Ctrl+P writes a one-off snapshot of every page to the session log. Logs go to BepInEx/PerfWatcher/perf-*.jsonl (the newest 20 are kept, 5 MB cap per session). With the overlay closed, nothing is patched or measured.

Timing.Scope = Full times about a thousand methods (mods' code plus the game's heavy methods) and takes a few seconds to patch in; Lite covers only per-frame code.

Day Info panel (I)

Shift+I switches between a short and a full view. It explains, in plain words:

  • the moon, route price, risk level, day and quota progress;
  • today's weather, what it does, how likely it was today on this moon and how often this moon usually gets it;
  • the interior, what it's like and how likely it was;
  • Brutal Company Minus events and what they do;
  • the crew (alive, dead and cause of death with Coroner) and the scrap already in the ship.

The odds need WeatherTweaks with WeatherRegistry (weather) and LethalLevelLoader (interior). Without them the panel still names today's weather (from WeatherRegistry or the vanilla game) and, once the floor has generated, the interior, just without percentages.

It never scouts for you: no scrap totals, enemy lists or what the weather will turn into. Descriptions come from DayInfo-weathers.txt, DayInfo-interiors.txt and DayInfo-events.txt beside the DLL; edit them freely.

When these mods are installed it adds their lines too: MoonHistory (record for this moon), SignalInterference (radio line), SizeScaling (interior size), LeMatrix (host status, off by default), TimeDilation (day length) and Mimic+ (host status). Each link turns itself off quietly if the mod isn't there.

Keys

Key Action
P Overlay and logging on/off
Shift+P Next overlay page
Ctrl+P Snapshot to the log
I Day Info panel on/off
Shift+I Short or full view

P and I can be rebound in the game's controls menu (InputUtils); the modifiers are set in the config. Keys are ignored while typing in chat or the terminal.

Who needs it

Nobody else. It's local to your PC, sends nothing and changes nothing in the game. Install it on any PC you want the panels on.

Config highlights

BepInEx/config/jacob.perfwatcher.cfg: key strings, overlay and panel corners and scale, refresh rate, FPS warning thresholds, stutter threshold, log size limits, PerModTiming, Scope, EnginePhases, extra methods to time, and one switch per Day Info section (ShowMoonHistory, ShowSignalInterference, ShowCrew...).

Compatibility

  • v81, BepInEx 5.
  • Requires LethalCompany_InputUtils (rebindable keys); installed automatically.
  • Works alongside LethalLevelLoader, WeatherRegistry/WeatherTweaks, Brutal Company Minus, Coroner, MoonRotation and the mods above; all optional.
  • Built for the ChobblePack modpack; usable in any v81 setup.

AI disclosure

The code, documentation and icon of this mod were generated with Anthropic's Claude (Claude Opus 5.5 and other Claude models, via Claude Code). The author designed the mod, directed the work and tested it in game.