概述

与许多其他小地图模组不同的是，Xaero 的小地图保持了原版 Minecraft 的美感，这有助于它成为游戏中更完美的补充。这也是第一个用于 Minecraft 的旋转方形小地图。

在各种自定义设置中，有圆形小地图选项和锁定小地图旋转（使用方向箭头代替）的单独设置。小地图可将周围实体（包括玩家、生物和物品）显示为带有自定义颜色的点或图标（通常为头像）。除默认指南针方向外，你还可以在小地图和游戏世界中放置自己的路径点。路径点能帮助你找到以前到过的地点或到达特定坐标，还可选择传送。小地图可显示周围地表和地下的方块（洞穴模式）。这些只是该模组的部分功能，还有更多。请阅读下面的“功能”部分，了解更完整的列表。

为遵守多人服务器规则，该模组有两个版本，即完整版和公平竞争版，后者是为公平的 PVP 而设计的。此模组为主客户端，在服务端安装可获得一些额外功能（如世界识别）。

如果你在安装任何模组时遇到困难，那么一些指南可能会对你有所帮助。

特性

• 原版 Minecraft 的外观；

• 包括自动在内的多种小地图尺寸选项；
  

• 多种缩放选项；

• 两种小地图形状选项：方形或圆形；
  

• 运行起来比很多小地图模组更流畅；
  

• 使用“更改位置”设置/屏幕，可将其放置在屏幕的任何位置。如果你愿意，甚至可以将其移动 1 个像素。在使用其他 UI Mod 时非常有用；

• 2 种方块颜色模式：原版使用原版 Minecraft 地图的颜色；而准确使用方块纹理和生物群系的颜色。你还可以使用单独的设置为原版模式启用生物群系颜色；
  

• 自定义按键绑定（默认为 Z）可暂时放大小地图，以便更好地观察四周。所有按键绑定都在原版控制菜单中。还有一些设置可用于控制小地图放大后的行为，例如将小地图居中或完全放大；
  

• 使用“地形深度”和“地形坡度”设置自定义地图阴影；

• 与 Xaero 的世界地图 兼容。默认使用世界地图 Mod 生成的地图纹理，而非生成自己的纹理。这样可提高使用这两个 Mod 时的性能；

• 可将小地图绑定到快捷栏中所需或要装备的物品上，从而限制你对小地图的访问。例如，在配置文件的任意位置添加 minimapItemId:minecraft:compass 即可将其绑定到指南针物品上。这样，除非你的快捷栏中有指南针或装备了指南针，否则不会显示小地图；

• 药水效果用于控制服务器/地图上的玩家使用小地图或其某些功能。在撰写本文时，存在以下药水效果：xaerominimap:no_minimap、xaerominimap:no_entity_radar、xaerominimap:no_waypoints、xaerominimap:no_cave_maps。这些效果默认为中性类型，但也可以在效果 ID 的末尾添加 _harmful 来指定有害类型，例如 xaerominimap:no_entity_radar_harmful；
  

• 被翻译为多种语言；包括中文！
  

• 锁定北方选项可阻止小地图旋转，并用箭头显示角色的方向；

• 通过自动洞穴模式，地表和地下均可显示。洞穴模式也应在建筑物内激活。你可以选择在你上方“固体屋顶 (solid roof)”的大小，该模组会检测它以激活洞穴模式。3x3 及以上大小的屋顶可以防止伐木时站在原木方块下激活洞穴模式；

• 路径点。数量几乎无限。可传送（需要传送聊天命令许可）。路径点会在游戏世界中呈现，并显示在小地图上。你可以隐藏所有或特定的路径点。按 B 新建路径点。按 U 列出所有路径点。在路径点列表中，你可以添加/编辑单个或多个路径点，对它们进行排序，查看其他子世界/维度的路径点等等；
  

• 局部路径点和全局路径点。为了清除屏幕上不必要的路径点，你可以创建局部路径点，与全局路径点不同，局部路径点受“最大路径点渲染距离”选项的影响。这样，你就可以为一个大的区域/地区设置一个全局路径点，并在该区域/地区内设置多个局部路径点。当超过最大渲染距离时，只有全局路径点可见；
  

• 路径点集合。你可以将路径点分类整理成路径点集合。你可以通过按键绑定快速切换当前路径点集合。所有按键绑定都在原版控制菜单中；
  

• 路径点分享。你可以在游戏聊天中与服务器上的玩家分享你的路径点。这可在路径点列表中完成（按 U 键）；
  

• 死亡地点。每次死亡都会自动创建一个骷髅头形状的路径点。旧的死亡地点会改为普通路径点，你可以使用“保留旧的死亡地点”设置禁用该功能；

• 显示 Open Parties and Claims 模组中的区块认领和盟友玩家；

• 可切换的区块网格。区块网格可显示区块的开始方块和结束方块；

• 可切换的史莱姆区块模式。可生成史莱姆的区块会以绿色叠加层标出；

• 自定义光照叠加层。你可以设置光照叠加层，若方块在自定义光照等级范围内（默认方块光照等级为 0 至 7），则会用自定义颜色标记该方块。默认设置用于查找可生成生物的方块。你可以将其用于任何用途；
  

• 多人游戏中的多世界检测。如果你在客户端和服务端都安装了小地图 Mod，那么每个服务器世界都会有一个单独的“子世界”路径点。否则，就会使用基于世界出生点的更不可靠的世界分隔方法。如果无法在服务端安装该模组，建议关闭只有一个“世界”的服务器的多世界检测。你可以通过路径点菜单（按 U 键）-> 选项界面来将其关闭；
  

• 在地图上以黄点显示生物。敌对生物和友好生物的颜色可以不同。也可显示为图标/头像。查看“实体雷达”设置；
  

• 在地图上以白点或玩家头像显示玩家。也可显示为图标/头像。查看“实体雷达”设置；

• 在地图上以红点显示物品。查看“实体雷达”设置；

• 将箭和物品展示框等所有其他实体显示为紫点。可在设置中禁用不同类型的实体。查看“实体雷达”设置；

• “实体雷达”设置中在小地图上显示实体名称的选项；

• 缩放绑定键（默认为 I 和 O）可有效更改缩放级别，以满足你的偏好或使用情况；

• 小地图下方的坐标；

• 小地图下方的当前生物群系名称。默认禁用，需要在模组设置（按 Y 键）中启用；

• 小地图下方的光照等级。也默认禁用，需要在模组设置（按 Y 键）中启用；

• 小地图下方的当前游戏时间。默认禁用。你可以选择 12 小时或 24 小时两种格式；

• 小地图下方的当前镜头角度。默认禁用；
  

• 用于在所有 UI 界面上隐藏/取消隐藏所有路径点坐标的设置。对视频流/视频很有用；

• 在下拉菜单中完全隐藏/取消隐藏所有提及的服务器地址的设置。默认设置为“部分”，这在大多数情况下可能已经足够好了。
  

• 更多设置。太多了，这里就不一一列举了。在游戏中按 Y 键打开设置并查看；

• 2 个模组版本：完整版和公平竞争版。完整版没有任何限制。公平竞争版不显示任何实体或洞穴地图，更适合与不使用小地图的人进行 PVP。

画廊

小地图

死亡地点

头像

夜晚

洞穴模式

其他鸣谢

翻译：

• 英语（Greg-21 和作者自己）；

• 法语（redeaththeshark）；

• 意大利语（Sporadicamente）；

• 西班牙语（Kryten）；
  

• 西班牙语（墨西哥）（Popocamonroy）；

• 西班牙语（阿根廷）（SrLokiToo）；
  

• 葡萄牙语（葡萄牙）（2002luis）；
  

• 葡萄牙语（巴西）（digo_br、Ademoon、DaDodger）；

• 中文（最新：Demonese 和 SolidBlock-cn）（旧：laxtiz & ZHIAI_APPLE）；

• 荷兰语（Neminem）；
  

• 波兰语（Rokador & GlowingWater）；

• 塞尔维亚语（TheThunderGod）；
  

• 德语（tails32、Mineclemi & Zerobeauty）；

• 克罗地亚语（Forcellrus、COMBOhrenovke）；
  

• 希腊文（VasilisGR）；

• 拉脱维亚语（Viesuliss）；

• 土耳其语（mastorus）；
  

• 捷克语（drewie）；

• 匈牙利语（m1a1）；

• 日语（sgs、graycat27）；
  

• 乌克兰语（SwEikil、ttrafford7 和 VladOliinyk，旧：German121314、olexn）；

• 丹麦语（sampa & droidquote）；
  

• 印尼语（YandiBanyuKarimaWaly）；
  

• 泰语（JasonCL）；
  

• 俄语（Hy60koshk）；

• 爱沙尼亚语（Madis0）。
  

你可以在这里为翻译工作献计献策：https://github.com/thexaero/xaero-minimap-translations

如果你想帮忙或有问题，请私信作者！

常见问题

为什么路径点传送对我不起作用？

这可能有很多原因。此模组会发送聊天命令将你传送到路径点，默认为 /tp @s x y z，因此需要适当的权限。原版 /tp 命令需要 OP 状态（启用作弊），但在安装了某些插件的非原版服务器上，也可为命令设置单独的权限。使用的命令可在小地图设置中通过“默认传送命令”选项进行更改，也可在路径点菜单中通过“传送聊天命令”选项按服务器进行更改。非原版传送命令通常不支持 @s 等选择器，因此可能需要从配置命令中移除。世界地图上的右键传送使用其自己的命令设置。你可以在常见问题下的世界地图说明页面中了解相关信息。

若路径点“传送”按钮被禁用，也可能意味着多种情况。最常见的原因是手动使用了来自非“自动”子世界但仍来自同一维度的路径点。若“自动”子世界不是某个世界应该自动选择的，那么请选择正确的子世界，然后在路径点菜单选项中使用“使子世界为自动”。这样就可以在两个子世界之间交换所有路径点数据，然后就可以传送到现在位于“自动”子世界中的路径点了。

若选择了“自动”子世界，但传送按钮仍处于禁用状态，则可能意味着该服务器/世界的传送功能已被手动禁用。检查路径点菜单选项中的传送选项。若已禁用，则只能通过游戏目录 -> XaeroWaypoints 中的服务器特定配置文件启用。作者建议你在编辑任何配置文件之前先退出 Minecraft。并不时进行备份。

为什么我的路径点不再显示特定服务器？

不要慌。它几乎肯定没有被删除。如果你使用的是世界地图 Mod，且它也已重置，那么请先恢复世界地图，然后再处理路径点。请阅读世界地图说明页面上的“为什么我的世界地图‘重置’了特定服务器？”。读完了吗？请继续阅读。

首先打开完整的路径点菜单。在游戏中按 U 键即可。如果 U 键不起作用，请查看原版控制菜单。查看右上角下拉菜单中列出的子世界。当前服务器地址下的所有路径点子世界都应在其中。如果这些子世界都没有你所在世界/维度的正确路径点，那么服务器地址很可能已经更改。在左上角的下拉菜单中找到旧的服务器地址，选中它并执行选项 -> 自动生成世界/服务器。现在你应该可以在右上角的下拉菜单中找到正确的子世界了。如果正确的子世界已经标有（自动），这意味着该子世界是为当前世界/维度自动选择的，那么就可以开始了。如果错误的子世界被标记为（自动），那么请继续阅读。

使用了世界地图模组？

自动选择错误子世界的最常见原因之一，是在多人游戏中错误使用了世界地图模组（自 1.6 版本起）。在确认之前，请确保你为当前世界选择了正确的地图。这会影响向你显示的路径点。选择地图的菜单在世界地图屏幕上，点击左下角的图标即可（除非默认打开）。如果适合你所在的服务器，可以考虑将地图选择模式更改为自动模式之一。

你当前确认的地图会影响小地图模组中哪些路径点子世界被视为自动（auto）。这使得每个创建的地图都有单独的路径点数据。在任何时候，你都可以进入路径点菜单（按 U 键），从右上角的下拉菜单中选择并查看任何非自动路径点子世界。你可以选择选项 -> 使子世界为自动，使当前确认的地图中的任何子世界为自动。

未使用世界地图模组？

错误的子世界被视为（auto）并因此被自动选择，这可能是由于服务器插件改变了原版指南针物品的行为，并干扰了模组的”多世界“检测（若你启用了该功能，默认为禁用）。在大多数这种情况下，指南针物品指向的是你的床，而不是全局出生点。若是睡在另一张床上导致路径点消失，那么再次睡在正确的床上应该会让一切恢复正常。

如果出现这种情况是因为添加了新的插件（若你无法删除该插件），那么下面是恢复路径点的方法：

1. 从路径点界面右上角的下拉菜单中找到正确的路径点”子世界“，它包含你当前维度所需的路径点。也许可以从主世界开始；
   

2. 使用选项 -> 使子世界为自动；
   

3. 对每个维度进行同样的操作（在操作前进入该维度！）；
   

4. 若是只有一个世界的简单服务器（没有中心/大厅世界，没有迷你游戏世界，没有创造模式剧情（creative plot）世界等），那么也可以关闭同一选项菜单中的”多世界检测“。如果需要的话，可以稍后再打开。
   

如有问题，请联系作者！

如何添加自己的实体图标或覆盖默认图标？

首先，请确保你在小地图设置 -> 实体雷达类别中启用了实体图标/头像，无论你将其设置为“总是”还是“玩家列表”。确保你知道如何显示它们。这些就是本节要介绍的图标。

从小地图模组 21.6.0 版本起，你可以通过制作资源包（或在自己的模组中包含所需资源），用自己的精灵（sprites）/图像覆盖实体显示的默认图标。除此之外，你还可以通过创建一个自己的简单模组或在现有模组中加入一些代码来添加或改进实体类型变体支持（同一实体类型的不同变体具有不同的图标）。虽然对于较简单的多变体实体类型（大多数实体类型）来说，这通常是不必要的。

默认情况下，小地图模组会使用绑定到实体的实体渲染器/模型渲染所有实体图标。这支持所有原版生物和一些简单的双足/四足生物，它们的模型都有易于识别的头部模型部分（头部、耳朵、鼻子等）。如果模组无法做到这一点，则会显示彩色圆点。

与覆盖图标相关的资源（assets）目录是 /assets/xaerominimap/entity/icon/。你可以在小地图模组的 jar 文件中找到该目录，并提取其中包含的文件/文件夹以供参考。该 jar 文件包含一个用于覆盖模组实体类型图标的示例文件 /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json。如果存在实体类型 example_mod:example_entity，该示例文件将与之对应。请阅读 example_entity.json 文件中的注释，了解其结构，以便创建与之类似的图标定义。

除此之外，/assets/xaerominimap/entity/icon/definition/minecraft/ 包含了几个原版实体类型的示例文件，这些示例文件可能需要关于默认实体类型变体支持的额外注释。默认情况下，实体的变体支持非常简单，实体类型变体 ID 只是实体的主要纹理资源位置。

如果在小地图配置文件中将“debugEntityVariantIds”选项设置为 true，那么新遇到的实体（变体）的变体 ID 将被显示在聊天和日志/控制台中。

从 21.8.0 版本起，你也可以配置自己的基于模型的渲染。请阅读 /assets/xaerominimap/entity/icon/definition/example_mod/example_entity.json 示例文件中的注释，了解你需要知道的所有信息。

如果你想了解自定义图标的实际应用或实际使用情况，不妨看看 babybluetit 的这个超棒项目：Xaero's Minimap - Modded Support ，1.18.2以上的版本可使用Icon Xaero's。

Xaero's Minimap - Modded Support
封面	截至 2022 年 1 月，该包支持 700 多个修改的实体！

发现漏洞？给作者发私信，作者会修复它！

你可以使用此模组制作视频。

作者允许在你的整合包中使用它，但必须满足以下条件：

• 只允许通过 CurseForge 或 Modrinth 对整合包进行货币化（包括在你的整合包描述中加入赞助商链接/横幅），除非作者书面允许你在其他地方进行货币化。请随时私信作者。作者更有可能给予你许可；
  

• 如果整合包在 CurseForge 和 Modrinth 之外发布，那么你必须向 CurseForge 和 Modrinth 之外的用户提供一个指向作者的模组官方网页的链接，以示对作者的信任；
  

• 整合包的名称和/或描述不得与作者的模组名称/描述相混淆；
  

• 如果作者已书面许可你在 CurseForge 和 Modrinth 之外对整合包进行货币化，那么，如果作者要求你这样做，你必须移除 CurseForge 和 Modrinth 之外的货币化。