Project Zomboid: World Recovery
A save that will not load is usually one broken cell file, not a dead world. This finds the damaged files you can safely delete, and checks which of your backups is actually complete.
1. Point it at your save folder
Windows: %USERPROFILE%\Zomboid\Saves\<Mode>\<SaveName>.
Linux: ~/Zomboid/Saves/<Mode>/<SaveName>. On a dedicated server it is
the same layout under the account running it. Stop the server or close the game
first so nothing is mid-write.
Reads names, sizes & times locally. Nothing is uploaded.
Reads each zip's index only, never extracts it.
Want this on a real server? Supercraft hosts Project Zomboid →
How a PZ save is put together, and how it breaks
A Project Zomboid world is not a single save file. It is a folder of many small files, and that is the good news when something goes wrong:
- Coordinate files each hold one square of the world, and damage is
usually confined to one or two of them, typically where you were standing when the game or
server died. Build 42 splits them by store:
map/<x>/<y>.binis the actual ground at 8x8 tiles per file, whilechunkdata/,zpop/andapop/hold cell metadata, zombie population and animal population separately. Build 41 kept all of them in the save root asmap_x_y.bin,chunkdata_x_y.binandzpop_x_y.bin. This scanner reads both and tells you which layout it found, because losing a piece of terrain and losing a population file are not the same problem. - Shared files -
players.dbholds your characters,vehicles.dbthe cars, andmap_t.bin/map_meta.bin/map_sand.binthe global state and sandbox settings. Damage here affects the whole save, so this is the case where you restore a backup.
The classic failure signature is a zero-byte or stub-sized file: the game was killed mid-write, or the folder was copied while the server was running. That is exactly what this page looks for, because those files are both easy to spot and safe to remove.
Server logs pointing at a specific error instead? Use the log analyzer. Rebuilding sandbox settings is the settings generator. Want it hosted with backups taken for you? Run a Project Zomboid server with Supercraft.
Manual recovery (no JavaScript needed)
- Stop the server or close the game. Nothing below is safe while it is writing.
- Copy the whole save folder somewhere else first. Every step after this is reversible only if you did this one.
- Sort the folder by size and look for
.binfiles at 0 bytes or a few dozen bytes. Those are your damaged cells. - Delete only those files. Start the game; it regenerates those cells. Anything you built in that specific area is gone, everything else is not.
- If
players.dbor amap_*.binshared file is the empty one, do not bother with cells: restore the newest complete zip fromZomboid/backupsinstead, keeping your current folder aside. - Load in, verify your character and a couple of bases, and only then delete the copy you made in step 2.
FAQ
Will deleting a cell file wipe my character?
No. Characters live in players.db, which is a separate file. Removing a cell file
affects that square of the map only, so you keep your character, skills and everything you built
elsewhere.
My world loads but crashes when I walk to one area.
That is the textbook single-corrupt-cell symptom. The cell for that area is damaged in a way that does not show up as a zero byte count, so this page may report the folder as clean. Note roughly where it happens, and delete that cell file, or restore just that file from a backup.
There is nothing in my backups folder.
Automatic backups are a game option and can be turned off, and they are only written on certain events. If it is empty, this is the moment to turn them on for next time, and to check whether your host takes its own snapshots.
Is my save really not uploaded?
Really. There is no upload endpoint on this page. File inspection and zip index reading both happen locally in your browser.
My Project Zomboid world won't load - can I get it back?
Often, yes, and usually without losing the whole world. A PZ save is not one file: it is thousands of independent coordinate files plus a handful of shared ones like players.db and map_t.bin. Build 42 keeps them in per-store directories (map/<x>/<y>.bin for the ground, chunkdata/, zpop/, apop/); Build 41 kept them all in the save root as map_x_y.bin, chunkdata_x_y.bin and zpop_x_y.bin. If a single cell file was truncated by a crash or a mid-write copy, deleting that one file makes the game regenerate that area and leaves the rest of the map, your character and your other bases intact. If a shared file is the damaged one, restore the newest intact backup instead.
Where does Project Zomboid keep saves and backups?
On Windows the user folder is %USERPROFILE%\Zomboid. Saves live under Zomboid\Saves\<Mode>\<SaveName>, and the game's own automatic backups are zip files in Zomboid\backups. On Linux it is ~/Zomboid. A dedicated server keeps the same layout under the account that runs it. Stop the server or close the game before touching either folder.
Which backup should I restore?
The newest one that is actually complete. Backup zips all look alike in a file listing, so this page reads each archive's index (without extracting it) and marks the ones that really contain both cell files and players.db. It then names the newest complete archive, so you restore the save from just before it broke instead of guessing by filename.