
Modrinth · Minecraft mod
ConfigGuard
Automatic snapshots of your config folder with a line-by-line diff and one-click restore. Undo any config change, on the client or on a server.
Quick answer
Which ConfigGuard release should I use?
ConfigGuard 1.2.0+forge.mc1.20.6 targets 1.20.6 with Forge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is ConfigGuard required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does ConfigGuard 1.2.0+forge.mc1.20.6 need?
1.2.0+forge.mc1.20.6. Change the file and its required mods may change too.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add ConfigGuard without breaking your instance.
Built for ConfigGuard 1.2.0+forge.mc1.20.6. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.2.0+forge.mc1.20.6. It targets 1.20.6 with Forge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.2.0+forge.mc1.20.6. It opens that exact file at the source.
About this project
What does ConfigGuard add?
ConfigGuard
Broke your configs? Roll them back in two clicks.
ConfigGuard keeps automatic snapshots of your config files and shows exactly what changed between them. Any file, or the whole folder, can be restored from a snapshot. It is made for players who tweak modpacks, pack makers who test updates and server owners who edit configs by hand.
Finding a config change
Run /configguard history 1 config/example.toml to see when one file was added, edited or removed. Select [diff] beside a change to inspect the two saved versions. Use /configguard find 1 Before tweaking to search labels, snapshot IDs and reasons.
Features
- Automatic snapshots when the game starts (on Fabric, before other mods load and rewrite their files) and when it closes. You can also take a snapshot by hand and give it a label.
- Change detection: if config files changed while the game was closed (a modpack update, manual editing, another launcher), a notification tells you how many files changed.
- Visual diff: a snapshot list → the files that changed since then (new, changed, deleted) → a line-by-line diff with removed lines in red and added lines in green.
- Restore one file or everything. Before restoring, ConfigGuard saves the current state as another snapshot, so every restore can be undone.
- Pinned snapshots are never removed automatically. Old unpinned snapshots are cleaned up once the limit is reached.
- Compact storage: files are stored by their SHA-256 hash in the
configguard/folder, so a file that did not change is never stored twice.
Opening the screen
- Fabric: Mod Menu → ConfigGuard → config button (Mod Menu is optional).
- NeoForge: Mods → ConfigGuard → Config.
- Any loader: set a key for Open ConfigGuard snapshots in Controls → Key Binds (unbound by default).
Server commands
For operators (permission level 4), on dedicated servers and in single player with cheats enabled:
| Command | What it does |
|---|---|
/configguard snapshot [label] |
Take a snapshot now |
/configguard list |
List snapshots, newest first (click an id to see its changes) |
/configguard changes <id> |
Files that changed since the snapshot |
/configguard diff <id> <path> |
Line diff of one file in chat |
/configguard restore <id> [path] |
Restore one file or all changed files |
/configguard pin <id> / unpin <id> |
Keep a snapshot forever, or release it |
Snapshot ids and file paths are suggested with Tab. Restart the game or server after a restore so mods read the restored files.
Settings
config/configguard.json (created on first launch):
| Key | Default | What it does |
|---|---|---|
trackedPaths |
config, defaultconfigs, options.txt, server.properties |
Files and folders in the game folder that are captured |
excludedGlobs |
**.log, **.tmp, **.bak, **.lock, **.old |
Files that are skipped |
maxFileSizeKb |
1024 |
Larger files are skipped |
maxSnapshots |
40 |
How many unpinned snapshots are kept |
snapshotOnStartup |
true |
Snapshot when the game starts |
snapshotOnShutdown |
true |
Snapshot when the game closes |
notifyExternalChanges |
true |
Notify about changes made while the game was closed |
Compatibility
- Works on the client, on a dedicated server, or on both. It does not need to be installed on the other side.
- Fabric and Quilt: require Fabric API; Mod Menu is optional. Forge and NeoForge: no extra dependencies.
- Works with any mod that keeps its settings in the config folder: TOML, JSON, JSON5, properties and other text formats get a line diff; binary files are listed with their size.
New in 1.1
Use /configguard list <page> to browse older snapshots, ten per page.
Compare two saved snapshots with /configguard compare <from> <to>. Select a changed path for its historical line diff, including additions and removals. This reads both states from the archive.
License
MIT. You are welcome to include ConfigGuard in modpacks.
Export a saved snapshot with /configguard export <id>. The server writes a portable ZIP under configguard/exports and verifies each archived file against its stored SHA-256 before replacing an earlier export.
Project description from Modrinth.
Pick your setup
ConfigGuard by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.2
4 loader builds26.1.2
4 loader builds26.1.1
4 loader builds26.1
4 loader builds1.21.11
4 loader builds1.21.10
4 loader builds1.21.9
4 loader builds1.21.8
4 loader builds1.21.7
4 loader builds1.21.6
4 loader builds1.21.5
4 loader buildsShowing the newest 12 of 18 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
ConfigGuard versions and loaders
1.2.0+forge.mc1.20.6
configguard-forge-1.20.6-1.2.0.jar
22 Nov 2026
1.2.0+neoforge.mc1.20.6
configguard-neoforge-1.20.6-1.2.0.jar
22 Nov 2026
1.2.0+fabric.mc1.20.6
configguard-fabric-1.20.6-1.2.0.jar
22 Nov 2026
1.2.0+forge.mc1.21
configguard-forge-1.21-1.2.0.jar
20 Nov 2026
1.2.0+neoforge.mc1.21
configguard-neoforge-1.21-1.2.0.jar
20 Nov 2026
1.2.0+fabric.mc1.21
configguard-fabric-1.21-1.2.0.jar
20 Nov 2026
1.2.0+forge.mc1.21.1
configguard-forge-1.21.1-1.2.0.jar
20 Nov 2026
1.2.0+neoforge.mc1.21.1
configguard-neoforge-1.21.1-1.2.0.jar
20 Nov 2026
1.2.0+fabric.mc1.21.1
configguard-fabric-1.21.1-1.2.0.jar
20 Nov 2026
1.2.0+neoforge.mc1.21.2
configguard-neoforge-1.21.2-1.2.0.jar
20 Nov 2026
1.2.0+fabric.mc1.21.2
configguard-fabric-1.21.2-1.2.0.jar
20 Nov 2026
1.2.0+forge.mc1.21.3
configguard-forge-1.21.3-1.2.0.jar
20 Nov 2026
Looking for an older file? The official Modrinth project page is in Resources.