SMP Map Format - Revision history

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision	Revision as of 14:51, 12 June 2017
(No difference)

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision	Revision as of 14:51, 12 June 2017
(No difference)

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision	Revision as of 14:51, 12 June 2017
(No difference)

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision	Revision as of 14:51, 12 June 2017
(No difference)

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision	Revision as of 14:51, 12 June 2017
(No difference)

imported>Pokechu22: Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

2017-06-12T14:51:09Z

Pokechu22 moved page SMP Map Format to Chunk Format: Prepare to graduate User:Pokechu22/Chunk Format

← Older revision		Revision as of 14:51, 12 June 2017
Line 1:		Line 1:
	~~This page gives an overview of the SMP map format used in the [[Protocol\|protocol]].~~		#REDIRECT [[Chunk Format]]

	~~== Packets ==~~

	~~Two packets use this format:~~

	* [[Protocol#~~Chunk_Data\|0x21 chunk data]] - single column - used when player movement requires new chunks to be loaded. Also used to unload chunks.~~
	* [[~~Protocol#Map_Chunk_Bulk\|0x26 map chunk bulk]] - multiple columns - used when first spawning into a world and when player is teleported.~~

	~~== Concepts ==~~

	~~=== Storage ===~~
	* Chunk ~~Data: an array, either 2048 or 4096 bytes~~
	* Chunk: a 16x16x16 area, logically made up of multiple Chunk Data arrays, storing things like block ids and skylight
	* Chunk Column: 16 chunks aligned vertically (totalling 16x256x16). Chunks can be uninitialised (e.g. set to <code>null</code>)
	* World: a bunch of chunk columns

	~~=== Bitmasks ===~~

	You will sometimes get a blob of data and a bitmask. Each bit in the 16-bit short represents a chunk. The least significant bit represents the chunk from Y=0 to Y=15, and so forth. If it's <code>0</code>, the chunk is entirely air and there's no data to read.

	~~You need a loop like this:~~

	~~<code>~~
	~~chunks = array[16~~];
	~~for (i=0; i<16; i++) {~~
	~~if (bitmask & (1 << i)) {~~
	~~//read a chunk data array~~
	}
	}
	~~</code>~~

	~~== Format ==~~

	~~=== Chunk Column Metadata ===~~

	~~The packet contains important metadata which you'll need to pull out. In the case of 0x38, you'll need to loop over the metadata area. Specifically:~~

	* Chunk X
	* Chunk Z
	* Primary Bitmask
	* Add Bitmask
	* Ground-up continuous (only in 0x21 - assumed true in 0x26)
	* Skylight (only in 0x26 - assumed true in 0x21)

	~~=== Data ===~~

	~~The data is compressed using the deflate() function in zlib. In 0x21, it describes of a single chunk column in the format below. In 0x26, the format below is repeated for each chunk column.~~

	~~The format is thus:~~

	* Block type array - whole byte per block
	* Block metadata array - half byte per block
	* Block light array - half byte per block
	* Sky light array - half byte per block - only if 'skylight' is true
	* Add array - half byte per block - uses secondary bitmask
	* Biome array - whole byte per XZ coordinate, 256 bytes total, only sent if 'ground up continuous' is true

	Each section (except for biome) contains packed chunk data for zero or more 16x16x16 chunks. You need to refer to the primary bitmask for the chunk column to see which chunks are sent, or the add bitmask for 'add' data, which is Mojang's means of provided Block IDs past 256. In vanilla minecraft, you can expect this to always be zero.

	~~Chunks are sent bottom-to-top, i.e. the first chunk, if sent, extends from Y=0 to Y=15. Blocks are ordered Y, Z, X, i.e. the 'X' coordinate changes fastest.~~

	~~In half-byte arrays, two values are packed into each byte. Even-indexed items are packed into the ''high bits'', odd-indexed into the ''low bits''.~~

	~~The 'biome' array is always 256 bytes when sent. Values above 22 will cause the client to crash.~~

	~~== Implementations ==~~

	* [https://github.com/barneygale/smpmap Python, 1.4]

imported>MogAika: /* Data */

2014-01-17T20:53:11Z

Data

← Older revision		Revision as of 20:53, 17 January 2014
Line 46:		Line 46:
	=== Data ===		=== Data ===

	The data is compressed using the deflate() function in zlib. In ~~0x33~~, it describes of a single chunk column in the format below. In ~~0x38~~, the format below is repeated for each chunk column.		The data is compressed using the deflate() function in zlib. In 0x21, it describes of a single chunk column in the format below. In 0x26, the format below is repeated for each chunk column.

	The format is thus:		The format is thus:

imported>MogAika: /* Chunk Column Metadata */

2014-01-17T20:51:47Z

Chunk Column Metadata

← Older revision		Revision as of 20:51, 17 January 2014
Line 41:		Line 41:
	* Primary Bitmask		* Primary Bitmask
	* Add Bitmask		* Add Bitmask
	* Ground-up continuous (only in ~~0x33~~ - assumed true in ~~0x38~~)		* Ground-up continuous (only in 0x21 - assumed true in 0x26)
	* Skylight (only in ~~0x38~~ - assumed true in ~~0x33~~)		* Skylight (only in 0x26 - assumed true in 0x21)

	=== Data ===		=== Data ===

imported>MogAika: /* Implementations */

2014-01-17T20:50:30Z

Implementations

← Older revision		Revision as of 20:50, 17 January 2014
Line 67:		Line 67:
	== Implementations ==		== Implementations ==

	* [https://github.com/SirCmpwn/Craft.Net/blob/master/Craft.Net.Server/ChunkHelper.cs C#, 1.4.6]
	* [https://github.com/barneygale/smpmap Python, 1.4]		* [https://github.com/barneygale/smpmap Python, 1.4]

imported>MogAika at 20:50, 17 January 2014

2014-01-17T20:50:09Z

← Older revision		Revision as of 20:50, 17 January 2014
Line 5:		Line 5:
	Two packets use this format:		Two packets use this format:

	* [[Protocol#~~0x33~~\|~~0x33~~ chunk data]] - single column - used when player movement requires new chunks to be loaded. Also used to unload chunks.		* [[Protocol#Chunk_Data\|0x21 chunk data]] - single column - used when player movement requires new chunks to be loaded. Also used to unload chunks.
	* [[Protocol#~~0x38~~\|~~0x38~~ map chunk bulk]] - multiple columns - used when first spawning into a world and when player is teleported.		* [[Protocol#Map_Chunk_Bulk\|0x26 map chunk bulk]] - multiple columns - used when first spawning into a world and when player is teleported.

	== Concepts ==		== Concepts ==