Indev level format
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 Alpha Level Format.
NBT Structure[edit | edit source]
MinecraftLevel: The root tag.
About: Information about the level.
CreatedOn: The Unix time when the level was created.
Name: The name of the level, always "A Nice World".
Author: The name of the user who created the level.
Environment: Information about the environment of the level, which varies based on the map generation settings.
TimeOfDay: The time in ticks affecting daylight cycle. Range 0 - 24000.
SkyBrightness: The sky light level, 0 to 15.
SkyColor: The RGB color of the sky, 24 bits. Red is SkyColor >> 16 & 255, green is SkyColor >> 8 & 255, blue is SkyColor & 255.
FogColor: The RGB color of the fog, 24 bits. Red is FogColor >> 16 & 255, green is FogColor >> 8 & 255, blue is FogColor & 255.
CloudColor: The RGB color of the clouds, 24 bits. Red is CloudColor >> 16 & 255, green is CloudColor >> 8 & 255, blue is CloudColor & 255.
CloudHeight: The height of the clouds (Y coordinate).
SurroundingGroundType: The Block ID of the "surrounding ground".
SurroundingGroundHeight: The height of the "surrounding ground".
SurroundingWaterType: The Block ID of the "surrounding water".
SurroundingWaterHeight: The height of the "surrounding water".
Map: The actual map data.
Width: The width of the level.
Length: The length of the level.
Height: The height of the level.
Spawn: List of 3 TAG_Shorts for the X, Y, and Z spawn coordinates.
Blocks: Width*Length*Height bytes of block IDs. (8 bits)
Data: Width*Length*Height bytes of block data (4 bit) and light value (next 4 bit).
Entities: List of TAG_Compounds for the entities in the level.
An entity. The player has its own entity, shown below as an example.
id: The entity ID. In this case, "LocalPlayer".
Pos: List of 3 TAG_Floats for the X, Y, and Z position of the player.
Rotation: List of 2 TAG_Floats for the Yaw and Pitch of the player's view.
Motion: List of 3 TAG_Floats for the X, Y, and Z motion in meters per tick.
FallDistance: How far the player has fallen.
Health: The number of hit points the player has. 20 is 10 hearts.
AttackTime: Number of ticks the player is immune to attacks.
HurtTime: Number of ticks the player is red from being attacked.
DeathTime: Number of ticks the player has been dead for - used for controlling the death animation.
Air: The number of ticks before the player starts to drown. Starts at 300.
Fire: When negative, the number of ticks before the player can catch on fire. When positive, the number of ticks before the fire is extinguished.
Score: The player's score.
Inventory: List of TAG_Compounds representing items in the player's inventory.
TileEntities: List of TAG_Compounds for the tile entities in the level.
A tile entity.
id: Tile entity id. In this case, "Chest".
Pos: Position of the tile entity, explained later.
Items: List of TAG_Compounds representing items in the chest.
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[edit | edit source]
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[edit | edit source]
The Data byte array is used for lighting and extra block data.
For extended information on block metadata, refer to Data values.
Lighting[edit | edit source]
There are 16 levels of lighting for a block ranging from 0x0 (0, no light) to 0xF (15, full light).