Minecraft:Bedrock Edition level format - Revision history

SyncBot: Sync: updated from Minecraft

2026-10-16T11:04:37Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 16 October 2026
Line 9:		Line 9:
	* {{cd\|level.dat}} - world settings in little-endian NBT, preceded by an eight-byte header.		* {{cd\|level.dat}} - world settings in little-endian NBT, preceded by an eight-byte header.
	* {{cd\|level.dat_old}} - a previous copy of the world settings, when present.		* {{cd\|level.dat_old}} - a previous copy of the world settings, when present.
			* <code>level.dat_new</code> - a temporary copy of the world settings used while saving the level.dat file, will only be present while saving or if the game crashed while saving the level.dat. The game writes the data to level.dat_new, deletes level.dat_old. renames level.dat to level.dat_old, and renames level.dat_new to level.dat.
	* {{cd\|levelname.txt}} - the world name.		* {{cd\|levelname.txt}} - the world name.
	* {{cd\|world_icon.jpeg}} - the world thumbnail, when present.		* {{cd\|world_icon.jpeg}} - the world thumbnail, when present.

SyncBot: Sync: updated from Minecraft

2026-10-06T11:03:10Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 6 October 2026
Line 226:		Line 226:

	* An example implementation of a Bedrock level-db parser can be found in [https://github.com/mmccoo/minecraft_mmccoo/blob/master/parse_bedrock.cpp minecraft_mmccoo]. This implementation walks the NBTs of all block, entities/mobs, elevations, and village related items.		* An example implementation of a Bedrock level-db parser can be found in [https://github.com/mmccoo/minecraft_mmccoo/blob/master/parse_bedrock.cpp minecraft_mmccoo]. This implementation walks the NBTs of all block, entities/mobs, elevations, and village related items.
	* A TypeScript implementation can be found on the [https://www.npmjs.com/package/mcbe-leveldb mcbe-leveldb] NPM package.		* A more up-to-date TypeScript implementation can be found on the [https://www.npmjs.com/package/mcbe-leveldb mcbe-leveldb] NPM package.

	=== NBT structures ===		=== NBT structures ===

SyncBot: Sync: updated from Minecraft

2026-10-04T11:04:51Z

Sync: updated from Minecraft

Show changes

SyncBot: Sync: updated from Minecraft

2026-09-28T11:05:46Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:05, 28 September 2026
Line 52:		Line 52:
	\|Heightmap (256×2 bytes)		\|Heightmap (256×2 bytes)
	2D biomes (256×1 bytes or 256×2 bytes)		2D biomes (256×1 bytes or 256×2 bytes)
	\|Biome IDs are written as 8-bit integers (or 16-bit little-endian integers in v1.18.0+). No longer written since v1.18.0, except for worlds using the [[Minecraft:Old]] world type or an older base game version (the <code>baseGameVersion</code> level.dat property).		\|Biome IDs are written as 8-bit integers (or 16-bit little-endian integers in v1.21.40.23+). No longer written since v1.18.0, except for worlds using the [[Minecraft:Old]] world type or an older base game version (the <code>baseGameVersion</code> level.dat property).
	\|-		\|-
	\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy		\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy

SyncBot: Sync: updated from Minecraft

2026-09-26T11:06:37Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:06, 26 September 2026
Line 316:		Line 316:
	** {{nbt\|byte\|naturalregeneration}}: The <code>naturalregeneration</code> [[Minecraft:game rule]].		** {{nbt\|byte\|naturalregeneration}}: The <code>naturalregeneration</code> [[Minecraft:game rule]].
	** {{nbt\|int\|NetherScale}}: Defaults to 8. This is used to tell the game how many Overworld blocks go into one nether block (X blocks in the nether = 1 block in the overworld).		** {{nbt\|int\|NetherScale}}: Defaults to 8. This is used to tell the game how many Overworld blocks go into one nether block (X blocks in the nether = 1 block in the overworld).
	** {{nbt\|int\|NetworkVersion}}: The protocol version of the version the world was last played on.		** {{nbt\|int\|NetworkVersion}}: The [[Minecraft:protocol version]] of the version the world was last played on.
	** {{nbt\|int\|permissionsLevel}}: What permissions a player defaults to, when joining a world.		** {{nbt\|int\|permissionsLevel}}: What permissions a player defaults to, when joining a world.
	** {{nbt\|int\|Platform}}: Seems to store the platform that the level is created on. Currently observed value is 2.		** {{nbt\|int\|Platform}}: Seems to store the platform that the level is created on. Currently observed value is 2.

SyncBot: Sync: updated from Minecraft

2026-09-25T11:08:33Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:08, 25 September 2026
Line 21:		Line 21:
	A database key for data regarding a chunk is the concatenation of:		A database key for data regarding a chunk is the concatenation of:
	* Two signed 32-bit little-endian integers (x and z in chunk coordinates, respectively),		* Two signed 32-bit little-endian integers (x and z in chunk coordinates, respectively),
	* An optional third 32-bit little-endian integer (1 for the [[Minecraft:Nether]], 2 for the [[Minecraft:End]], omitted for the [[Minecraft:Overworld]]),		* An optional third 32-bit little-endian integer (1 for the [[Minecraft:Nether]], 2 for the [[Minecraft:End]], omitted for the [[Minecraft:Overworld]], except for "JigsawStructureBlueprint" records, where this third integer is always present),
	* A one-byte tag specifying the type of record represented by the key (see table), ~~and~~		* A one-byte tag specifying the type of record represented by the key (see table),
	* (for a "SubChunkPrefix" record) a one-byte subchunk index (from 0 to 15).		* (for a "SubChunkPrefix" record) a one-byte subchunk index (from 0 to 15), and
			* (for a "JigsawStructureBlueprint" record) an eight-byte structure ID.

	Accordingly, such a key may be 9, 10, 13 or 14 bytes long. Not all subchunks necessarily exist for a given chunk.		Accordingly, such a key may be 9, 10, 13, 14, or 21 bytes long. Not all subchunks necessarily exist for a given chunk.

	The "BlockEntity", "Entity~~" and "PendingTicks~~" records are represented by a sequence of concatenated root tags in a variant of [[Minecraft:NBT]] which stores the lengths and the multi-byte integer types in little-endian format, as opposed to the big-endian format used by {{el\|je}} or the original NBT specification.		The "BlockEntity" and "Entity" records are represented by a sequence of concatenated root tags in a variant of [[Minecraft:NBT]] which stores the lengths and the multi-byte integer types in little-endian format, as opposed to the big-endian format used by {{el\|je}} or the original NBT specification.

	The value 0 is used in the "Version" record in old style worlds; higher values are used in infinite worlds.		The value 0 is used in the "Version" record in old style worlds; higher values are used in infinite worlds.
Line 139:		Line 140:
	\|<code>w</code>		\|<code>w</code>
	\|AABBVolumes		\|AABBVolumes
			\|
			\|
			\|-
			\|120
			\|78
			\|<code>x</code>
			\|JigsawStructureBlueprint
	\|		\|
	\|		\|
Line 163:		Line 171:
	* actorprefix		* actorprefix
	* digp		* digp
			* legacy_console_player_
	* map_		* map_
	* portals		* portals

SyncBot: Sync: updated from Minecraft

2026-09-11T11:02:02Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:02, 11 September 2026
Line 1:		Line 1:
	{{about\|the format since [[Minecraft:Bedrock Edition 1.2.13]]\|the format in former game versions\|Bedrock Edition level format/History}}		{{about\|the format since [[Minecraft:Bedrock Edition 1.2.13]]\|the format in former game versions\|Bedrock Edition level format/History}}
	{{exclusive\|bedrock}}		{{exclusive\|bedrock}}
	{{~~cleanup\|need to check whether there's anything out of date~~}}		{{Update}}

	''Bedrock Edition'' uses a modified version of Google's LevelDB, which uses the Zlib compression format for [[Minecraft:world]] storage. The world storage files are located in a world file in <code>[[Minecraft:com.mojang]]</code>.		''Bedrock Edition'' uses a modified version of Google's LevelDB, which uses the Zlib compression format for [[Minecraft:world]] storage. The world storage files are located in a world file in <code>[[Minecraft:com.mojang]]</code>.

SyncBot: Sync: updated from Minecraft

2026-07-17T11:04:23Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:04, 17 July 2026
Line 50:		Line 50:
	\|45 \|\|2D \|\|<code>-</code>\|\|Data2D		\|45 \|\|2D \|\|<code>-</code>\|\|Data2D
	\|Heightmap (256×2 bytes)		\|Heightmap (256×2 bytes)
	2D biomes (256×1 bytes)		2D biomes (256×1 bytes or 256×2 bytes)
	\|Biome IDs are written as 8-bit integers. No longer written since v1.18.0, except for worlds using the [[Minecraft:Old]] world type or an older base game version (the <code>baseGameVersion</code> level.dat property).		\|Biome IDs are written as 8-bit integers (or 16-bit little-endian integers in v1.18.0+). No longer written since v1.18.0, except for worlds using the [[Minecraft:Old]] world type or an older base game version (the <code>baseGameVersion</code> level.dat property).
	\|-		\|-
	\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy		\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy

SyncBot: Sync: updated from Minecraft

2026-07-16T11:03:34Z

Sync: updated from Minecraft

← Older revision		Revision as of 11:03, 16 July 2026
Line 51:		Line 51:
	\|Heightmap (256×2 bytes)		\|Heightmap (256×2 bytes)
	2D biomes (256×1 bytes)		2D biomes (256×1 bytes)
	\|Biome IDs are written as 8-bit integers. No longer written since v1.18.0.		\|Biome IDs are written as 8-bit integers. No longer written since v1.18.0, except for worlds using the [[Minecraft:Old]] world type or an older base game version (the <code>baseGameVersion</code> level.dat property).
	\|-		\|-
	\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy		\|46\|\|2E\|\|<code>.</code>\|\|Data2DLegacy
Line 389:		Line 389:
	[[Minecraft:de:Weltdaten (Bedrock)]]		[[Minecraft:de:Weltdaten (Bedrock)]]
	[[Minecraft:es:Formato de nivel de Bedrock Edition]]		[[Minecraft:es:Formato de nivel de Bedrock Edition]]
	[[Minecraft:ja:~~Levelフォーマット~~/Bedrock Edition]]		[[Minecraft:ja:ワールドフォーマット/Bedrock Edition]]
	[[Minecraft:nl:Bedrockeditie level format]]		[[Minecraft:nl:Bedrockeditie level format]]
	[[Minecraft:pt:Formato de nível da Edição Bedrock]]		[[Minecraft:pt:Formato de nível da Edição Bedrock]]
	[[Minecraft:zh:基岩版存档格式]]		[[Minecraft:zh:基岩版存档格式]]

SyncBot: Sync: updated from Minecraft

2026-06-16T11:01:40Z

Sync: updated from Minecraft

Show changes

← Older revision		Revision as of 11:04, 16 October 2026
Line 9:		Line 9:
	* {{cd\|level.dat}} - world settings in little-endian NBT, preceded by an eight-byte header.		* {{cd\|level.dat}} - world settings in little-endian NBT, preceded by an eight-byte header.
	* {{cd\|level.dat_old}} - a previous copy of the world settings, when present.		* {{cd\|level.dat_old}} - a previous copy of the world settings, when present.
			* <code>level.dat_new</code> - a temporary copy of the world settings used while saving the level.dat file, will only be present while saving or if the game crashed while saving the level.dat. The game writes the data to level.dat_new, deletes level.dat_old. renames level.dat to level.dat_old, and renames level.dat_new to level.dat.
	* {{cd\|levelname.txt}} - the world name.		* {{cd\|levelname.txt}} - the world name.
	* {{cd\|world_icon.jpeg}} - the world thumbnail, when present.		* {{cd\|world_icon.jpeg}} - the world thumbnail, when present.

← Older revision		Revision as of 11:06, 26 September 2026
Line 316:		Line 316:
	** {{nbt\|byte\|naturalregeneration}}: The <code>naturalregeneration</code> [[Minecraft:game rule]].		** {{nbt\|byte\|naturalregeneration}}: The <code>naturalregeneration</code> [[Minecraft:game rule]].
	** {{nbt\|int\|NetherScale}}: Defaults to 8. This is used to tell the game how many Overworld blocks go into one nether block (X blocks in the nether = 1 block in the overworld).		** {{nbt\|int\|NetherScale}}: Defaults to 8. This is used to tell the game how many Overworld blocks go into one nether block (X blocks in the nether = 1 block in the overworld).
	** {{nbt\|int\|NetworkVersion}}: The protocol version of the version the world was last played on.		** {{nbt\|int\|NetworkVersion}}: The [[Minecraft:protocol version]] of the version the world was last played on.
	** {{nbt\|int\|permissionsLevel}}: What permissions a player defaults to, when joining a world.		** {{nbt\|int\|permissionsLevel}}: What permissions a player defaults to, when joining a world.
	** {{nbt\|int\|Platform}}: Seems to store the platform that the level is created on. Currently observed value is 2.		** {{nbt\|int\|Platform}}: Seems to store the platform that the level is created on. Currently observed value is 2.