v0.12.6

Changes

• New: baseFiles — sync mods that replace base-game files. A syncPath can now list base-game files the mod overwrites (e.g. DLSS's nvngx_dlss.dll, DynamicMaps' Unity assemblies). ModSync backs the original up as .modsync-bak before replacing it and restores it when the mod is removed, so opting out puts the game back exactly as it was. This replaces the hardcoded DynamicMaps handling with a general mechanism any mod can use.
• New: headless per syncPath — set "headless": false and that path is never offered to a headless client. Useful for anything graphical (DLSS, map overlays), which a headless renders nothing for and simply wastes disk and bandwidth on.
• New: ModSync updates itself first, then restarts. When the client's version doesn't match the server's, the server serves only ModSync's own components until the client is current. This removes a class of failures where an out-of-date client tried to interpret a newer server's response.
• New: config_default.jsonc — the server writes the current shipped defaults alongside your config on every boot, so you can diff new options in without your own file ever being touched.
• New: notification for missing config options — if a release adds a top-level option your config lacks, the server logs it once at startup. It never rewrites your file.
• Rework: the F12 menu. Optional mods get a real checkbox that installs and uninstalls them. Enforced and built-in paths are now shown rather than hidden — as a one-line explanation with no control, so you can see what the server manages without being able to break it. The three catch-all paths are hidden entirely.
• The zip no longer ships config.jsonc. The server writes it on first boot if missing, so extracting over an existing install can no longer clobber your config.

Upgrade notes

Unzip into your game root as usual — clients update via sync, no manual steps.

Your existing config.jsonc is untouched: baseFiles and headless are optional and default to the previous behaviour. To use them, copy the examples from the regenerated config_default.jsonc.

Upgrading leaves one dead entry, (Builtin) Managed Files, in each client's BepInEx/config/corter.modsync.cfg. It is unbound and does nothing; delete the line if it bothers you.

Docs

• Mods that replace base-game files — how baseFiles backs up and restores originals, and why a hand-installed mod gets locked
• Usage Examples — worked config.jsonc setups, from minimal to a real server

Coming from before v0.12.4? See the v0.12.4 notes for the one-time BepInEx/patchers/Corter-ModSync/ folder cleanup on the server/headless.

Full Changelog: v0.12.5...v0.12.6