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

提供: Minecraft Wiki
移動先: 案内検索
Clock.png
この記事は内容の更新を必要とします。
情報の一部は、現在の最新バージョンには適用されません。
Book and Quill.png
この記事は翻訳途中です。
あなたが内容を翻訳してみませんか?
Information icon.svg
この項目はJava Edition限定の要素です。

地図はその情報をアイテム内に格納しない。代わりに、保存されたファイルの地図番号 (ID) に対応した値をデータ値に保存している。それら情報はワールドを保存したフォルダーの中の "data" フォルダーに配置されている。地図毎にそのIDを持つ独立したファイルがあり、加えて地図IDの最大の値(つまり、最も最近に作られたもの)を保存するファイルがある。

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

データフォルダーの構造[編集 | ソースを編集]

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

map_<#>.datフォーマット[編集 | ソースを編集]

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

NBT構造体[編集 | ソースを編集]

  • Nbtsheet.png ルートタグ
    • Nbtsheet.png data:地図データ
      • Nbtsheet.png scale:地図の拡大率(2scaleのブロックが1ピクセルに対応している。scaleが0の場合、地図は1:1対応になる)。0–4の値になり、標準は3。
      • Nbtsheet.png dimension:0 = オーバーワールド, -1 = ネザー, 1 = ジ・エンド, その他の値 = 地図は、プレーヤーピンのない静止画になる。
      • Nbtsheet.png trackingPosition: 1 (default) indicates that a positional arrow should be shown when the map is near its center coords. 0 indicates that the position arrow should never be shown.
      • Nbtsheet.png unlimitedTracking: 1 allows the player position indicator to show as a smaller dot on the map's edge when the player is farther than 320 * (scale+1) blocks from the map's center. 0 will make the dot instead disappear when the player is farther than this distance. Defaults to 0 for maps created from an empty map and 1 for Explorer Maps.
      • Nbtsheet.png locked: 1 if the map has been locked in a cartography table.
      • Nbtsheet.png xCenter:地図の中央。実際のワールドのX座標。
      • Nbtsheet.png zCenter:地図の中央。実際のワールドのZ座標。
      • Nbtsheet.png banners: List of banner markers added to this map. May be empty.
        • Nbtsheet.png A banner marker.
          • Nbtsheet.png Color: The color of the banner. Allowed values: white, orange, magenta, light_blue, yellow, lime, pink, gray, light_gray, cyan, purple, blue, brown, green, red, black.
          • Nbtsheet.png Name: The custom name of the banner, in JSON text. May not exist.
          • Nbtsheet.png Pos: The block position of the banner in the world.
            • Nbtsheet.png X: The x-position of the banner.
            • Nbtsheet.png Y: The y-position of the banner.
            • Nbtsheet.png Z: The z-position of the banner.
      • Nbtsheet.png frames: List map markers added to this map. May be empty.
        • Nbtsheet.png A marker.
          • Nbtsheet.png EntityId: Arbitrary unique value for the marker.
          • Nbtsheet.png Rotation: The rotation of the marker, ranging from 0 to 360.
          • Nbtsheet.png Pos: The block position of the marker in the world.
            • Nbtsheet.png X: The x-position of the marker.
            • Nbtsheet.png Y: The y-position of the marker.
            • Nbtsheet.png Z: The z-position of the marker.
      • Nbtsheet.png colors:幅×高さの色コードの配列(標準の128×128の大きさの地図の場合16,384項目)。任意の場所の色コードは次のようにアクセスできる:colorID = Colors[widthOffset + heightOffset × width]。つまり(widthOffset==0, heightOffset==0)が左上の角の点の値になる。
    • Nbtsheet.png DataVersion: The version the map was created. If not present, defaults to 1343 (1.12.2)

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

idcounts.datフォーマット[編集 | ソースを編集]

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

NBT構造体[編集 | ソースを編集]

  • Nbtsheet.png ルートタグ
    • Nbtsheet.png Data
      • Nbtsheet.png map:最新の地図ID
    • Nbtsheet.png DataVersion

色テーブル[編集 | ソースを編集]

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

基本色[編集 | ソースを編集]

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

色一覧
ID RGB ブロック
0 NONE 透明 空気, 奈落の空気, 洞窟の空気, バリアブロック, レッドストーンランプ, ケーキ, パワードレール, ディテクターレール, 松明, レッドストーンワイヤー, はしご, レール, レバー, レッドストーントーチ, ボタン, リピーター, トリップワイヤーフック, トリップワイヤー, 植木鉢, , コンパレーター, アクティベーターレール, エンドロッド, ガラス, 板ガラス, ネザーポータル, ストラクチャーヴォイド, 鉄格子
1 GRASS 127, 178, 56 草ブロック, スライムブロック
2 SAND 247, 233, 163 , シラカバ (木材, 原木 (vertical), 樹皮を剥いだ原木, , 樹皮を剥いだ木, 看板, 感圧板, トラップドア, 階段, ハーフブロック, フェンスゲート, フェンス, ドア), 砂岩 (All variants, all slabs, all stairs, all walls), グロウストーン, エンドストーン, エンドストーンレンガ (ハーフブロック, 階段, 塀), 骨ブロック, カメの卵, 足場
3 WOOL 199, 199, 199 クモの巣, キノコの柄, ベッド (head)
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 , 雪ブロック, 白色 (ベッド (foot), 羊毛, 色付きガラス, 色付きガラス板, カーペット, , シュルカーボックス, 彩釉テラコッタ, コンクリート, コンクリートパウダー)
9 CLAY 164, 168, 184 粘土, 虫食い石 (石, 丸石, 石レンガ, 苔むした石レンガ, ひび割れた石レンガ, 模様入りの石レンガ)
10 DIRT 151, 109, 77 , 粗い土, 耕地, 草の道, 花崗岩 (ハーフブロック, 階段, 塀), 磨かれた花崗岩 (ハーフブロック, 階段), ジャングル (木材, 原木 (vertical), 樹皮を剥いだ原木, , 樹皮を剥いだ木, 看板, 感圧板, トラップドア, 階段, ハーフブロック, フェンスゲート, フェンス, ドア), ジュークボックス, 茶色のキノコブロック
11 STONE 112, 112, 112 (ハーフブロック, 階段), 安山岩 (ハーフブロック, 階段, 塀), 磨かれた安山岩 (ハーフブロック, 階段), 丸石 (ハーフブロック, 階段), 岩盤, 金鉱石, 鉄鉱石, 石炭鉱石, ラピスラズリ鉱石, ディスペンサー, 苔むした丸石 (ハーフブロック, 階段, 塀), スポナー, ダイヤモンド鉱石, かまど, 石の感圧板, レッドストーン鉱石, 石レンガ (all variants, all slabs, all stairs, all walls), エメラルド鉱石, エンダーチェスト, ドロッパー, 滑らかな石 (ハーフブロック, 階段), オブザーバー, 燻製器, 溶鉱炉, 石切台, 粘着ピストン, ピストン, ピストンヘッド, 砂利, アカシア 原木 (side), 大釜, ホッパー
12 WATER 64, 64, 255 コンブ, 海草, , 気泡柱
13 WOOD 143, 119, 72 オーク (木材, 原木 (vertical), 樹皮を剥いだ原木, , 樹皮を剥いだ木, 看板, ドア, 感圧板, フェンス, トラップドア, フェンスゲート, ハーフブロック, 階段), 音符ブロック, 本棚, チェスト, 作業台, トラップチェスト, 日照センサー, 機織り機, , 製図台, 矢細工台, 書見台, 鍛冶台, コンポスター, タケノコ, 枯れ木, 石化したオークのハーフブロック, 養蜂箱, ミツバチの巣
14 QUARTZ 255, 252, 245 閃緑岩, 磨かれた閃緑岩, シラカバ 原木 (side), クォーツブロック (all variants, all slabs, all stairs), シーランタン
15 COLOR_ORANGE 216, 127, 51 アカシア (木材, 原木 (vertical), 樹皮を剥いだ原木, 樹皮を剥いだ木, 看板, トラップドア, ハーフブロック), 赤い砂, 橙色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), カボチャ, カボチャ, ジャック・オ・ランタン, テラコッタ, 赤い砂岩 (all variants, all stairs, all slabs, all walls), ハチミツブロック, ハニカムブロック
16 COLOR_MAGENTA 178, 76, 216 赤紫色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), プルプァ (all variants, ハーフブロック, 階段)
17 COLOR_LIGHT_BLUE 102, 153, 216 空色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー)
18 COLOR_YELLOW 229, 229, 51 スポンジ, 濡れたスポンジ, 黄色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), 干草の俵, シカツノサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
19 COLOR_LIGHT_GREEN 127, 204, 25 黄緑色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), スイカ
20 COLOR_PINK 242, 127, 165 桃色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), ノウサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
21 COLOR_GRAY 76, 76, 76 アカシア 羊毛, 灰色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), 死んだサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
22 COLOR_LIGHT_GRAY 153, 153, 153 薄灰色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), ストラクチャーブロック, ジグソーブロック
23 COLOR_CYAN 76, 127, 153 青緑色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), プリズマリン (ハーフブロック, 階段, 塀)
24 COLOR_PURPLE 127, 63, 178 シュルカーボックス, 紫色 (羊毛, カーペット, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), 菌糸, コーラスプラント, コーラスフラワー, リピートコマンドブロック, ミズタマサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
25 COLOR_BLUE 51, 76, 178 青色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), クダサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
26 COLOR_BROWN 102, 76, 51 ダークオーク (木材, 原木, 樹皮を剥いだ原木, , 樹皮を剥いだ木, 看板, 感圧板, トラップドア, 階段, ハーフブロック, ハーフブロック, フェンス, ドア), マツ 原木 (side), 茶色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), ソウルサンド, コマンドブロック
27 COLOR_GREEN 102, 127, 51 緑色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), エンドポータルフレーム, チェーンコマンドブロック, 乾燥した昆布ブロック, シーピクルス
28 COLOR_RED 153, 51, 51 赤色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), レンガ (ハーフブロック, 階段, 塀), 赤色のキノコブロック, ネザーウォート, エンチャントテーブル, ネザーウォートブロック, ミレポラサンゴ (サンゴブロック, サンゴ, ウチワサンゴ)
29 COLOR_BLACK 25, 25, 25 黒色 (羊毛, カーペット, シュルカーボックス, ベッド (foot), 色付きガラス, 色付きガラス板, , 彩釉テラコッタ, コンクリート, コンクリートパウダー), 黒曜石, エンドポータル, ドラゴンの卵, 石炭ブロック, エンドゲートウェイ
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 ポドゾル, マツ (木材, 原木 (vertical), 樹皮を剥いだマツの原木, , 樹皮を剥いだマツの木, 看板, 感圧板, トラップドア, 階段, ハーフブロック, フェンスゲート, フェンス, ドア), オーク 原木 (side), ジャングル 原木 (side), 焚き火
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 黒色のテラコッタ

地図の色[編集 | ソースを編集]

上で述べた基本色に関連して、後述する4つの地図色がある。変換するには、R、G、Bそれぞれに、ある値を掛けて255で割る。最後に端数を切り捨てる。 As of 13w42b, the fourth base color variant is now multiplied by 135, providing a darker set of colors rather than just a clone of the second base color variant.

地図色ID RGBそれぞれの倍率
基本色ID×4 + 0 180
基本色ID×4 + 1 220
基本色ID×4 + 2 255(同一の色)
基本色ID×4 + 3 135
ファイル:Map Colour Shades.png
All the different shades of each color, excluding water

Map Pixel Art[編集 | ソースを編集]

ファイル:Map Pixel Art Train.jpg
Redstonehelper uses the staircase method in survival

People have used the map to create pixel art. The default map has an image size of 128×128 and will read each block as a specific color. By placing blocks in a specific arrangement, it is possible to create pixel art images.

Two methods exist for creating map pixel art: flat and staircase. The flat method involves laying the pixel image across a flat surface, effectively creating a floor. The flat method is the easier of the two methods, but offers a smaller palette of only 51 colors. The staircase method offers 153 colors, but is much more complicated to use. In the staircase method, blocks are placed at different elevations to obtain specific color variations. A block’s color will be darker if placed at a lower elevation than the block north of it, or brighter if placed at a higher elevation than the block north of it.

With the flat method, the 2nd shade of each color group on the lists below can be used. For the staircase method, the first 3 shades of the color groups below can be used. The 4th shade can only be obtained with the use of an external tool.

1.12 Color Table[編集 | ソースを編集]

1.8.1でのカラー表[編集 | ソースを編集]

Note: The description may not list every possible block. Example: In 1.8.1, any block that uses colored wool can also use colored carpet or colored pane glass.

1.7.2 Color Table[編集 | ソースを編集]

Original Color Table[編集 | ソースを編集]

Code examples[編集 | ソースを編集]

この節はまだ書きかけであり、重要な情報が欠落している可能性があります。この項目に関する詳細情報で内容を拡充してみませんか?
ライブラリ名 言語 Link to Map-related code
MCModify Java Map.java
minecraftmap Python __init__.py
mcmapimg Python mcmapimg.py

歴史[編集 | ソースを編集]

この節は内容の更新を必要とします。
概要: Incomplete history, maybe
Java Edition Beta
?Notchが地図を初めて追加したときは、NBTフォーマットは用いられていなかった[1]
1.6?地図が追加された。
地図IDはunsigned short(無符号16ビット数、65,536未満)に制限されている[2]
Java Edition
1.1317w47aMaps ids are no longer shorts, but rather ints, as they are no longer based on damage values of the item.
idcounts.dat now uses an int instead of a short.
18w19aAdded DataVersion to saved map_<#>.dat. (idcounts.dat still doesn't have a DataVersion)
1.1419w02aAdded locked to saved map_<#>.dat.

脚注[編集 | ソースを編集]