Versión de datos

A data version, also known as a world version, is a positive integer used in world save data to denote a specific version, and determines whether the player should be warned about opening that world due to client version incompatabilities.

Usage

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

Upon selecting and loading a singleplayer world, the game checks if the client has a data version newer or older than the selected world. If it does, the game then prompts the user whether they want to back up their world before playing it if the world is older, or warn them that their world may 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 any release.

Storage locations

Data versions can be found in many different places.

Player data

In-game, the data version can be obtained using the command /data get entity @s DataVersion.

options.txt

The first line of options.txt since 1.10-pre1 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.

History

Edición Java
1.9		15w32a			Added data versions, starting from version "100".

See also

• Protocol version