Back to mods
ConfigGuard project artwork

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.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which ConfigGuard release should I use?

Updated today
Latest stable file 1.2.0+forge.mc1.20.6
Game version 1.20.6
Loader Forge

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.

Client Optional
Dedicated server Optional
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.

No extra mods listed for this file

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.

  1. 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.

  2. 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.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 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.

71 available setups

Showing 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

55 of 55 releases match

Looking for an older file? The official Modrinth project page is in Resources.