SaveRestorer

SaveRestorer – Deep Save Cleaner
Mod ID: saverestorer
For: Minecraft 1.21.1 NeoForge
License: MIT

📖 Overview
SaveRestorer is a manual, deep‑cleaning tool for corrupted Minecraft worlds. After removing large mods, your save often contains thousands of invalid blocks, entities, items, advancement references, and dimension data that prevent the world from loading. This mod scans and strips all those residues directly from the save files – no need to start a server or load the world. The entire process happens in a single configuration screen with real‑time progress feedback.

✨ Features
Comprehensive cleanup – invalid blocks, entities, items, player inventories, ender chests, equipment, potion effects, advancements, dimension references, forced chunks, and more.

Safe & atomic – optional automatic ZIP backup before every repair; all file writes are done through temporary copies to avoid corruption.

Purely offline – operates on raw NBT/JSON/region files, never loads the world or server.

Configurable filters – whitelist or blacklist specific mod IDs or full namespaces via config file.

Smart block replacement – replace removed blocks with stone or air, preventing chunk errors.

Non‑intrusive UI – a single screen with two status lines showing phase, file name, and overall progress. No pop‑ups, no screen switches.

Fully manual – triggered only by the player; no background tasks, no automated scans.

🛠️ How to Use
From the main menu, go to Mods, find SaveRestorer in the list, and click the Configure button (gear icon) to open the repair screen.

Select the save you want to fix (all valid worlds are listed automatically).

Toggle Enable Backup (recommended) and choose the replacement block (air or stone).

Press Start Repair.

Watch the two status lines at the bottom: first line shows the current phase (e.g. “Backing up…”, “Processing region: r.0.0.mca”), second line shows details (file name).

When finished, the first line will display “Repair complete!” or “Repair failed”.

Exit the screen and restart the game before loading the world to ensure all caches are refreshed.

⚙️ Configuration
Config file: config/saverestorer/config.toml

Key Type Default Description
enable_backup boolean true Create a ZIP backup of the world before cleaning
replacement_block string “minecraft:stone” Block ID used to replace invalid blocks
filter_mode string “none” “none”, “whitelist”, or “blacklist”
filter_list list [] Mod IDs or full namespaces (e.g. “oldmod”)
Changes to the config require a game restart.

📌 Important Notes
Always make a manual backup of your world in addition to the automatic one.

Do not close the game during the repair process.

Large worlds may take several minutes to process; progress is updated in real time.

Setting the replacement block to air might leave a few floating blocks – this is normal and structurally harmless.

A detailed log is written to config/saverestorer/debug.log. You can open it with any text editor to inspect what was removed.