Page title: ConfigGuard: Snapshot and Restore Minecraft Configs

Meta description: ConfigGuard keeps automatic snapshots of your config files and shows exactly what changed, so you can roll back any file for Minecraft in two clicks.

ConfigGuard

Every modpack veteran knows the sinking feeling: the game launches, something breaks, and the culprit is a config file you edited three days ago and can no longer remember. ConfigGuard is a Minecraft mod that quietly takes snapshots of your configuration files so you can roll them back in two clicks. No more digging through backups, no more guessing which line you changed.

What ConfigGuard Does

ConfigGuard watches the files that matter: the config folder, defaultconfigs, options.txt, and server.properties. On Fabric, it snapshots before other mods load and rewrite their files, and it takes another snapshot when the game closes. If configs changed while the game was closed, a notification tells you how many files were touched. From there, a visual diff walks you through a snapshot list, the files that changed since then, and a line-by-line comparison with removed lines in red and added lines in green.

Restoring With a Safety Net

Before any restore, ConfigGuard saves the current state as another snapshot, so every rollback can itself be undone. You can restore a single file or everything at once. Pinned snapshots are never removed automatically, while old unpinned ones are cleaned up once the limit is reached. Files are stored by their SHA-256 hash in the configguard folder, so an unchanged file is never stored twice. Just remember to restart the game or server after a restore so mods read the restored files.

Supported Versions and Loaders

ConfigGuard runs on modern Minecraft releases through both Fabric and NeoForge. On Fabric it requires Fabric API, with Mod Menu as an optional extra. NeoForge needs no dependencies at all. It works client-side, on a dedicated server, or on both, and it does not need to be installed on the other side. If you manage a server and want to skip manual file juggling entirely, the foxygame.net launcher can handle the whole setup for ConfigGuard with a single click, keeping the mod current alongside your other add-ons.

Opening the Interface

  • Fabric: Mod Menu, then ConfigGuard, then the config button.
  • NeoForge: Mods, then ConfigGuard, then Config.
  • Any loader: bind a key under Controls, then Key Binds, for Open ConfigGuard snapshots.

Server Commands for Operators

Operators with permission level 4 get a full command set on dedicated servers and in single player with cheats enabled. Use /configguard snapshot [label] to capture the current state, /configguard list to see snapshots newest first, and /configguard changes or /configguard diff to inspect what moved. The restore, pin, and unpin subcommands round things out, and snapshot ids plus file paths are suggested with Tab.

Settings Worth Knowing

The configguard.json file appears on first launch. Defaults track the config folder, defaultconfigs, options.txt, and server.properties, skip logs, temp files, backups, and lock files, and cap files at 1024 KB. Up to 40 unpinned snapshots are kept, and startup, shutdown, and external-change notifications are all enabled out of the box. Text formats like TOML, JSON, JSON5, and properties get a proper line diff, while binary files are simply listed with their size.

Who Should Download ConfigGuard

If you tweak modpacks, test updates as a pack maker, or hand-edit configs on a server, this mod belongs in your setup. The best way to get started is to download ConfigGuard from your preferred mod source and drop it into the mods folder. Learning how to install is straightforward: match the file to your loader, launch once to generate the settings file, and let the snapshots accumulate. ConfigGuard for Minecraft is MIT licensed and welcome in modpacks, so sharing it with your community costs nothing. Small tool, huge peace of mind.

===ARTICLE===