데이터 버전

이 기능은 Java Edition 전용입니다.

A data version, also known as a world version,^[1]^[2] is a positive integer used in world save data to denote a specific version.

Usage

파일:Outdated singleplayer world.png

The game prompting the player whether they want to back up their outdated world.

Upon selecting and loading a singleplayer world, the game will check if the client has a data version newer or older than the selected world. If it does, the game will then prompt the user whether they want to back up their world before playing it if the world is older, or warn them that their world map become corrupted if the world is newer.

Versioning

Every version of Java Edition since 15w32a, including minor releases and snapshots, has its own data version. The version takes the form of an ever-increasing positive integer unlike client versions. Data versions are necessary because client versions usually cannot be directly compared since they use different formats (i.e., "1.14" and "19w02a" cannot be compared). Data versions may skip numbers between major releases.

Storage locations

Data versions can be found in many different places.

`options.txt`

The very first line of options.txt displays the data version, named version.

`level.dat`

The data version is stored in two places inside the level.dat file of a world save: in the root Data compound named DataVersion and also in the Version compound named Id.

level.dat
- Data: Information about the level.dat file.
  - DataVersion: An integer displaying the data version.
  - Version: Versioning information about when the world was last saved.
    - Id: An integer displaying the data version.

Region files

Each chunk in the region files (located in .minecraft\saves\<world name>\region named r.<region X>.<region Z>.mca) contains information about the data version when it was last loaded.

r.x.z.mca: Information about the region at exact region coordinates [x,y] (1 region = 32×32 chunks)
- Chunk [x₁,y₁] in world at (x₂,y₂): Information about the chunk at relative chunk coordinates [x₁,y₁], located at exact chunk coordinates [x₂,y₂] (1 chunk = 16×16 blocks)
  - DataVersion: An integer displaying the data version.

`.dat` and `.nbt` files

All .dat and .nbt files contain the data version in their root compound of when the file was last saved.

file name
- DataVersion: An integer displaying the data version.

`version.json`

Each Minecraft build since 18w47b also specifies its current data version in the version.json file, found in the root directory of the client and server jars.

version.json
- world_version: The data version of this build.