概述

与多数小地图模组不同，Xaero 的小地图不仅保持了原版 Minecraft 的美感，还首次引入可旋转的方形小地图设计，这有助于它成为游戏中更完美的补充。

在各种自定义设置中，包含圆形小地图选项与锁定小地图旋转功能（箭头旋转替代地图旋转）。小地图可将周围实体（包括玩家、生物和物品）显示为带有自定义颜色的点或图标（通常为生物头像）。除默认指南针方向外，玩家可在小地图与游戏世界中放置路径点，以找回曾探索过的地点、抵达特定坐标或直接传送。小地图支持显示周围地表和地下的方块（洞穴模式）。

为适配多人服务器规则，本模组提供完整版与专为 PVP 公平性设计的公平竞争版。此模组以客户端为主，服务端安装后可获得一些额外功能（如世界识别）。

若安装模组时遇到困难可参考指南，更多功能请阅读下面的“功能”部分以了解更完整的列表。

基础功能

外观与使用

• 原版 Minecraft 的美术风格；

• 提供多种小地图尺寸选项，也可设置为自适应模式；

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

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

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

• 通过“更改位置”选项，可自由拖拽小地图至屏幕任意位置（甚至支持以 1 像素为单位进行精准微调），可有效解决第三方 UI 元素位置冲突问题；

• 为小地图提供“原版”（使用原版 Minecraft 地图的颜色）和“准确”（方块纹理与生物群系的颜色）2 种配色模式，还可为“原版”模式单独启用生物群系颜色；

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

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

地形渲染

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

• 自动洞穴模式支持地表与地下显示，并通过检测上方“固体屋顶 (solid roof)”在建筑物内自动激活， 3x3 及以上尺寸可避免伐木时因站在原木方块下方而意外触发。

路径点系统

路径点创建

• 按 B 键新建路径点，数量近乎无限；

• 会在游戏世界中呈现并显示在小地图上；

• 传送功能需服务器权限支持。

路径点管理

• 按 U 键打开路径点列表，可调整路径点顺序；

• 支持隐藏全部或指定路径点；

• 可添加/编辑单个或多个路径点；

• 支持跨维度查看（子世界/维度切换）。

分级显示系统

• 局部路径点：受“最大路径点渲染距离”选项的影响；

• 全局路径点：不受距离限制，始终可见；

• 可以为一个大的区域/地区设置一个全局路径点，并在该区域/地区内设置多个局部路径点。

死亡路径点

• 死亡时自动生成一个新的骷髅头形状的路径点；

• 旧死亡点自动转为普通路径点；

• 可使用“保留旧的死亡地点”功能保留历史记录记得删除浏览记录.jpg。

路径点集合

• 可以将路径点分类整理成路径点集合；

• 可以通过按键绑定快速切换当前集合；

• 所有按键绑定都在原版控制菜单中。

路径点分享

• 可以在游戏聊天中与服务器上的玩家分享你的路径点；

• 分享操作需在路径点列表界面完成（按 U 键）。

兼容与拓展

兼容性

• 兼容 Xaero 的世界地图，安装后默认使用世界地图生成的地图纹理（替代本模组原生纹理），可提升同时使用这两个 Mod 时的性能；

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

多人游戏多世界检测

• 双端安装时：客户端和服务端均安装小地图 Mod 时，每个服务器世界生成独立“子世界”路径点；

• 单端安装时：采用基于世界出生点的传统分隔方法（可靠性较低）；

• 建议：如果无法在服务端安装该模组，可关闭只有一个“世界”的服务器的多世界检测。你可以通过路径点菜单（按 U 键）-> 选项界面来将其关闭。

模组版本选项

• 完整版：无功能限制；

• 公平竞争版：禁用实体标记与洞穴地图显示，更适合与不使用小地图的人进行 PVP。

信息显示

实体信息

• 在地图上以黄点显示生物。敌对生物和友好生物的颜色可以不同。也可显示为图标/头像；
  

• 在地图上以白点或玩家头像显示玩家。也可显示为图标/头像；

• 在地图上以红点显示物品；

• 将箭和物品展示框等所有其他实体显示为紫点（可禁用不同类型的实体）；

• 可切换小地图上显示实体名称的选项；
  

• 可在“实体雷达”中查看所有设置。

界面信息

• 实时坐标；

• 当前生物群系名称（默认禁用）；

• 光照等级监测（默认禁用）；

• 当前游戏时间（12/24小时制，默认禁用）；

• 当前镜头角度（默认禁用）；

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

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

• 以上信息均显示在小地图下方，可在模组设置中进行详细调控（按 Y 键）。

高级设置

物品绑定系统

• 可将小地图绑定到快捷栏中所需或要装备的物品上，从而限制你对小地图的访问；

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

药水效果权限管理

• 药水效果用于控制服务器/地图上的玩家使用小地图或其某些功能；

• 在撰写本文时，存在以下药水效果：xaerominimap:no_minimap、xaerominimap:no_entity_radar、xaerominimap:no_waypoints、xaerominimap:no_cave_maps。这些效果默认为中性类型，但也可以在效果 ID 的末尾添加 _harmful 来指定有害类型，例如 xaerominimap:no_entity_radar_harmful。

自定义光照叠加层

• 玩家可以设置光照叠加层，若方块在自定义光照等级范围内（默认方块光照等级为 0 至 7），则会用自定义颜色标记该方块；

• 默认设置用于查找可生成生物的方块，玩家可以将其用于任何用途。

隐私设置

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

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

其他

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

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

画廊

小地图

死亡地点

头像

夜晚

洞穴模式

常见问题

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

权限与命令配置问题

这可能有很多原因，其中包括：

• 此模组默认通过发送聊天命令 /tp @s x y z 将你传送到路径点，因此需要玩家拥有对应权限；

• 在原版服务器中，执行 /tp 命令需具备 OP 状态（需启用作弊），但在安装了某些插件的非原版服务器中，也可为命令设置单独的权限；

• 非原版服务器的传送命令通常不支持 @s 等选择器，建议从配置命令中移除此类参数。

可通过以下方式更改命令格式：

• 在小地图设置中通过“默认传送命令”选项进行更改；

• 在路径点菜单中通过“传送聊天命令”选项按服务器进行更改。

世界地图的右键传送功能使用其自己的命令设置，相关信息可查阅常见问题中的世界地图说明页面。

子世界设置异常

若路径点的 “传送” 按钮被禁用，可能是由于以下情况：

• 手动选用了来自非 “自动” 子世界中的路径点，且该子世界与当前维度相同（最常见的原因）；

• 当前维度未正确绑定 “自动” 子世界。

解决方法：

1. 若“自动”子世界不是某个世界应该自动选择的，那么请在路径点菜单中选择正确的子世界，然后点击 “使子世界为自动”；

2. 此操作将同步两个子世界所有的路径点数据，随后就可以正常传送到现在位于 “自动” 子世界中的路径点了。

传送功能被手动禁用

若选择了“自动”子世界，但传送按钮仍处于禁用状态，则可能意味着该服务器/世界的传送功能已被手动禁用。

请检查路径点菜单中的传送选项：

• 若功能已禁用，则只能通过游戏目录 -> XaeroWaypoints 中的服务器特定配置文件重新启用；

• 在编辑任何配置文件之前请退出 Minecraft 并不时备份原文件，以避免数据丢失来自作者的忠告。

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

不要慌，它几乎肯定没有被删除。如果路径点未正确显示，请根据是否使用世界地图模组选择对应方案：

使用了世界地图模组？

恢复地图数据

• 如果世界地图模组已重置，那么请先恢复世界地图；

• 请阅读世界地图说明页面上的“为什么我的世界地图‘重置’了特定服务器？”。

检查路径点子世界

• 在游戏中按 U 键打开完整的路径点菜单（若不起作用，请查看原版控制菜单）；

• 查看右上角下拉菜单中的子世界列表，确认是否包含当前服务器地址下对应你所在世界/维度的路径点。

修正服务器关联

• 如果这些子世界都没有你所在世界/维度的正确路径点，那么服务器地址很可能已经更改；

• 在左上角下拉菜单选择旧服务器地址，选中它并执行选项 -> 自动生成世界/服务器，之后便可在右上角的下拉菜单中找到正确的子世界；

• 若正确的子世界标记为（自动），这意味着该子世界是为当前世界/维度自动选择的，服务器关联成功，否则需要继续排查。

校准地图选择

• 自动选择错误子世界的最常见原因之一，是在多人游戏中错误使用了世界地图模组（自 1.6 版本起），请进入世界地图界面，点击左下角图标确认当前地图与服务器匹配；

• 如果适合你所在的服务器，可以考虑将地图选择模式更改为自动模式之一。

手动绑定子世界

• 在绑定之前，请确定你为当前世界选择了正确的地图。这会影响小地图模组中哪些路径点子世界被视为自动（auto）——每个创建的地图都将拥有单独的路径点数据；

• 选择选项 -> 使子世界为自动，当前确认的地图将使所有子世界设置为自动。

未使用世界地图模组？

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

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

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

2. 依次进入各维度，分别使用选项 -> 使子世界为自动（在操作前进入该维度！）；

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

如有问题，请联系作者！

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

首先，请确保你已启用本节要介绍的实体图标：进入小地图设置 -> 实体雷达类别，将“实体图标/头像”设为“总是”或“玩家列表”。

覆盖默认图标的方法

创建资源包

• 从小地图模组 21.6.0 版本起，可通过资源包覆盖的方式，用自己的图像/精灵图（sprites）代替实体默认显示的图标；

• 支持在自定义模组中直接包含所需资源。

文件目录与结构

• 与覆盖图标相关的资源（assets）路径为 /assets/xaerominimap/entity/icon/；

• 可从本模组的 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 只是实体的主要纹理资源位置；

• 多数情况下无需额外代码支持。

自定义变体图标

• 可通过创建一个自己的、简单的模组，或在现有模组中添加代码实现；

• 21.8.0 版本新增功能：支持自定义基于模型的渲染（可参考 example_entity.json 中的注释）。

调试变体 ID

• 在小地图配置文件中将“debugEntityVariantIds”选项设置为 true；

• 新遇到的实体（变体）的变体 ID 将显示在聊天框与日志中。

如果你想了解自定义图标的实际应用或实际使用情况，不妨看看 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 之外的货币化。

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

鸣谢

翻译：

• 英语（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

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