Xaero's Minimap - Xaero小地图

模组详细介绍

请勿将此模组与 XaeroPlus 一同使用！该模组与我无关，且会导致严重的、难以追踪的错误/崩溃。据称它还与一个服务器破坏团体有关联，这可能使你的服务器建筑面临风险。

与许多其他小地图模组不同，Xaero 的小地图保留了原版 Minecraft 的美学风格，这使其能更无缝地融入游戏。它也是 Minecraft 首个可旋转的方形小地图。在丰富的自定义设置中，有圆形小地图的选项，以及一个单独的锁定小地图旋转（使用方向箭头代替）的设置。小地图可以显示周围的实体，包括玩家、生物和物品，显示为自定义颜色的点或图标（通常是头像）。除了默认的罗盘方向，你还可以放置自己的路径点，它们会同时显示在小地图和游戏世界中。路径点帮助你找到之前访问过的地点或到达特定坐标，并支持可选的传送功能。小地图可以显示地面上下周围的方块（洞穴模式）。这些只是模组的部分功能，还有更多。请阅读下面的“小地图功能”部分以获取更完整的列表。为了遵守多人服务器规则，模组有两个版本：完整版和公平竞技版，后者专为公平 PVP 设计。此模组主要是客户端侧的。在服务器端安装是可选的，用于获得一些额外功能，如世界识别。

在 Mastodon（Twitter 替代品）上关注我？ mas.to/@xaero96

在 Patreon 上支持我？ 

patreon.com/xaero96

谢谢！

功能

• 保持原版 Minecraft 的外观。

• 多种小地图尺寸选项，包括自动调整。

• 多种缩放选项。

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

• 运行比许多小地图模组更流畅。

• 可通过“更改位置”设置/屏幕放置在屏幕上的任何位置。你甚至可以按 1 像素微调。在使用其他 UI 模组时可能很有用。

• 2 种方块颜色模式：原版，使用原版 Minecraft 地图的颜色；精确，使用方块纹理和生物群系的颜色。你也可以通过单独设置在原版模式中启用生物群系颜色。

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

• 通过“地形深度”和“地形坡度”设置自定义地图阴影。

• 与Xaero 的世界地图兼容。默认使用世界地图模组生成的地图纹理，而不是自己生成。这在使用两个模组时提高了性能。

• 服务器端配置，带有游戏内 UI 界面，可实时控制服务器上玩家如何使用该模组。你可以基于等级/权限（xaero.minimap.enforcedserverprofile）进行设置。支持 FTB Ranks、Odyssey Roles、LuckPerms 和通用权限 API。

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

• 药水效果，用于控制服务器/地图上玩家使用小地图或其部分功能。截至撰写本文时，存在以下药水效果：xaerominimap:nominimap, xaerominimap:noentityradar, xaerominimap:nowaypoints, xaerominimap:nocavemaps。 效果默认为中性类型，但你也可以通过添加 harmful 到效果 ID 末尾来指定有害类型，例如 xaerominimap:noentityradarharmful。

• 翻译成多种语言。

• 可锁定北方，停止小地图旋转，改为用箭头显示角色方向。

• 得益于自动洞穴模式，在地面上下均可工作。洞穴模式在建筑物内部也应激活。你可以选择模组搜索以激活洞穴模式的“固体屋顶”大小。3x3 及以上的屋顶大小应能防止在砍伐原木时站在原木块下激活洞穴模式。

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

• 本地和全局路径点。 为了清理屏幕上不必要的路径点，你可以创建本地路径点，与全局路径点不同，它们受“最大路径点绘制距离”选项影响。这使你可以在一个大的区域/地区设置一个全局路径点，并在该区域/地区内设置多个本地路径点。当你超出最大绘制距离时，只有全局路径点可见。

• 路径点集合。 你可以通过将路径点分类到集合中来组织它们。当前集合可以通过按键绑定快速切换。所有按键绑定都在原版控制菜单中。

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

• 死亡点。每次死亡时会自动创建一个骷髅形状的路径点。旧的死亡点会转换为常规路径点，你可以通过“保留旧死亡点”设置禁用此功能。

• 显示来自 Open Parties and Claims 模组的区块声明和盟友玩家。

• 可切换的区块网格。区块网格显示方块区块的起始和结束位置。

• 可切换的史莱姆区块模式。史莱姆可以生成的区块会用绿色覆盖层标记。

• 自定义光照覆盖层。你可以设置一个光照覆盖层，如果方块在自定义光照值范围内（默认为方块光照 0 到 7），则用自定义颜色标记它们。默认设置旨在寻找可生成怪物的方块。你可以将其用于任何目的。

• 多人游戏中的多世界检测。如果你在服务器端和客户端都安装了小地图模组，每个服务器世界应该获得一个单独的路径点“子世界”。否则，会使用基于世界出生点的可靠性低得多的世界分离方法。如果你无法在服务器端安装模组，建议为只有单个“世界”的服务器关闭多世界检测。你可以通过路径点菜单（按 U）-> 选项界面进行操作。

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

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

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

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

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

• 缩放按键绑定 （默认为 I 和 O），可高效更改缩放级别以适应你的偏好或使用场景。

• 坐标 显示在小地图下方。

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

• 光照等级 显示在小地图下方。同样默认禁用，需要在模组设置中启用（按 Y）。

• 当前游戏时间显示在小地图下方。默认禁用。你可以选择 12 小时制或 24 小时制格式。

• 当前摄像机角度显示在小地图下方。默认禁用。

• 设置可隐藏/显示所有 UI 界面中的路径点坐标。对直播/视频可能有用。

• 设置可完全隐藏/显示所有下拉菜单中提到的服务器地址。该设置默认为“部分”，在大多数情况下可能足够。

• 大量其他设置。太多无法在此一一列出。在游戏中按Y打开设置查看。

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

获取公平竞技版

获取 Xaero 的世界地图

常见问题

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

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

如果“传送”按钮被禁用，也可能意味着多种情况。最常见的原因是手动使用了来自“auto”子世界以外的子世界中的路径点，但仍来自同一维度。如果“auto”子世界不是某个世界上应自动选择的子世界，则在路径点菜单选项中选择正确的子世界并使用“设为自动子世界”。这将在两个子世界之间交换所有路径点数据，你将能够传送到现在位于“auto”子世界中的路径点。

如果“auto”子世界已选中但传送按钮仍被禁用，则可能意味着传送已为服务器/世界手动禁用。检查路径点菜单选项中的传送选项。如果已禁用，你只能通过游戏目录中的服务器特定配置文件启用 -> xaero/minimap（旧版本中为 XaeroWaypoints）。建议在编辑任何配置文件前退出 Minecraft。并定期备份。

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

不要惊慌。几乎肯定没有被实际删除。如果你使用世界地图模组且它也重置了，请先恢复它，再处理路径点。阅读世界地图描述页面上的“为什么我的世界地图在特定服务器上‘重置’了？”部分。完成了吗？请继续阅读。

首先打开完整路径点菜单。在游戏中按 U 进行操作。如果 U 键不起作用，请检查原版控制菜单。浏览右上角下拉菜单中列出的子世界。当前服务器地址的所有路径点子世界都应该在那里。如果它们都没有你当前所在世界/维度的正确路径点， 那么服务器地址可能已更改。在顶部左侧下拉菜单中找到旧的服务器地址，选择它并执行 选项 -> 设为自动世界/服务器。你现在应该能在右上角下拉菜单中找到正确的子世界。如果正确的子世界已标记为 (auto)，这意味着该子世界已自动为你当前的世界/维度选择，那么你应该没问题。如果错误的子世界标记为 (auto)，请继续阅读。

使用世界地图模组？

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

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

不使用世界地图模组？ 

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

如果这是因为添加了新插件（且移除它对你来说不可行），以下是如何恢复你的路径点：

• 在路径点屏幕的右上角下拉菜单中找到正确的路径点“子世界”，即包含你当前维度所需路径点的那个。也许从主世界开始？

• 使用 选项 -> 设为自动子世界。 

• 对每个维度执行相同操作（在执行前进入维度！）。

• 如果是一个简单的服务器，只有一个世界（没有大厅/休息室世界，没有小游戏世界，创造模式地块世界等），那么也在同一个选项菜单中关闭“多世界检测”。如果你以后需要，可以重新打开。

如有疑问，请联系我！

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

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

从小地图模组版本 21.6.0 开始，你可以通过制作资源包（或在你的模组中包含所需资源）来覆盖为实体显示的默认图标，使用你自己的精灵图/图像。此外，你还可以通过创建自己的简单模组或在现有模组中包含一些代码来添加或改进实体类型变体支持（同一实体类型的不同变体拥有不同图标）。尽管对于较简单的多变量实体类型（大多数实体类型）通常不需要这样做。

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

与覆盖图标相关的资源目录是 /assets/x