Map Format - Revision history

imported>Norbiros: Updated biomes info and link do new minecraft wiki

2024-05-30T11:34:30Z

Updated biomes info and link do new minecraft wiki

← Older revision		Revision as of 11:34, 30 May 2024
Line 17:		Line 17:
	===Biome Values===		===Biome Values===

	As of 1.18.1 there are 61 unique biomes (50 for the Overworld, 5 for the Nether, 5 for the End, and <code>minecraft:the_void</code>).		As of 1.20.6 there are 64 unique biomes (53 for the Overworld, 5 for the Nether, 5 for the End, and <code>minecraft:the_void</code>).
	{{Minecraft Wiki\|Biome#Biome_IDs\|Here}} you can find a mapping of biome to its respective numerical ID.		{{Minecraft Wiki\|Biome#Biome_IDs\|Here}} you can find a mapping of biome to its respective numerical ID.

Line 259:		Line 259:
	=== See also ===		=== See also ===
	[https://wiki.vg/Region_Files Region Files]		[https://wiki.vg/Region_Files Region Files]
	[https://minecraft.~~gamepedia.com~~/Chunk_format~~#Tile_entity_format Tile~~ entity format]		[https://minecraft.wiki/w/Chunk_format/BlockEntity Block entity format]
	[[Category:Minecraft_Modern]]		[[Category:Minecraft_Modern]]

imported>KurtThiemann: Added mention of xxhash32 seed value for lz4 compressed chunks

2024-01-25T20:15:17Z

Added mention of xxhash32 seed value for lz4 compressed chunks

← Older revision		Revision as of 20:15, 25 January 2024
Line 200:		Line 200:
	=====Checksum=====		=====Checksum=====

	Block checksums use the XXHash32 algorithm [https://github.com/lz4/lz4-java/blob/master/src/java/net/jpountz/xxhash/StreamingXXHash32.java as implemented in lz4-java].		Block checksums use the XXHash32 algorithm with the seed value <code>0x9747b28c</code> [https://github.com/lz4/lz4-java/blob/master/src/java/net/jpountz/xxhash/StreamingXXHash32.java as implemented in lz4-java].
	When finalizing the hash value, this implementation [https://github.com/lz4/lz4-java/blob/7c931bef32d179ec3d3286ee71638b23ebde3459/src/java/net/jpountz/xxhash/StreamingXXHash32.java#L106 removes the last nibble from the result], which is something that might need to be done manually when using other implementations.		When finalizing the hash value, this implementation [https://github.com/lz4/lz4-java/blob/7c931bef32d179ec3d3286ee71638b23ebde3459/src/java/net/jpountz/xxhash/StreamingXXHash32.java#L106 removes the last nibble from the result], which is something that might need to be done manually when using other implementations.

imported>KurtThiemann: Add explanation of LZ4 compression scheme added in 24W04A

2024-01-25T16:28:06Z

Add explanation of LZ4 compression scheme added in 24W04A

@@ Line 122: / Line 122: @@
 |}
 The compression scheme can have four values:
 {| class="wikitable"
@@ Line 141: / Line 142: @@
 |}
-The notchian implementation will '''never''' compress with gzip but can read if provided.
+The notchian implementation will '''never''' write uncompressed or gzip compressed chunks, but can read if provided.
 Note: The following example is outdated. It is accurate for (at least) 1.4, but at some point the format has been changed. However, you will still need to support this version if you want reverse compatibility with old save files.

imported>KurtThiemann: Add compression schemes 3 and 4 to compression scheme table

2024-01-25T13:47:14Z

Add compression schemes 3 and 4 to compression scheme table

← Older revision		Revision as of 13:47, 25 January 2024
Line 122:		Line 122:
	\|}		\|}

	The compression scheme can have ~~two value~~:		The compression scheme can have four values:
	{\| class="wikitable"		{\| class="wikitable"
	\|-		\|-
	!Compression<br />Scheme		!Compression<br />Scheme
	!Value		!Value
			\|-
			\|LZ4
			\|<code>4</code>
			\|-
			\|none
			\|<code>3</code>
	\|-		\|-
	\|zlib		\|zlib

imported>CrowdingFaun624: use {{Minecraft Wiki}}

2023-09-26T21:17:14Z

use {{Minecraft Wiki}}

← Older revision		Revision as of 21:17, 26 September 2023
Line 18:		Line 18:

	As of 1.18.1 there are 61 unique biomes (50 for the Overworld, 5 for the Nether, 5 for the End, and <code>minecraft:the_void</code>).		As of 1.18.1 there are 61 unique biomes (50 for the Overworld, 5 for the Nether, 5 for the End, and <code>minecraft:the_void</code>).
	~~[https://minecraft.fandom.com/wiki/~~Biome#Biome_IDs Here] you can find a mapping of biome to its respective numerical ID.		{{Minecraft Wiki\|Biome#Biome_IDs\|Here}} you can find a mapping of biome to its respective numerical ID.

	==Storage==		==Storage==

imported>Sarahparah: link to the minecraft wiki instead, which has an up-to-date mapping of biome ID's

2022-03-07T15:45:34Z

link to the minecraft wiki instead, which has an up-to-date mapping of biome ID's

@@ Line 17: / Line 17: @@
 ===Biome Values===
-{| class="wikitable"
+As of 1.18.1 there are 61 unique biomes (50 for the Overworld, 5 for the Nether, 5 for the End, and <code>minecraft:the_void</code>).
-|-
+[https://minecraft.fandom.com/wiki/Biome#Biome_IDs Here] you can find a mapping of biome to its respective numerical ID.
 ==Storage==

imported>Sarahparah: new height limit / world bottom in 1.18

2022-03-04T01:50:16Z

new height limit / world bottom in 1.18

← Older revision		Revision as of 01:50, 4 March 2022
Line 13:		Line 13:

	==General Information==		==General Information==
	Worlds are represented as a series of regions, within which are a number of columns, and chunks. Each region is 32x1x32 columns, each column is 1x16x1 chunks, and each chunk is 16x16x16 blocks. The overall block height of a column is ~~256~~. Each chunk stores four (or five) things - block IDs (8-bit), block metadata (4-bit), block light (4-bit), and sky light (4-bit). The optional fifth value is "add" data, which is four bits to be added to block IDs for additional block ID support (not used in vanilla Minecraft). Block light is light cast by things like torches and glowstone, and is calculated with a 3D [http://en.wikipedia.org/wiki/Flood_fill Flood Fill] algorithm. Sky light is the light cast by the sky, and is calculated by starting at the top and working your way down. As you pass through semi-transparent blocks, you decrease the lighting value until you hit an opaque block. The opaque block is the last block whose skylight has a nonzero value. Lighting starts at 0xF (brightest) and works down to 0x0 (dimmest). Columns store biome information. Each 1x256x1 cuboid of blocks has the same biome value, for a total of 256 possible biome values per chunk (16x16). Biome values are stored as bytes.		Worlds are represented as a series of regions, within which are a number of columns, and chunks. Each region is 32x1x32 columns, each column is 1x16x1 chunks, and each chunk is 16x16x16 blocks. The overall block height of a column is 384. Each chunk stores four (or five) things - block IDs (8-bit), block metadata (4-bit), block light (4-bit), and sky light (4-bit). The optional fifth value is "add" data, which is four bits to be added to block IDs for additional block ID support (not used in vanilla Minecraft). Block light is light cast by things like torches and glowstone, and is calculated with a 3D [http://en.wikipedia.org/wiki/Flood_fill Flood Fill] algorithm. Sky light is the light cast by the sky, and is calculated by starting at the top and working your way down. As you pass through semi-transparent blocks, you decrease the lighting value until you hit an opaque block. The opaque block is the last block whose skylight has a nonzero value. Lighting starts at 0xF (brightest) and works down to 0x0 (dimmest). Columns store biome information. Each 1x256x1 cuboid of blocks has the same biome value, for a total of 256 possible biome values per chunk (16x16). Biome values are stored as bytes.

	===Biome Values===		===Biome Values===

imported>Frogstair: Add warning that article may be outdated

2022-02-08T12:48:09Z

Add warning that article may be outdated

← Older revision		Revision as of 12:48, 8 February 2022
Line 1:		Line 1:
	This page covers the world information as of 1.2.5 to the present. See [[Alpha Map Format]] for Alpha information.		This page covers the world information as of 1.2.5 to the present. See [[Alpha Map Format]] for Alpha information.

			<!--Page may be outdated, since new versions changed how the world is generated-->

			{{Box
			\|BORDER = #BF880D
			\|BACKGROUND = #F7B217
			\|WIDTH = 100%
			\|ICON =
			\|HEADING = Heads up!
			\|CONTENT = Some information in this article may be outdated due to the new world generation introduced in the 1.17 update.
			}}

	==General Information==		==General Information==

imported>Kaleb Bruwer: Added note and changed Tag_Int('Y') to Tag_Byte('Y')

2021-02-03T09:05:48Z

Added note and changed Tag_Int('Y') to Tag_Byte('Y')

← Older revision		Revision as of 09:05, 3 February 2021
Line 197:		Line 197:

	The notchian implementation will '''never''' compress with gzip but can read if provided.		The notchian implementation will '''never''' compress with gzip but can read if provided.

			Note: The following example is outdated. It is accurate for (at least) 1.4, but at some point the format has been changed. However, you will still need to support this version if you want reverse compatibility with old save files.

	<pre>		<pre>
Line 214:		Line 216:
	TAG_Compound(''): 5 entries		TAG_Compound(''): 5 entries
	{		{
	~~TAG_Int~~('Y'): 0		TAG_Byte('Y'): 0
	TAG_Byte_Array('BlockLight'): 2048 bytes		TAG_Byte_Array('BlockLight'): 2048 bytes
	TAG_Byte_Array('Blocks'): 4096 bytes		TAG_Byte_Array('Blocks'): 4096 bytes
Line 222:		Line 224:
	TAG_Compound(''): 5 entries		TAG_Compound(''): 5 entries
	{		{
	~~TAG_Int~~('Y'): 1		TAG_Byte('Y'): 1
	TAG_Byte_Array('BlockLight'): 2048 bytes		TAG_Byte_Array('BlockLight'): 2048 bytes
	TAG_Byte_Array('Blocks'): 4096 bytes		TAG_Byte_Array('Blocks'): 4096 bytes

imported>Kaleb Bruwer: Changed yPos to zPos in example data

2021-02-01T11:09:34Z

Changed yPos to zPos in example data

← Older revision		Revision as of 11:09, 1 February 2021
Line 236:		Line 236:
	TAG_Byte('TerrainPopulated'): Has the terrain been generated		TAG_Byte('TerrainPopulated'): Has the terrain been generated
	TAG_Int('xPos'): X position of the region. Each single increment to x is 512 blocks		TAG_Int('xPos'): X position of the region. Each single increment to x is 512 blocks
	TAG_Int('~~yPos~~'): Y position of the region. Each single increment to y is 512 blocks		TAG_Int('zPos'): Z position of the region. Each single increment to z is 512 blocks
	TAG_Byte_Array('Biomes'): 256 bytes. Biomes affect blocks in 1x256x1 columns		TAG_Byte_Array('Biomes'): 256 bytes. Biomes affect blocks in 1x256x1 columns
	TAG_Int_Array('HeightMap'): 256 bytes		TAG_Int_Array('HeightMap'): 256 bytes