Info
The .mclevel map format is an old map format, created by Notch. It is based on the NBT Format See the NBT file format. For using NBT in commands, see Tutorials/Command NBT Tags. The Named Binary Tag format is used by Minecraft for the various files in which it saves data. 
.
The map format is in use since indev Indev Starting version 0.31 (Dec. 23, 2009) Latest version Minecraft Indev (Feb. 23, 2010) Paid Yes This page contains content that is no longer in the game. These featuresSpecial attraction only exist in outdated versions of 
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 See Minecraft Alpha 1.2.6. For Minecraft 1.0, see Level Format. Minecraft Infdev introduced a new data storage challenge while under development: Terrain generated in infdev has the potential to be almost 235 .
NBT Structure
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.
An item stack.
Slot: The Slot the item is in.
id: The Item ID.
Damage: The item`s data value, or damage value for tools.
Count: The number of this item in the stack. Range -128 to 127. Values less than 2 are not displayed in-game.
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.
An item stack.
Slot: The Slot the item is in.
id: The Item ID.
Damage: The item`s data value, or damage value for tools.
Count: The number of this item in the stack. Range -128 to 127. Values less than 2 are not displayed in-game.
Calculating "Pos" tag of the tile entity:
pos = x + (y
Calculating X, Y, and Z from "Pos" tag:
x = pos% 1024
y = (pos >> 10)% 1024
z = (pos >> 20)% 1024
Videos
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 Data values See values from the latest PCPersonal Computer version of Minecraft. For values from Classic, see Data values/Classic. For values from Indev, see Data values/Indev. For values from the Pocket Edition, see Pocket Edition 
.
Lighting
There are 16 levels of lighting for a block ranging from 0x0 (0, no light) to 0xF (15, full light).
