Skip to content
Game save workbench
Local-first tools No installation Support status shown
DEVICE-LOCAL Favorites and recent pages stay in this browser.

Save File Formats

Minecraft: Java Edition Save File Format Reference

Minecraft: Java Edition save-file format reference covering the known PC file or folder pattern, documented format characteristics, compatibility boundaries, and what should not be inferred from an extension alone.

Editorial state
Reviewed
Reading time
3 min
Difficulty
Beginner
Last reviewed

Before you start

Work from a copied save rather than the live file. Use the documented path and filename/folder pattern to identify the correct record before inspecting bytes or text.

Key takeaways

What this guide establishes.

  • Use the documented save directory for the PC storefront/profile you actually play.
  • Back up the complete save boundary before restore, migration, repair, or editing.
  • Treat cloud synchronization as a separate copy that can overwrite a manual restore.
  • Do not infer editability from a filename extension; format and version compatibility must be verified.

Minecraft: Java Edition makes the strongest case in this batch for treating a save as a directory tree. A world contains metadata, chunk regions, player records, dimensions, data packs, and potentially mod-specific data. Copying only level.dat is not a world backup. Close the world or server cleanly, then archive the entire world directory. If you use Prism Launcher, MultiMC, or another instance manager, find the actual instance path first because the default `.minecraftsaves` directory may not be the one in use.

Known Minecraft: Java Edition save-file structure

The researched filename or folder pattern is <world-folder>level.dat
<world-folder>region*.mca
<world-folder>playerdata*.dat. File-extension context: .dat, .mca The documented format notes are: A Java Edition world is a directory tree. level.dat stores world metadata, region files use the Anvil .mca format, and player data is stored separately. The world folder, not one file, is the correct backup unit.

Why an extension is not enough

A save filename can identify a likely container, but it does not prove the internal schema, game version, checksum rules, encryption state, or editability. Java Edition saves are not directly compatible with Bedrock Edition. Version downgrades can also damage or remove world data. SaveEditor therefore separates file identification from Tool compatibility and only labels a game-specific Tool Verified when its exact profile/version evidence passes the runtime gate.

Where the format is stored

PC save locations: Windows: %APPDATA%.minecraftsaves | macOS: $HOME/Library/Application Support/minecraft/saves/ | Linux / Steam Play: $HOME/.minecraft/saves/. Storefront context: Minecraft Launcher, Prism Launcher, MultiMC and other instance managers. Alternative launchers can use separate instance directories. The default .minecraft path is not guaranteed to contain a world launched from a custom instance. This matters because two releases can use different containers or companion files even when the visible slot name is similar.

Back up before inspecting or editing

Close the world/server and copy the entire world directory. For modded instances, preserve the instance/modpack and configuration alongside the world. A read-only viewer is lower risk than a writer, but the live save should still be copied first. Cloud context also matters: Local Java Edition worlds do not become generic cloud saves simply because the player uses a Microsoft account. Realms worlds are service-hosted and can be downloaded separately through supported game workflows. Keep the original bytes available so any experiment can be reversed without relying on a cloud service or automatic backup.

What this reference does not claim

This page does not infer an undocumented checksum algorithm, encryption key, compression layer, or cross-store conversion from the file extension. Troubleshooting evidence: If a world is missing from the default saves folder, check the active launcher instance directory. If level.dat is damaged, preserve the whole world before considering level.dat_old or any repair step. Those questions require a verified parser/profile or a game-specific source, not a generic format guess.

Verification context: Default Windows/macOS/Linux paths, server world location, launcher-instance behavior, Realms distinction, and Java-versus-Bedrock incompatibility were reviewed against current PCGamingWiki coverage.

Troubleshooting

If the expected result does not match.

Game-specific note: If a world is missing from the default saves folder, check the active launcher instance directory. If level.dat is damaged, preserve the whole world before considering level.dat_old or any repair step.

Verification and sources

How this guide was checked.

Phase 27 generated this Guide from the reviewed Phase 23/24 Game Hub evidence for Minecraft: Java Edition. The file/folder naming and documented format boundary were cross-checked against the same public references recorded on the Game Hub. No unsupported game-specific editor, checksum, encryption, or cross-platform conversion capability is implied.

  1. www.pcgamingwiki.com