Kaart object formaat

Uit Minecraft Wiki
Ga naar: navigatie, zoeken
Vertalen.png
Deze pagina heeft vertaling nodig
Deze pagina bevat te veel woorden uit een andere taal.

Minecraft Beta 1.6 added craftable map items. Unlike books, maps do not store their information in the item - instead, their data value corresponds to the map number (ID) of a saved file. Their information is placed in the "data" directory within the world's save directory. Each map has its own file associated with its ID, and there is one file that keeps track of the highest (= most recently created) map ID. This is limited to the size of a short (65,536).[1] When Notch was adding them the first time he did not use the NBT format.[2]

There is support for The Nether, but it is obscured by the top blocks of the Nether and therefore unreadable. The End is supported without problems.

Data folder structure[bewerken]

The file idcounts.dat (zie § idcounts.dat format) contains the latest ID for current map. Each map's file name uses the format map<#>.dat, where <#> is the map's unique number.

map_<#>.dat format[bewerken]

map_<#>.dat files are GZip'd NBT files.

NBT structure[bewerken]


  • : The root tag.

    •  data:: The map data.

      •  scale:: How zoomed in the map is (it is in 2scale blocks square per pixel, even for 0, where the map will be 1:1). Default 3, minimum 0 and maximum 4.

      •  dimension:: 0 = The Overworld, -1 = The Nether, 1 = The End

      •  height:: Height of map. Default (and only possible value) 128

      •  width:: Width of map. Default (and only possible value) 128

      •  xCenter:: Center of map according to real world by X

      •  zCenter:: Center of map according to real world by Z

      •  colors:: Width * Height array of color values (16384 entries for a default 128x128 map). Color can be accessed via the following method: colorID = Colors[widthOffset + heightOffset * width], where (widthOffset==0, heightOffset==0) is left upper point.

When this structure is loaded, Colors array is transformed to standard dimension (if it's necessary) and then structure is saved with standard height and width.

idcounts.dat format[bewerken]

This file keeps track of the latest map added. It is stored as a raw (uncompressed) NBT file.

NBT structure[bewerken]


  • : The root tag.

    •  map:: Latest map ID.

Color table[bewerken]

Maps use a color table to store the colors efficiently by ID.

Base colors[bewerken]

Blocks are colored according to their material. Each material has a base color which is multiplied by 180, 220 or 255, and then divided by 255 to make the map color. Each base color below is associated with four map colors - to get the first map color ID for a base color, multiply the base color ID by 4. Kaart object formaat/header

Map colors[bewerken]

Each base color above has 4 associated map colors below. The conversion works by multiplying each of the red, green, and blue values by a value and then dividing by 255, finally rounding to the nearest whole.

Map Color ID Multiply R,G,B By
Base Color ID*4 + 0 180
Base Color ID*4 + 1 220
Base Color ID*4 + 2 255 (same color)
Base Color ID*4 + 3 220

Here is a map color table provided as an example: Kaart object formaat/header

Code examples[bewerken]

Library name Language Link to Map-related code
MCModify Java Map.java

References[bewerken]