地图

Lua错误在Module:Autovalue_builders的第173行：attempt to index upvalue 'Autovalue' (a boolean value)

可再生	是
命名空间ID	见§数据值

地图（Map）是一种用于观看已探索地形的物品。

获取[]

合成[]

脚本错误：您必须指定要调用的函数。 脚本错误：您必须指定要调用的函数。 脚本错误：您必须指定要调用的函数。

箱子战利品[]

Java版：

物品	来源	物品数	堆叠数	几率	箱子数
空地图	沉船地图箱	0.08	1	7.69%	13.0
	要塞图书馆	0.11	1	10.89%	9.2
	村庄制图师小屋	0.92	1-3	46.21%	2.2

基岩版：

物品	来源	物品数	堆叠数	几率	箱子数
地图^[1]	沉船地图箱	0.08	1	7.69%	13.0
	要塞图书馆	0.11	1	10.51%	9.5
	村庄制图师小屋	0.92	1-3	46.21%	2.2

↑ ^1.0 ^1.1 在基岩版中的物品名称为未知地图，但手持时更名为地图0，缩放等级为1:4。来自相同组的地图可堆叠；虽然不在相同组的地图看上去一样，但不可堆叠。

制图台[]

此特性为基岩版独有。

在制图台上可以使用一张纸以创建一个空地图，或者使用指南针配合以合成一个空定位器地图。

物品栏[]

此特性为基岩版独有。

在基岩版中，玩家在创建存档时可以选择是否携带一张地图生成。若创建超平坦存档，地图的缩放比例为³⁄₄（1:8）。

交易[]

新手级别的制图师村民会以7个绿宝石的价格出售1张空地图。

在Java版中，制图师村民会给予带有村庄英雄状态效果的玩家一张空地图。

用途[]

绘制地图[]

手持空地图按下使用键即可绘制地图，地图上显示的是玩家周围环境的俯视图。地图的上方是北，下方是南，左方是西，右方是东。地图不会以玩家创建地图时所处位置为中心点，而是将世界按一定的比例划分成一个个方格区域后，显示地图首次绘制时所处的区域。^[1]例如，玩家在某个区域内绘制新地图，然后按照地图移动一段距离后再绘制另一张新地图，这两张地图都是一样的，除非玩家走出第一张地图显示的区域，进入另一个方格区域后再创建新地图。

为了在地图上记录各地的地形，玩家在世界移动时必须手持该地图。地图只记录各地在玩家探索时的现状，如果世界发生了变化，玩家必须拿着地图重游该区域来更新地图。

地图只在主手拿着地图而副手没有拿着东西时才会显示正常大小。当玩家副手拿着地图，或副手槽拿着其他东西而在主手拿着地图时，会显示一个缩小版的地图。

一个椭圆形的指针指示出玩家在地图的位置，并会在玩家穿过地图地形时跟着移动。若玩家离开一个地图显示的区域，该玩家在地图上的指针会变为一个圆点。圆点只会沿着地图边缘移动来显示玩家的相对位置，并且玩家每远离地图中心半径320格，圆点就会缩小一次，直到它在地图上消失。在Java版中，只有其他玩家的物品栏里有一张当前地图的拷贝时，他们才能共同显示在这份地图上；在基岩版中，所有玩家都可以共同显示在地图上。当把地图放进物品展示框时，地图会显示一个代表展示框所在位置的绿色指针。

在下界绘制出的地图只会显示红灰相间的图案，并且玩家指针在下界会迅速旋转。末地的方向指示器能正常地运作。

在Java版中，当玩家在一个维度使用地图后离开该维度，地图会显示玩家位于该维度最后一刻的位置和方向。

在基岩版中，玩家可以在不同的维度中正常使用地图；对于定位器地图，玩家自身指针颜色会随玩家所处维度而改变（主世界为白色，下界为红色，末地为品红色）。主世界的地图在下界中会显示玩家所对应的主世界坐标和朝向^[2]；反之，下界的地图在主世界中也会显示对应坐标，但指针会不停旋转；主世界的地图在末地中会显示世界生成图，但指针能正常运作；^[2]下界的地图在末地中不能正常使用——地图有图案但是指针是不可见的；相似地，末地的地图在主世界和下界中都不能使用。

玩家可以在地面上建造俯视的大型像素画并绘制地图，将地图放进物品展示框作为自定义图画。一般建议锁定地图，防止像素画被破坏后地图图案会随之更新。参见地图物品格式#地图像素画。

地图显示[]

地图的每一像素对应世界里能改变大小的区域，它总是对准是8的倍数的X和Z坐标。一般而言，地图像素的颜色和对应区域里从天上看最常见的固体方块的颜色相配。目标区域的“少数方块”对像素的颜色没有影响，因此在比例小的地图，较小的特征是察觉不到的。

地图会以较浅的蓝色显示水下大约15格的地面，所以玩家会看见哪里的地势是升高的。当有陆地在水面上时上述不成立。世界的海拔愈高，地图上的颜色愈浅。即使玩家在地表下移动，地图仍会记录地表上的东西。

地图的大小是128×128像素，给予128×128至2048×2048方块（8×8至128×128 区块）的覆盖面，覆盖面取决于缩放等级。

一些相关的距离：128方块（8区块）是主世界玩家的更新半径。然而，在末地和下界是它的一半（64方块）。而且，1024方块是从下界传送门的最少主世界距离，你能在这里建造另一个下界传送门并预期能到达下界的一个新地方。这是穿过一个1:8地图的距离，也是1:16地图从中心到边界的距离。

玩家标记和位置指针[]

在Java版中，指示玩家的位置和方向的指针本身就会出现在任何地图里。但当玩家从末地通过命令以外的方式返回主世界后，或者当重载游戏后，其他维度的位置指针会暂时不可见，直至玩家携带地图返回所在的维度。^{[需要更多信息]}

在基岩版中，地图在合成时可以选择是否有标记。当地图在合成时没有使用指南针，就会合成出一个没有标记的“空地图”，否则会合成出一个带有标记的“空定位器地图”。玩家进入下界后，标记会变成红色，且在玩家移动时轨迹会与在主世界得保持一致；进入末地后则会变成紫色。如果在末地使用在主世界创建的地图，那么一个紫色的点会出现在玩家的出生点。

名称	合成材料	铁砧用法	描述
定位器地图	地图 + 指南针	修复和命名地图	仅基岩版。只使用纸合成的地图不会带有玩家标记；想要加入标记则要使用指南针。

脚本错误：您必须指定要调用的函数。

在基岩版中，制图台也能用于创建定位器地图，通过将指南针和纸、空地图或填充的地图组合而得。

比例缩小[]

名称	合成材料	铁砧用法	描述
地图或定位器地图（已缩小）	地图或空地图+纸	修复和命名地图	仅基岩版。使用8张纸会缩小地图。

可使用制图台以将地图的显示比例缩小，每次缩小仅需使用1张纸。

缩小细节[]

缩小比例在第一次绘制地图（缩放等级0）到最大的大小（缩放等级4）时起作用。

		缩放等级0	缩放等级1	缩放等级2	缩放等级3	缩放等级4

1像素代表		1个方块	2×2个方块	4×4个方块	8×8个方块	16×16个方块（1个区块）
地图覆盖范围为		128×128个方块	256×256个方块	512×512个方块	1024×1024个方块	2048×2048个方块
地图覆盖范围为		8×8个区块	16×16个区块	32×32个区块	64×64个区块	128×128个区块
用于合成的纸的总数量	在工作台和铁砧^[仅BE]上	-	8	16	24	32
用于合成的纸的总数量	在制图台上	-	1	2	3	4

地图在全部缩放等级总是对准一个网格，这表示不管地图原本的中心在哪里，缩小一个特定范围的任何地图都会有同样的中心点。确切而言，地图会对准地图的宽度（等级3是1024格）减64，在出生点创造的等级3地图会覆盖从-64到960的X和Z坐标。所有在这范围的地图会缩小到同样的坐标，保证它们在地图墙总是“校准”。

在无缩放的地图中，在X和Z坐标（0,0）上创建地图，标记会出现在地图正中央；而在缩放后的地图上，坐标（0,0）会出现在左上角的方格里。

对于原主机版而言，地图不能被缩放，但可以使用制图台以扩展大小。缩放等级为3的地图可以覆盖坐标从-512到+512的范围。这样做是为了能在经典或小型世界里只需使用1个地图，在中型世界里使用9个地图（X和Z坐标范围在±512到±1536）以及在大型世界里使用25个地图（X和Z坐标范围在±1536到±2560）就够了。

在Java版中，缩放等级可以在打开高级工具提示（F3 + H）后得知。工具提示会展示地图的缩放等级和比例。

复制[]

需要用到空地图和空定位器地图。复制后的地图是否有标记取决于用得是哪一种地图。

名称	合成材料	铁砧用法	描述
地图或定位器地图（已复制）	地图或空地图+指南针	修复和命名地图22	仅基岩版。一次只能合成一个。使用的地图必须为定位器地图，使用空地图无效。

可使用制图台以复制地图。

已探索与绘制的区域会被复制，新探索的区域也会在两个地图都出现。在创造模式，通过对物品展示框里的地图按选择方块能获得复制的地图（确保在选择方块时该地图不在物品栏里，否则该地图只会被移动到可用的快捷栏）。

合成材料[]

旗帜标记[]

此特性为Java版独有。

Banner marked map — 地图上的所有颜色的旗帜标记，以及一个带名称的标记

玩家可以在地图上创建旗帜标记。通过手持地图对着一个旗帜使用，地图便会留下一个旗帜标记。标记的颜色与旗帜的颜色一致。如果旗帜有自定义名称，那么地图上的标记也会带有名称。如果旗帜被破坏，那么在区块更新后地图上的标记会消失。

锁定地图[]

在制图台上使用玻璃板可以锁定地图。锁定后的地图内容不再有任何变化，复制该地图后获得的新地图也会被自动锁定。


锁定前的地图	锁定后的地图	地形变化后对地图的影响

音效[]

Java版：

字幕	字幕	分类	描述	命名空间ID	音高
	地图：绘制	玩家	绘制地图	`ui.cartography_table.take_result`	`subtitles.ui.cartography_table.take_result`

基岩版：

字幕	分类	描述	命名空间ID	系统音效类型	音高	音量	衰减距离	流	预载
	方块	绘制地图	`ui.cartography_table.take_result`	`ui.cartography_table.take_result`	0.8	1.0	16	否	否

数据值[]

ID[]

Java版：

名称	命名空间ID	本地化键名
空地图	`map`	`item.minecraft.map`
地图	`filled_map`	`item.minecraft.filled_map`

基岩版：

名称	命名空间ID	别名ID（BE）	数字ID	本地化键名
空地图	`empty_map`	`emptymap`	`516`	`item.emptyMap.name` `item.emptyLocatorMap.name`
地图	`filled_map`	`map`	`420`	`item.map.name` `item.map.exploration.monument.name` `item.map.exploration.mansion.name` `item.map.exploration.treasure.name`

数据值[]

在基岩版中，空地图使用下列数据值：

	DV	描述
	0	空地图
	2	空的定位器地图

物品数据[]

在Java版中，填充的地图有以下物品NBT数据：

tag：父级标签。

- Decorations：地图上显示的图标。在重新加载世界之前，删除或修改的图标不会被更新。
  - ：一个图标。
    - id：识别图标的随机唯一字符串。
    - type：要显示的地图图标的ID。
    - x：图标在世界上所在的X坐标。
    - z：图标在世界上所在的Z坐标。
    - rot：图标的旋转角度，范围从0.0到360.0，方向为顺时针。与图标纹理中的外观相比，旋转角度为0.0所显示的图标上下颠倒。
- display：物品显示属性。
  - MapColor：物品栏内地图纹理上的颜色。
- map：地图编号。
- map_scale_direction：地图缩放等级，仅在缩放地图时由内部使用，之后直接删除。如果强制设置此值，将改变工具提示中的比例尺和等级信息。
- map_to_lock：表示此地图是否已经锁定，仅在锁定地图时由内部使用，之后直接删除。如果强制设置此值，将改变工具提示中的锁定信息。

在基岩版中，填充的地图有以下物品NBT数据：

tag：父级标签。

- map_is_init：是否为创建世界时提供的初始地图。^{[需要测试]}
- map_uuid：地图的UUID。
- map_name_index：地图名称的索引。
- map_display_players：（可能不存在）地图是否显示玩家标记。
- map_scale：地图的缩放等级。值为0-3。
- map_is_scaling：地图是否经过缩放处理。

地图图标[]

地图图标的纹理文件（基岩版）

数字	文本ID	外观	目标	是否在物品展示框上显示
0	`player`	白色标记	玩家（地图上）	否
1	`frame`	绿色标记^[仅Java版] 物品展示框^{[仅基岩版]}	物品展示框	是
2	`red_marker`	红色标记	在下界中打开主世界地图后对应的坐标^{[仅基岩版]}	否
3	`blue_marker`	蓝色标记	其他玩家^{[需要验证]}	否
4	`target_x`	白色X	未使用	是
5	`target_point`	红色三角形	未使用	是
6	`player_off_map`	大白点	玩家在地图外，较近^[仅Java版]	否
7	`player_off_limits`	小白点	玩家在地图外，较远^[仅Java版]	否
8	`mansion`	林地府邸	林地府邸	是
9	`monument`	海底神殿	海底神殿	是
10 - 25	`banner_*`	16种颜色的旗帜^[仅Java版]	旗帜标记	是
26	`red_x`	红色X	埋藏的宝藏	是
27^{[新增：JE 1.21和BE 1.21.0]}	`village_desert`	沙漠村庄	沙漠村庄	是
28^{[新增：JE 1.21和BE 1.21.0]}	`village_plains`	平原村庄	平原村庄	是
29^{[新增：JE 1.21和BE 1.21.0]}	`village_savanna`	热带草原村庄	热带草原村庄	是
30^{[新增：JE 1.21和BE 1.21.0]}	`village_snowy`	雪原村庄	雪原村庄	是
31^{[新增：JE 1.21和BE 1.21.0]}	`village_taiga`	针叶林村庄	针叶林村庄	是
32^{[新增：JE 1.21和BE 1.21.0]}	`jungle_temple`	丛林神庙	丛林神庙	是
33^{[新增：JE 1.21和BE 1.21.0]}	`swamp_hut`	沼泽小屋	沼泽小屋	是
-		品红色标记	在末地中打开主世界地图后对应的坐标^{[仅基岩版]}	否
-		橙色标记^{[需要更多信息]}	其他玩家	是
-		黄色标记	未使用	否
-		青色标记	未使用	否
-		绿色三角形	这7种探险家地图^{[仅基岩版]}的目标结构。	是

要注意的是，即使玩家使用了NBT编辑器以在地图上加入更多的图标，Minecraft也只会显示玩家加载世界时列出的第一个。

成就[]

图标		成就	游戏内描述	实际需求（若异）	Xbox点数	奖杯（PS）
		地图房间 Map Room	将9块完全探索过的相邻地图放入3*3方块中的9个物品框^{[原文如此]}。	在墙壁上3×3摆放的物品展示框中放入9张完全探索过并且都相邻的地图。将其分别替换为定位器地图和发光物品展示框也可以正常获得成就。	40G	银杯

历史[]

关于“地图”的历史，请见各版本页面。

你知道吗[]

使用F1键能使玩家在手持地图时视线不被阻挡。
使用/give创造的地图能使用NBT来指明地图编号来变成任何地图。如果没有提供地图编号，地图会变成“未知地图”。
- 如果指定的地图编号大于当前创建过的地图的数量，地图也会变为“未知地图”，直到对应地图编号的地图被创建。
地图以自己的数据（.dat）档案和名字map_x.dat（x是地图编号）分开地储存，关于更多资讯，见地图物品格式。玩家能通过更改这个编号来组织他们的地图来适合他们，如果他们意外地在相同的地方创造地图，他们能删除额外的地图来保存他们制造的编号。
一些程序能被用于制作有图像和文字的自定义地图而不是真实的地图，很多人在冒险地图中使用这些来展示图像或讲述故事。
由于一张地图的所有复制品都链接到同一个文件，复制未完成的地图会使复制品在原本地图绘制时与它同步。因此，储存在箱子的复制品能作为远距离备份。