Rudeman-PackCheck icon

PackCheck

When someone joins, compares their modpack with the host's (game build, plugins, versions, file hashes, configs) and writes a report for the host. Also warns at launch when configs look reset. Reports only, never kicks.

By Rudeman
Last updated 2 days ago
Total downloads 12
Total rating 0 
Categories Mods BepInEx Server-side AI Generated
Dependency string Rudeman-PackCheck-1.0.3
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

README

PackCheck

"Works on my machine" is the usual answer when a modded lobby misbehaves. PackCheck checks it: when someone joins, it compares their setup with the host's and writes down exactly what's different. It never kicks anyone and never changes the join; it only reports.

Join check

  • The joining player's PackCheck sends a summary of their setup. The host compares it with its own:
    • game build (Unity build GUID, hashes of the game executable and Assembly-CSharp, game version number), BepInEx and Unity versions;
    • every loaded plugin: GUID, version and a hash of its DLL ("same version, different build" is caught);
    • every DLL in plugins, patchers and core; the files of a few marked mod folders (all jacob.* mods by default);
    • the mod manager's package list (mods.yml): versions and enabled state;
    • asset bundles by size;
    • config values, key by key.
  • Results are sorted by importance (game, mods, configs). Per-player things (volumes, keybinds, UI settings) and host-synced settings are listed but not counted.
  • The host gets a HUD tip when something differs and a full report in BepInEx/PackCheck/join-latest.txt (plus a dated copy). Nothing is posted to chat unless UseChat is on.
  • A joiner without PackCheck shows as "no PackCheck reply"; the join goes ahead as normal.
  • NetSyncGuard repairs logged during the join are listed in the report.

Launch check

At the main menu, and again on the first lobby load, PackCheck compares your configs with a saved baseline and tells you if settings look reset to defaults, a config file looks regenerated, a key was renamed, or a mod update changed values. A baseline is created automatically the first time. Ctrl+Shift+F9 takes a new one.

Keys

Key Action
Shift+F9 Show the last join summary again (re-runs it if hashes were still being calculated)
Ctrl+Shift+F9 Take a new config baseline

Who needs it

  • Host: gets the reports.
  • Clients: need it for the host to see their details. What a client sends is its game build details, plugin list, file hashes, package list, config values (up to 512 KB) and the name of its mod-manager profile, nothing else. No file paths outside the profile are sent.
  • Without it on a client, the host only learns that they have no PackCheck. A client sees nothing unless ShowReportWhenClient is on.

Optional build check

Off by default. To get a pop-up at launch when the game files aren't the build you expect (for example after a Steam update), put the build's values in [Game] ExpectedBuildGuid and ExpectedAssemblySha256 (BepInEx/config/jacob.packcheck.cfg). For v81 they are 2ef0cde3b693468cbb8621cc6980bb67 and 5f7db5538b78dc408845a3002907619785ac9f9c6b6059d13dc9a602d9b65731. The ChobblePack modpack's config sets them.

If you keep a separate copy of the game that Steam doesn't update, put its folder in [Game] FrozenGamePath and turn on WarnIfSteamCopy to get a menu line when you launch the Steam copy by mistake. Both are off by default.

Config highlights

Key Default What it does
General.Enabled true Master switch
Join.CheckOnJoin true Compare on join (host), reply (client)
Join.ShowReportWhenClient false Show the host's summary when you join someone
Report.ShowTip / UseChat / ChatLines true / false / 5 How results are shown
Drift.CheckOnLaunch / PopupOnLikelyReset true Launch check and its pop-up
Ignore.* see file Configs, keys and plugins that are ignored or shown as information only
Game.ExpectedBuildGuid / ExpectedAssemblySha256 (empty) Build check, see above
Game.FrozenGamePath / WarnIfSteamCopy (empty) / false Separate game copy, see above
Hashing.OwnModFolders (empty) Extra plugin folders whose every file is compared (folders of plugins with a jacob. GUID are always included)
Hashing.OwnModSkipFiles backups, *DefinitelyNotCheats/settings.json Files in those folders that are never compared

Compatibility

  • Game v81, BepInEx 5; standalone.
  • Hashing runs on a background thread with a cache, so later launches are fast.
  • Files are written only inside BepInEx/PackCheck/.

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.