SaveRestorer \u2013 Deep Save Cleaner
\nMod ID: saverestorer
\nFor: Minecraft 1.21.1 NeoForge
\nLicense: MIT<\/p>\n
\ud83d\udcd6 Overview
\nSaveRestorer is a manual, deep\u2011cleaning 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 \u2013 no need to start a server or load the world. The entire process happens in a single configuration screen with real\u2011time progress feedback.<\/p>\n
\u2728 Features
\nComprehensive cleanup \u2013 invalid blocks, entities, items, player inventories, ender chests, equipment, potion effects, advancements, dimension references, forced chunks, and more.<\/p>\n
Safe & atomic \u2013 optional automatic ZIP backup before every repair; all file writes are done through temporary copies to avoid corruption.<\/p>\n
Purely offline \u2013 operates on raw NBT\/JSON\/region files, never loads the world or server.<\/p>\n
Configurable filters \u2013 whitelist or blacklist specific mod IDs or full namespaces via config file.<\/p>\n
Smart block replacement \u2013 replace removed blocks with stone or air, preventing chunk errors.<\/p>\n
Non\u2011intrusive UI \u2013 a single screen with two status lines showing phase, file name, and overall progress. No pop\u2011ups, no screen switches.<\/p>\n
Fully manual \u2013 triggered only by the player from the Options menu; no background tasks, no automated scans.<\/p>\n
\ud83d\udee0\ufe0f How to Use
\nFrom the main menu, go to Options and click “Save Repair\u2026” on the right.<\/p>\n
Select the save you want to fix (all valid worlds are listed automatically).<\/p>\n
Toggle Enable Backup (recommended) and choose the replacement block (air or stone).<\/p>\n
Press Start Repair.<\/p>\n
Watch the two status lines at the bottom: first line shows the current phase (e.g. \u201cBacking up\u2026\u201d, \u201cProcessing region: r.0.0.mca\u201d), second line shows details (file name).<\/p>\n
When finished, the first line will display \u201cRepair complete!\u201d or \u201cRepair failed\u201d.<\/p>\n
Exit the screen and restart the game before loading the world to ensure all caches are refreshed.<\/p>\n
\u2699\ufe0f Configuration
\nConfig file: config\/saverestorer\/config.toml<\/p>\n
Key\tType\tDefault\tDescription
\nenable_backup\tboolean\ttrue\tCreate a ZIP backup of the world before cleaning
\nreplacement_block\tstring\t“minecraft:stone”\tBlock ID used to replace invalid blocks
\nfilter_mode\tstring\t“none”\t“none”, “whitelist”, or “blacklist”
\nfilter_list\tlist\t[]\tMod IDs or full namespaces (e.g. “oldmod”)
\nChanges to the config require a game restart.<\/p>\n
\ud83d\udccc Important Notes
\nAlways make a manual backup of your world in addition to the automatic one.<\/p>\n
Do not close the game during the repair process.<\/p>\n
Large worlds may take several minutes to process; progress is updated in real time.<\/p>\n
Setting the replacement block to air might leave a few floating blocks \u2013 this is normal and structurally harmless.<\/p>\n
A detailed log is written to config\/saverestorer\/debug.log. You can open it with any text editor to inspect what was removed.<\/p>\n","protected":false},"excerpt":{"rendered":"
SaveRestorer is a manual, deep\u2011cleaning tool for corrupted Minecraft worlds.<\/p>\n","protected":false},"featured_media":135819,"template":"","meta":{"_minecraft_slug":"saverestorer","_minecraft_project_id":"vubhXATe","_minecraft_author":"li27744","_minecraft_license":"MIT","_minecraft_downloads":21,"_minecraft_follows":1,"_minecraft_client_side":"optional","_minecraft_server_side":"optional","_minecraft_storage_type":"zip","_minecraft_archive_name":"saverestorer.zip","_minecraft_size_bytes":1790989,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T19:51:01.566348Z","_minecraft_date_created":"2026-05-15T03:51:54.426227Z","_minecraft_date_modified":"2026-05-10T08:29:46.850418Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/saverestorer","_minecraft_icon_attachment_id":135819,"_minecraft_imported_at":"2026-06-08T00:31:51+00:00","_minecraft_import_hash":"859cc197376f2bd388d4c3aeeec795f9","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[158,90,92],"mod_loader":[160],"minecraft_version":[37],"class_list":["post-135818","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-neoforge","mod_category-optimization","mod_category-utility","mod_loader-neoforge","minecraft_version-1-21-1"],"yoast_head":"\n