地圖物品格式

地圖不在物品中儲存他們的資訊，而是將其數據值對應儲存的檔案的地圖數字（ID）。其數據放在此世界存檔目錄下的「data」目錄下。每個地圖都有它自己的與它ID相關聯的檔案，同時還有一個檔案用於追蹤最高的（=最近建立的）地圖ID。

當在地獄使用地圖時，地圖的繪製會像靜止了一樣，使它們完全不可讀。

數據資料夾結構

idcounts.dat檔案包含了目前地圖的最新ID。每個地圖的檔案名使用map_<#>.dat的格式，<#>是該地圖的獨有數字。

map_<#>.dat格式

map_<#>.dat檔案是由GZip壓縮的NBT檔案。

NBT結構

• ：根標籤。
  •  data：地圖資訊。
    •  banners：地圖裏的橫額標記。
      • 一個橫額標記。
        •  Color：橫額的顏色。有效的值包括：white、orange、magenta、light_blue、yellow、lime、pink、gray、light_gray、cyan、purple、blue、brown、green、red和black。
        •  Name：橫額的自訂名稱，是一個JSON文字。可能不存在。
        •  Pos：橫額在世界上的位置。
          •  X：橫額的X座標。
          •  Y：橫額的Y座標。
          •  Z：橫額的Z座標。
    •  colors：顏色的陣列，一共16384個點。顏色可以透過以下方法存取：colorID = colors[x + y * width]，其中 (x=0, y=0) 的點是左上角的點。
    •  dimension：維度的命名空間ID。
    •  frames：列舉了與此地圖相關聯的物品展示框。
      • ：一個物品展示框。
        •  EntityId：這個物品展示框的ID。
        •  Rotation：物品展示框的旋轉角，在0到360之間。
        •  Pos：物品展示框在世界中的方塊位置。
          •  X：物品展示框的X座標。
          •  Y：物品展示框的Y座標。
          •  Z：物品展示框的Z座標。
    •  locked：表示地圖是否被鎖定。
    •  scale：地圖縮放等級。縮放等級每增加一級，比例尺就放大一倍。最小值為0，此時為1:1縮放；最大值為4，此時為1:16縮放。
    •  trackingPosition：表示地圖是否追蹤玩家和物品展示框的位置並在地圖上呈現出來。
    •  unlimitedTracking：表示是否允許玩家位置指示器當玩家距地圖中心遠於320*(尺寸+1)格時在地圖邊緣以較小的點狀形式呈現。
    •  xCenter：地圖在遊戲世界裏的X中心。
    •  zCenter：地圖在遊戲世界裏的Z中心。
  •  DataVersion：地圖數據最後一次儲存時的數據版本。

當這個結構載入時，顏色陣列就會轉換成標準尺寸（如需要），這個結構就會以標準的高度和寬度儲存。

idcounts.dat格式

這個檔案追蹤最新加入的地圖。是由GZip壓縮的NBT檔案。

NBT結構

• 根標籤。
  •  data：地圖ID數據。
    •  map：目前最新地圖的ID。
  •  DataVersion：最後一次儲存此檔案的數據版本。

顏色表

地圖會使用一個顏色表對應顏色ID來儲存顏色。

基色

地圖會根據方塊的紋理來為它們着色。每個紋理都有一個基色，這也就是説，在地圖上顯示的顏色最根本取決於這個方塊的基色。基色會乘以135, 180, 220或255，再除以255來得到地圖色。而除以這四個數中的哪一個數，則取決於此方塊北側那個方塊的高度。

例如，現有兩個南北擺放的相鄰的黑色羊毛，黑色羊毛基色為RGB (25, 25, 25)。如果南方的羊毛高於北方的羊毛，則南方羊毛在地圖上的顏色是基色乘以255，除以255的結果，即(25, 25, 25)；如果南方的羊毛與北方的羊毛高度相同，南方羊毛在地圖上的顏色是基色乘以220，除以255的結果（向下取整），即(21, 21, 21)；如果南方的羊毛低於北方的羊毛，南方羊毛在地圖上的顏色是基色乘以180，除以255的結果，即(17, 17, 17)。

以下的每個基色都會與四個地圖色相關聯——將基色ID乘以4來得到第一個地圖色ID。

ID	顏色	RGB	對應方塊
0 NONE		透明	空氣、虛空空氣、洞穴空氣、障幕、紅石燈、蛋糕、動力路軌、感壓路軌、火炬、紅石線、 梯、路軌、拉桿、紅石火炬、按鈕, 紅石中繼器、絆線鈎、絆線、花盆、生物頭顱、 紅石比較器、觸發路軌、終界燭、玻璃、玻璃片、地獄傳送門、結構空位、鐵欄杆
1 GRASS		127, 178, 56	草地、史萊姆方塊
2 SAND		247, 233, 163	沙、樺木板、樺木原木（豎直）、剝皮樺木原木、樺木、剝皮樺木塊、樺木指示牌、 樺木壓力板、樺木地板門、樺木樓梯、樺木半磚、樺木閘門、樺木欄杆、樺木門、 砂岩（所有變種、所有半磚、所有樓梯、所有牆）、熒光石、終界石、終界石磚（半磚、樓梯、牆）、骨塊、 海龜蛋、竹棚
3 WOOL		199, 199, 199	蜘蛛網、蘑菇椗、牀（頭部）
4 FIRE		255, 0, 0	熔岩、TNT、火、紅石磚
5 ICE		160, 160, 255	冰、霜冰、冰磚、藍冰
6 METAL		167, 167, 167	鐵磚、鐵門、釀造台、重質測重壓力板、鐵製地板門、燈籠、鐵砧、砂輪
7 PLANT		0, 124, 0	樹苗、花、蘑菇、小麥, 蔗、南瓜梗、西瓜梗、荷葉、可可果、紅蘿蔔、薯仔、 紅菜頭、甜莓灌木叢、草、蕨、藤蔓、樹葉、仙人掌、竹
8 SNOW		255, 255, 255	積雪、雪、白色牀（尾部）、白色羊毛、白色玻璃、白色玻璃片、白色地氈、白色橫額、 白色界伏盒、白色釉陶、白色混凝土、白色混凝土粉末
9 CLAY		164, 168, 184	黏土、蟲蝕方塊（石頭、石春、石磚、青苔石春、青苔石磚、裂紋石磚、浮雕石磚）
10 DIRT		151, 109, 77	泥土、粗泥、耕地、草徑、花崗岩（半磚、樓梯、牆）、拋光花崗岩（半磚、樓梯）、叢林木板、 叢林木原木（豎直）、剝皮叢林木原木、叢林木、剝皮叢林木塊、叢林木指示牌、叢林木壓力板、 叢林木地板門、叢林木樓梯、叢林木半磚、叢林木閘門、叢林木欄杆、叢林木門、唱片機、啡色蘑菇方塊
11 STONE		112, 112, 112	石頭半磚、石頭樓梯、安山岩（半磚、樓梯、牆）、拋光安山岩（半磚、樓梯）、石春（半磚、樓梯）、基岩、 金礦、鐵礦、煤礦、青金石礦、發射器、青苔石春（半磚、樓梯、牆）、生成籠、鑽石礦、 熔爐、石製壓力板、紅石礦、石磚（所有變種、所有半磚、所有樓梯、所有牆）、綠寶石礦、終界箱、 掟器、平滑石頭（半磚、樓梯）、偵測器、煙燻爐、高爐、切石機、黏性活塞、活塞、活塞頭、 砂礫、相思木原木（側面）、鍋、漏斗
12 WATER		64, 64, 255	海帶、海草、水、氣泡柱
13 WOOD		143, 119, 72	橡木板、橡木原木（豎直）、剝皮橡木原木、橡木、剝皮橡木塊、橡木指示牌、橡木門、橡木壓力板、 橡木欄杆、橡木地板門、橡木閘門、橡木半磚、橡木樓梯、音符盒、書櫃、儲物箱、工作台、 陷阱箱、日光感測器、紡織機、木鐵桶、製圖台、製箭台、講台、鍛造台、堆肥桶、竹筍、 死灌木、石化橡木半磚、蜂箱、蜂巢
14 QUARTZ		255, 252, 245	閃長岩、拋光閃長岩、樺木原木（側面）、石英方塊（所有變種、所有半磚、所有樓梯）、海燈籠、標靶
15 COLOR_ORANGE		216, 127, 51	相思木板、相思木原木（豎直）、剝皮相思木原木、剝皮相思木塊、相思木指示牌、相思木地板門、 相思木半磚、紅沙、橙色羊毛、橙色地氈、橙色界伏盒、橙色牀（尾部）、橙色玻璃、 橙色玻璃片、橙色橫額、橙色釉陶、橙色混凝土、橙色混凝土粉末、南瓜、雕刻南瓜、 南瓜燈, 陶瓦、紅砂岩（所有變種、所有樓梯、所有半磚、所有牆）、蜜糖塊、蜂巢蜜塊、銅磚、切製銅磚
16 COLOR_MAGENTA		178, 76, 216	紫紅色羊毛、紫紅色地氈、紫紅色界伏盒、紫紅色牀（尾部）、紫紅色染色玻璃、紫紅色染色玻璃片、 紫紅色橫額、紫紅色釉陶、紫紅色混凝土、紫紅色混凝土粉末、紫珀磚（所有變種、半磚、樓梯）
17 COLOR_LIGHT_BLUE		102, 153, 216	淺藍色羊毛、淺藍色地氈、淺藍色界伏盒、淺藍色牀（尾部）、淺藍色玻璃、淺藍色玻璃片、 淺藍色橫額、淺藍色釉陶、淺藍色混凝土、淺藍色混凝土粉末
18 COLOR_YELLOW		229, 229, 51	海綿、濕海綿、黃色羊毛、黃色地氈、黃色界伏盒、黃色牀（尾部）、黃色玻璃、 黃色玻璃片、黃色橫額、黃色釉陶、黃色混凝土、黃色混凝土粉末、乾草捆、角珊瑚塊、 角珊瑚、扇狀角珊瑚
19 COLOR_LIGHT_GREEN		127, 204, 25	淺綠色羊毛、淺綠色地氈、淺綠色界伏盒、淺綠色牀（尾部）、淺綠色玻璃、淺綠色玻璃片、 淺綠色橫額、淺綠色釉陶、淺綠色混凝土、淺綠色混凝土粉末、西瓜
20 COLOR_PINK		242, 127, 165	粉紅色羊毛、粉紅色地氈、粉紅色界伏盒、粉紅色牀（尾部）、粉紅色玻璃、粉紅色玻璃片、 粉紅色橫額、粉紅色釉陶、粉紅色混凝土、粉紅色混凝土粉末、腦珊瑚方塊、腦珊瑚、扇狀腦珊瑚
21 COLOR_GRAY		76, 76, 76	相思木、灰色羊毛、灰色地氈、灰色界伏盒、灰色牀（尾部）、灰色玻璃、灰色玻璃片、 灰色橫額、灰色釉陶、灰色混凝土、灰色混凝土粉末、死亡珊瑚方塊、死亡珊瑚、死亡扇狀珊瑚、遮光玻璃
22 COLOR_LIGHT_GRAY		153, 153, 153	淺灰色羊毛、淺灰色地氈、淺灰色界伏盒、淺灰色牀（尾部）、淺灰色玻璃、淺灰色玻璃片、 淺灰色橫額、淺灰色釉陶、淺灰色混凝土、淺灰色混凝土粉末、結構方塊、拼圖方塊
23 COLOR_CYAN		76, 127, 153	青藍色羊毛、青藍色地氈、青藍色界伏盒、青藍色牀（尾部）、青藍色染色玻璃、青藍色染色玻璃片、青藍色橫額、 青藍色釉陶、青藍色混凝土、青藍色混凝土粉末、海磷石（半磚、樓梯、牆）
24 COLOR_PURPLE		127, 63, 178	界伏盒、紫色羊毛、紫色地氈、紫色牀（尾部）、紫色玻璃、紫色玻璃片、紫色橫額、 紫色釉陶、紫色混凝土、紫色混凝土粉末、菌絲土、歌萊植株、歌萊花、重複型命令方塊、 氣泡珊瑚方塊、氣泡珊瑚、扇狀氣泡珊瑚、紫水晶磚、紫水晶母岩
25 COLOR_BLUE		51, 76, 178	藍色羊毛、藍色地氈、藍色界伏盒、藍色牀（尾部）、藍色玻璃、藍色玻璃片、藍色橫額、 藍色釉陶、藍色混凝土、藍色混凝土粉末、管珊瑚方塊、管珊瑚、扇狀管珊瑚
26 COLOR_BROWN		102, 76, 51	黑橡木板、黑橡木原木、剝皮黑橡木原木、黑橡木、剝皮黑橡木塊、黑橡木指示牌、 黑橡木壓力板、黑橡木地板門、黑橡木樓梯、黑橡木半磚、黑橡木閘門、黑橡木欄杆、 黑橡木門、杉木原木（側面）、啡色羊毛、啡色地氈、啡色界伏盒、啡色牀（尾部）、啡色染色玻璃、 啡色染色玻璃片、啡色橫額、啡色釉陶、啡色混凝土、啡色混凝土粉末、靈魂砂、命令方塊
27 COLOR_GREEN		102, 127, 51	綠色羊毛、綠色地氈、綠色界伏盒、綠色牀（尾部）、綠色玻璃、綠色玻璃片、綠色橫額、 綠色釉陶、綠色混凝土、綠色混凝土粉末、終界傳送門框、連環型命令方塊、乾海帶捆、海鞘
28 COLOR_RED		153, 51, 51	紅色羊毛、紅色地氈、紅色界伏盒、紅色牀（尾部）、紅色玻璃、紅色玻璃片、紅色橫額、 紅色釉陶、紅色混凝土、紅色混凝土粉末、紅磚頭塊（半磚、樓梯、牆）、紅色蘑菇方塊、地獄孢子、 附魔台、地獄孢子塊、火珊瑚方塊、火珊瑚、扇狀火珊瑚、菌光體
29 COLOR_BLACK		25, 25, 25	黑色羊毛、黑色地氈、黑色界伏盒、黑色牀（尾部）、黑色玻璃、黑色玻璃片、黑色橫額、 黑色釉陶、黑色混凝土、黑色混凝土粉末、黑曜石、終界傳送門、龍蛋、煤炭塊、 終界折躍門、玄武岩（所有變種）、黑石（所有變種、所有半磚、所有樓梯、所有壓力板、所有牆）、地獄合金磚、遠古殘骸、哭曜石、鑲金黑石、重生錨
30 GOLD		250, 238, 77	金磚、輕質測重壓力板、鐘、粗金磚
31 DIAMOND		92, 219, 213	鑽石磚、烽火台、海磷石磚（半磚、樓梯）、暗海磷石（半磚、樓梯）、海靈核心
32 LAPIS		74, 128, 255	青金石磚
33 EMERALD		0, 217, 58	綠寶石磚
34 PODZOL		129, 86, 49	灰壤、杉木板、杉木原木（豎直）、剝皮杉木原木、杉木、剝皮杉木塊、杉木指示牌、 杉木壓力板、杉木地板門、杉木樓梯、杉木半磚、杉木閘門、杉木欄杆、杉木門、 橡木原木（側面）、叢林木原木（側面）、營火
35 NETHER		112, 2, 0	地獄石、地獄磚（欄杆、半磚、樓梯、牆）、地獄石英礦、岩漿塊、紅色地獄磚（半磚、樓梯、牆）、地獄金礦
36 TERRACOTTA_WHITE		209, 177, 161	白色陶瓦、方解石
37 TERRACOTTA_ORANGE		159, 82, 36	橙色陶瓦
38 TERRACOTTA_MAGENTA		149, 87, 108	紫紅色陶瓦
39 TERRACOTTA_LIGHT_BLUE		112, 108, 138	淺藍色陶瓦
40 TERRACOTTA_YELLOW		186, 133, 36	黃色陶瓦
41 TERRACOTTA_LIGHT_GREEN		103, 117, 53	淺綠色陶瓦
42 TERRACOTTA_PINK		160, 77, 78	粉紅色陶瓦
43 TERRACOTTA_GRAY		57, 41, 35	灰色陶瓦
44 TERRACOTTA_LIGHT_GRAY		135, 107, 98	淺灰色陶瓦、斑駁嘅銅磚（半磚、樓梯）、斑駁嘅切製銅磚（半磚、樓梯）
45 TERRACOTTA_CYAN		87, 92, 92	青藍色陶瓦
46 TERRACOTTA_PURPLE		122, 73, 88	紫色陶瓦、紫色界伏盒
47 TERRACOTTA_BLUE		76, 62, 92	藍色陶瓦
48 TERRACOTTA_BROWN		76, 50, 35	啡色陶瓦、滴水石
49 TERRACOTTA_GREEN		76, 82, 42	綠色陶瓦
50 TERRACOTTA_RED		142, 60, 46	紅色陶瓦
51 TERRACOTTA_BLACK		37, 22, 16	黑色陶瓦
52 CRIMSON_NYLIUM		189, 48, 49	緋紅菌絲石
53 CRIMSON_PLANKS		148, 63, 97	猩紅菌木板、猩紅菌椗、剝皮猩紅菌椗
54 CRIMSON_STEM		92, 25, 29	猩紅菌絲體、剝皮猩紅菌絲體
55 WARPED_NYLIUM		22, 126, 134	扭曲菌絲石、氧化嘅銅磚（半磚、樓梯、打蠟）、氧化嘅切製銅磚（半磚、樓梯、打蠟）
56 WARPED_PLANKS		58, 142, 140	迷離菌木板、迷離菌椗、剝皮迷離菌椗、生鏽嘅銅磚（半磚、樓梯、打蠟）、生鏽嘅切製銅磚（半磚、樓梯、打蠟）
57 WARPED_STEM		86, 44, 62	迷離菌絲體、剝皮迷離菌絲體
58 WARPED_WART		20, 180, 133	迷離孢子塊
59 DEEPSLATE		86, 86, 86	深板岩（所有變種、所有半磚、所有樓梯、所有牆、所有礦石）、強化深板岩
60 RAW_IRON_BLOCK		186, 150, 126	粗鐵磚
61 GLOW_LICHEN		127, 167, 150	發光地衣、蒼翠蛙光體

地圖色

上面的每個基色都有4個相關聯的地圖色。該轉換將用紅、綠和藍分別乘上一個值再除以255，最後取整到一個整數。從13w42b開始，第四個基色變體將乘上135，得到一個較暗的顏色集合而不只是第二個基色變體的副本。

地圖色ID	R、G、B所乘的數	= 實際乘數
基色ID×4 + 0	180	0.71
基色ID×4 + 1	220	0.86
基色ID×4 + 2	255（相同的顏色）	1
基色ID×4 + 3	135	0.53

每個顏色的不同陰影，不包括水

1.12中每個地圖顏色的不同陰影，不包括水

地圖像素畫

一位玩家使用了階梯型的方法來製作一幅像素畫

人們會用地圖來創作像素畫。預設的地圖大小為128×128並會讀取每一個方塊為一種特定的顏色。透過以特定的排列放置方塊，為創作像素畫圖像提供了可能。

創作地圖像素畫有兩種方法：平面型和階梯型。平面型方法涉及在一個平面上放置像素圖像，最後建立出一個地板。平面型方法是兩種方法中較簡單的一種，但只提供了60色的調色板。而階梯型方法提供了180色，但使用起來更加複雜了。在階梯型方法中，方塊需要被放置不同的高度來獲得特定的顏色變化。一個方塊的顏色會在比北邊方塊低的位置時變暗，而在比北邊方塊高的位置時變亮。

使用平面型方法時，可以使用以上列表中每個顏色組的第二個陰影。對於階梯型方法，可以使用以上顏色組的前三個陰影。只有使用外部工具才能獲得第四個陰影。

代碼示例

以下是一些用來處理地圖的代碼示例。

庫名	語言	代碼連結
MCModify	Java	Map.java
minecraftmap	Python	__init__.py
mcmapimg	Python	mcmapimg.py

歷史

Java版Beta
?					Notch嘗試着加入地圖，但沒有使用NBT格式。
1.6		Test Build 3			加入了地圖。
					地圖ID被限制為短整型的大小（32,768）。
Java版
1.8.1		pre1			加入了地獄顏色NETHER（35），基色數量提升到36。
					第四種顏色的乘數從 220 (0.86) 改為 135 (0.53)。
1.12		17w17a			基色數量提升到52。
1.13		17w47a			地圖ID不再使用短整型（32,767）而改用了整型（2,147,483,647），因為它們不再基於物品的損害值。
					idcounts.dat現在使用整型（2,147,483,647）而不是短整型。
		18w19a			加入了DataVersion來儲存map_<#>.dat。（idcounts.dat仍然沒有DataVersion）
1.14		19w02a			加入了locked來儲存map_<#>.dat。
1.16		pre6			加入基色CRIMSON_NYLIUM（52）、CRIMSON_STEM（53）、CRIMSON_HYPHAE（54）、WARPED_NYLIUM（55）、WARPED_STEM（56）、WARPED_HYPHAE（57）和WARPED_WART_BLOCK（58），基色數量提升到59。
1.17		21w15a			加入基色DEEPSLATE（59）和RAW_IRON（60），基色數量提升到了61。
		21w16a			加入基色GLOW_LICHEN（61），基色數量提升到了62。

參考

語言

• Deutsch
• English
• français
• 日本語
• Nederlands