Java Edition Indev level format

This article contains content about features that are outdated or have been removed from the game.
These features may only exist in older versions of Minecraft, or were possibly never even implemented.

Template:Exclusive The .mclevel map format is an old map format, created by Notch. It is based on the NBT Format.

The map format is in use since indev version 0.31.

While Alpha (and Infdev) levels use NBT files, they have a very different file format.

For details on the infinite map format, see Java Edition Alpha level format.

NBT Structure

  • Template:Nbt: The root tag.
    • Template:Nbt: Information about the level.
    • Template:Nbt: Information about the environment of the level, which varies based on the map generation settings.
      • Template:Nbt: The time in ticks affecting daylight cycle. Range 0 - 24000.
      • Template:Nbt: The sky light level, 0 to 15.
      • Template:Nbt: The RGB color of the sky, 24 bits. Red is SkyColor >> 16 & 255, green is SkyColor >> 8 & 255, blue is SkyColor & 255.
      • Template:Nbt: The RGB color of the fog, 24 bits. Red is FogColor >> 16 & 255, green is FogColor >> 8 & 255, blue is FogColor & 255.
      • Template:Nbt: The RGB color of the clouds, 24 bits. Red is CloudColor >> 16 & 255, green is CloudColor >> 8 & 255, blue is CloudColor & 255.
      • Template:Nbt: The height of the clouds (Y coordinate).
      • Template:Nbt: The Block ID of the "surrounding ground".
      • Template:Nbt: The height of the "surrounding ground".
      • Template:Nbt: The Block ID of the "surrounding water".
      • Template:Nbt: The height of the "surrounding water".
    • Template:Nbt: The actual map data.
    • Template:Nbt: List of TAG_Compounds for the entities in the level.
      • Template:Nbt An entity. The player has its own entity, shown below as an example.
        • Template:Nbt: The entity ID. In this case, "LocalPlayer".
        • Template:Nbt: List of 3 TAG_Floats for the X, Y, and Z position of the player.
        • Template:Nbt: List of 2 TAG_Floats for the Yaw and Pitch of the player's view.
        • Template:Nbt: List of 3 TAG_Floats for the X, Y, and Z motion in meters per tick.
        • Template:Nbt: How far the player has fallen.
        • Template:Nbt: The number of hit points the player has. 20 is 10 hearts.
        • Template:Nbt: Number of ticks the player is immune to attacks.
        • Template:Nbt: Number of ticks the player is red from being attacked.
        • Template:Nbt: Number of ticks the player has been dead for - used for controlling the death animation.
        • Template:Nbt: The number of ticks before the player starts to drown. Starts at 300.
        • Template:Nbt: When negative, the number of ticks before the player can catch on fire. When positive, the number of ticks before the fire is extinguished.
        • Template:Nbt: The player's score.
        • Template:Nbt: List of TAG_Compounds representing items in the player's inventory.
    • Template:Nbt: List of TAG_Compounds for the tile entities in the level.

Calculating "Pos" tag of the tile entity:

pos = x + (y << 10) + (z << 20)

Calculating X, Y, and Z from "Pos" tag:

x = pos % 1024

y = (pos >> 10) % 1024

z = (pos >> 20) % 1024

Blocks

The block byte array is used to define the types of blocks that occupy a map. The number of bytes in the array may be calculated by multiplying the dimensions of the map. Y being the up direction rather than Z. For Hex values see Block IDs.

To access a specific block from either the block or data array from XYZ coordinates, use the following formula:

array index = (y * height + z) * width + x;

Data

The Data byte array is used for lighting and extra block data.

For extended information on block metadata, refer to Java Edition data values.

Lighting

File:Lighting values.png

There are 16 levels of lighting for a block ranging from 0x0 (0, no light) to 0xF (15, full light).

Template:Java Edition

de:Spielstand-Speicherung/Indev Level Format fr:Format de carte mclevel (NBT) nl:Indev level formaat ru:Формат файлов Minecraft (NBT) zh:Indev世界格式