地図アイテムフォーマット

Minecraft Beta 1.6で、製作可能なアイテムの地図が導入された。本とは異なり、地図はその情報をアイテム内に格納しない。代わりに、保存されたファイルの地図番号 (ID) に対応した値をデータ値に保存している。それら情報はワールドを保存したフォルダーの中の "data" フォルダーに配置されている。地図毎にそのIDを持つ独立したファイルがあり、加えて地図IDの最大の値 (つまり、最も最近に作られたもの) を保存するファイルがある。地図IDはunsigned short (無符号16ビット数、65,536未満) に制限されている。Notchが地図を始めて追加したときは、NBTフォーマットは用いられていなかった。

ネザーにも対応しているが、ネザーには天井ブロックがあるので地形ははっきりせず、見ることが出来ない。エンドは問題なく対応している。

データフォルダーの構造

ファイル"idcounts.dat"に、現時点で最新の地図IDが保存されている。各地図ファイルのファイル名は<#>は地図のID番号として、map<#>.datという形になっている。

map_<#>.datフォーマット

map_<#>.datファイルはGZIP圧縮されたNBTファイルになっている。

NBT構造体

• ルートタグ
  •  data：地図データ
    •  scale：地図の拡大率 (2^scale のブロックが1ピクセルに対応している。scaleが0の場合、地図は1:1対応になる)。0∼4の値になり、標準は3
    •  dimension：0 = オーバーワールド, -1 = ネザー, 1 = エンド
    •  height：地図の高さ。標準値 (かつ唯一とれる値) は128
    •  width：地図の幅。標準値 (かつ唯一とれる値) は128
    •  xCenter：地図の中央。実際のワールドのX座標
    •  zCenter：地図の中央。実際のワールドのZ座標
    •  colors：幅×高さの色コードの配列 (標準の128×128の大きさの地図の場合16,384項目)。任意の場所の色コードは次のようにアクセスできる：colorID = Colors[widthOffset ＋ heightOffset × width]。つまり (widthOffset==0, heightOffset==0) が左上の角の点の値になる

この構造体が読み込まれたとき、配列colorsは標準の大きさに変換され (必要であれば)、そして標準の高さ (height) と幅 (width) として保存される。

idcounts.datフォーマット

このファイルが、最近追加された地図を記録し続ける。生の (非圧縮の) NBTファイルとして保存される。

NBT構造体

• ルートタグ
  •  map：最新の地図ID

色テーブル

地図は、IDごとの色を効率的に保存する為に色テーブルを用いている。

基本色

ブロックはその素材毎に色分けされている。素材ごとに基本色があり、基本色のR、G、Bそれぞれを、180、220、255の何れかの数を掛け、255で割ることで地図に用いられる色となる。以下に挙げる各基本色は4つの地図色と関連付けられている。基本色から最初の地図の色IDを得るには、基本色IDを4倍すればよい。

色一覧

ID	色	RGB	ブロック
0		透明
1		127,178,56
2		247,233,163
3		167,167,167
4		255,0,0
5		160,160,255
6		167,167,167
7		0,124,0
8		255,255,255
9		164,168,184
10		183,106,47
11		112,112,112
12		64,64,255
13		104,83,50
14		255, 252, 245
15		216, 127, 51
16		178, 76, 216
17		102, 153, 216
18		229, 229, 51
19		127, 204, 25
20		242, 127, 165
21		76, 76, 76
22		153, 153, 153
23		76, 127, 153
24		127, 63, 178
25		51, 76, 178
26		102, 76, 51
27		102, 127, 51
28		153, 51, 51
29		25, 25, 25
30		250, 238, 77
31		92, 219, 213
32		74, 128, 255
33		0, 217, 58
34		129, 86, 49
35		112, 2, 0

地図の色

上で述べた基本色に関連して、後述する4つの地図色がある。変換するには、R、G、Bそれぞれに、ある値を掛けて255で割る。最後に四捨五入する。

地図色ID	RGBそれぞれの倍率
基本色ID×4 + 0	180
基本色ID×4 + 1	220
基本色ID×4 + 2	255 (同一の色)
基本色ID×4 + 3	220

1.8.1でのカラーテーブル

色一覧

ID	色	RGB	ブロック
0		透明
1		透明
2		透明
3		透明
4		89,125,39
5		109,153,48
6		127,178,56
7		109,153,48
8		174,164,115
9		213,201,140
10		247,233,163
11		213,201,140
12		117,117,117
13		144,144,144
14		167,167,167
15		144,144,144
16		180,0,0
17		220,0,0
18		255,0,0
19		220,0,0
20		112,112,180
21		138,138,220
22		160,160,255
23		138,138,220
24		117,117,117
25		144,144,144
26		167,167,167
27		144,144,144
28		0,87,0
29		0,106,0
30		0,124,0
31		0,106,0
32		180,180,180
33		220,220,220
34		255,255,255
35		220,220,220
36		115,118,129
37		141,144,158
38		164,168,184
39		141,144,158
40		129,74,33
41		157,91,40
42		183,106,47
43		157,91,40
44		79,79,79
45		96,96,96
46		112,112,112
47		96,96,96
48		45,45,180
49		55,55,220
50		64,64,255
51		55,55,220
52		73,58,35
53		89,71,43
54		104,83,50
55		89,71,43
56		180,177,172
57		220,217,211
58		255,252,245
59		135,133,129
60		152,89,36
61		186,109,44
62		216,127,51
63		114,67,27
64		125,53,152
65		153,65,186
66		178,76,216
67		94,40,114
68		72,108,152
69		88,132,186
70		102,153,216
71		54,81,114
72		161,161,36
73		197,197,44
74		229,229,51
75		121,121,27
76		89,144,17
77		109,176,21
78		127,204,25
79		67,108,13
80		170,89,116
81		208,109,142
82		242,127,165
83		128,67,87
84		53,53,53
85		65,65,65
86		76,76,76
87		40,40,40
88		108,108,108
89		132,132,132
90		153,153,153
91		81,81,81
92		53,89,108
93		65,109,132
94		76,127,153
95		40,67,81
96		89,44,125
97		109,54,153
98		127,63,178
99		67,33,94
100		36,53,125
101		44,65,153
102		51,76,178
103		27,40,94
104		72,53,36
105		88,65,44
106		102,76,51
107		54,40,27
108		72,89,36
109		88,109,44
110		102,127,51
111		54,67,27
112		108,36,36
113		132,44,44
114		153,51,51
115		81,27,27
116		17,17,17
117		21,21,21
118		25,25,25
119		13,13,13
120		176,168,54
121		215,205,66
122		250,238,77
123		132,126,40
124		64,154,150
125		79,188,183
126		92,219,213
127		48,115,112
128		52,90,180
129		63,110,220
130		74,128,255
131		39,67,135
132		0,153,40
133		0,187,50
134		0,217,58
135		0,114,30
136		90,59,34
137		110,73,41
138		127,85,48
139		67,44,25
140		79,1,0
141		96,1,0
142		112,2,0
143		59,1,0

1.7.2 Color Table

色一覧

ID	色	RGB	ブロック
0		透明
1		透明
2		透明
3		透明
4		89,125,39
5		109,153,48
6		127,178,56
7		67,94,29
8		174,164,115
9		213,201,140
10		247,233,163
11		130,123,86
12		180,0,0
13		220,0,0
14		255,0,0
15		135,0,0
16		112,112,180
17		138,138,220
18		160,160,255
19		84,84,135
20		117,117,117
21		144,144,144
22		167,167,167
23		88,88,88
24		0,87,0
25		0,106,0
26		0,124,0
27		0,65,0
28		180,180,180
29		220,220,220
30		255,255,255
31		135,135,135
32		115,118,129
33		141,144,158
34		164,168,184
35		86,88,97
36		129,74,33
37		157,91,40
38		183,106,47
39		96,56,24
40		79,79,79
41		96,96,96
42		112,112,112
43		59,59,59
44		45,45,180
45		55,55,220
46		64,64,255
47		33,33,135
48		73,58,35
49		89,71,43
50		104,83,50
51		55,43,26
52		180,177,172
53		220,217,211
54		255,252,245
55		135,133,129
56		152,89,36
57		186,109,44
58		216,127,51
59		114,67,27
60		125,53,152
61		153,65,186
62		178,76,216
63		94,40,114
64		72,108,152
65		88,132,186
66		102,153,216
67		54,81,114
68		161,161,36
69		197,197,44
70		229,229,51
71		121,121,27
72		89,144,17
73		109,176,21
74		127,204,25
75		66,108,13
76		170,89,116
77		208,109,142
78		242,127,165
79		128,67,87
80		53,53,53
81		65,65,65
82		76,76,76
83		40,40,40
84		108,108,108
85		132,132,132
86		153,153,153
87		81,81,81
88		53,89,108
89		65,109,132
90		76,127,153
91		40,67,81
92		89,44,125
93		109,54,153
94		127,63,178
95		67,33,94
96		36,53,125
97		44,65,153
98		51,76,178
99		27,40,94
100		72,53,36
101		88,65,44
102		102,76,51
103		54,40,27
104		72,89,36
105		88,109,44
106		102,127,51
107		54,67,27
108		108,36,36
109		132,44,44
110		153,51,51
111		81,27,27
112		17,17,17
113		21,21,21
114		25,25,25
115		13,13,13
116		176,168,54
117		215,205,66
118		250,238,77
119		132,126,40
120		64,154,150
121		79,188,183
122		92,219,213
123		48,115,112
124		52,90,180
125		63,110,220
126		74,128,255
127		39,67,135
128		0,153,40
129		0,187,50
130		0,217,58
131		0,114,30
132		14,14,21
133		18,17,26
134		21,20,31
135		11,10,16
136		79,1,0
137		96,1,0
138		112,2,0
139		59,1,0

Original Color Table

色一覧

ID	色	RGB	ブロック
0		透明
1		透明
2		透明
3		89,125,39
4		109,153,48
5		127,178,56
6		174,164,115
7		213,201,140
8		247,233,163
9		180,0,0
10		220,0,0
11		255,0,0
12		112,112,180
13		138,138,220
14		160,160,255
15		117,117,117
16		144,144,144
17		167,167,167
18		0,87,0
19		0,106,0
20		0,124,0
21		180,180,180
22		220,220,220
23		255,255,255
24		115,118,129
25		141,144,158
26		164,168,184
27		129,74,33
28		157,91,40
29		183,106,47
30		79,79,79
31		96,96,96
32		112,112,112
33		45,45,180
34		55,55,220
35		64,64,255
36		73,58,35
37		89,71,43
38		104,83,50