Xaero的小地图

不要将此模组与 XaeroPlus 一同使用！该模组与我无关，会导致无法追踪的严重错误/崩溃，且据称与一个服务器破坏团体有关联，可能危及您在服务器上的建筑。

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

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

在 Patreon 上支持我？patreon.com/xaero96

谢谢！

undefined

功能

• 原版 Minecraft 的外观。
• 多种小地图尺寸选项，包括自动设置。
• 多种缩放选项。
• 两种小地图形状选项：方形或圆形。
• 运行比许多小地图模组更流畅。
• 可使用“更改位置”设置/屏幕将小地图放置在屏幕上的任意位置。你甚至可以将其移动 1 个像素（如果你愿意）。在与其他 UI 模组一起使用时可能很有用。
• 两种方块颜色模式：原版模式，使用原版 Minecraft 地图的颜色；精确模式，使用方块纹理和生物群系的颜色。你还可以通过单独的设置在原版模式中启用生物群系颜色。
• 自定义按键绑定（默认为 Z）可临时放大小地图以更好地观察周围。所有按键绑定都在原版的控制菜单中。还有一些设置可控制小地图放大时的行为，例如将小地图居中显示在屏幕上或完全缩小。
• 通过“地形深度”和“地形坡度”设置自定义地图着色。
• 与 Xaero 的世界地图兼容。默认使用世界地图模组生成的地图纹理，而不是自己生成。这可以提高同时使用两个模组时的性能。
• 服务器端配置，带有游戏内 UI 屏幕，可让你实时控制服务器上的玩家如何使用该模组。你可以基于等级/权限 (xaero.minimap.enforced_server_profile) 进行配置。支持 FTB Ranks、Odyssey Roles、LuckPerms 和通用权限 API。
• 选项可将小地图访问限制在需要物品栏中的特定物品。例如，在配置文件中添加 minimapItemId:minecraft:compass 可将小地图绑定到指南针物品。这样，除非你在快捷栏或装备槽中拥有指南针，否则小地图将不会显示。
• 药水效果，可控制你服务器/地图上的玩家对小地图或其部分功能的使用。撰写本文时存在的药水效果有：xaerominimap:no_minimap、xaerominimap:no_entity_radar、xaerominimap:no_waypoints、xaerominimap:no_cave_maps。这些效果默认为中性类型，但你也可以通过在设计 ID 末尾添加 _harmful 来指定有害类型，例如 xaerominimap:no_entity_radar_harmful。
• 已翻译成多种语言。
• 选项可锁定北方向，以停止小地图旋转，转而用箭头显示你角色的方向。
• 得益于自动洞穴模式，可在洞穴内和地面上工作。洞穴模式也应在建筑物内激活。你可以选择模组搜索以激活洞穴模式的“实心天花板”大小。天花板大小 3x3 或以上应可防止你在砍树时站在原木下激活洞穴模式。
• 路径点。几乎无限数量。可传送至路径点（需要传送聊天命令的权限）。路径点在游戏世界中渲染并显示在小地图上。你可以隐藏所有或特定路径点。按 B 创建新路径点。按 U 列出所有路径点。在路径点列表中，你可以添加/编辑单个或多个路径点、排序、查看来自其他子世界/维度的路径点等等。
• 局部和全局路径点。为了清除屏幕上不必要的路径点，你可以创建局部路径点，不同于全局路径点，它们受“最大绘制距离”选项影响。这使你能够为一个大区域设置一个全局路径点，并在该区域内设置多个局部路径点。只有在超出最大绘制距离时，才可见全局路径点。
• 路径点集。你可以通过将路径点分类到集合中来组织它们。可以使用按键绑定快速切换当前集合。所有按键绑定都在原版的控制菜单中。
• 路径点共享。你可以在游戏聊天中与服务器上的玩家分享你的路径点。这通过路径点列表（按 U）完成。
• 死亡点。每次死亡时都会自动创建一个骷髅形状的路径点。旧的死亡点会转换为普通路径点，你可以使用“保留旧死亡点”设置禁用它们。
• 显示来自 Open Parties and Claims 模组的区块所有权和盟友玩家。
• 可切换的区块网格。区块网格显示方块区块的起始和结束位置。
• 可切换的史莱姆区块模式。史莱姆可以生成的区块会用绿色覆盖层标记。
• 自定义光照覆盖层。你可以设置一个光照覆盖层，当方块处于自定义光照值范围内时，用自定义颜色标记它们，默认方块光照范围是从 0 到 7。默认设置用于查找可生成怪物的方块。你可以将其用于任何目的。
• 多人游戏中的多世界检测。如果你除了在客户端还把小地图模组安装在服务器端，那么每个服务器世界都会获得一个单独的路径点“子世界”。否则，将使用一个不太可靠的世界分离方法，该方法基于世界出生点。如果你无法在服务器端安装该模组，建议对只有一个“世界”的服务器关闭多世界检测。你可以通过路径点菜单（按 U）-> 选项屏幕来完成。
• 在地图上将生物显示为黄色点。敌对和友好生物可以着色为不同颜色。也可以显示为图标/头像。请查看“实体雷达”设置。
• 在地图上将玩家显示为白色点或玩家头像。也可以显示为图标/头像。请查看“实体雷达”设置。
• 在地图上将物品显示为红色点。请查看“实体雷达”设置。
• 在地图上将所有其他实体（如箭和物品展示框）显示为紫色点。undefined不同类型的实体可以在设置中禁用。请查看“实体雷达”设置。
• 在“实体雷达”设置中，有在小地图上显示实体名称的选项。undefined
• 放大和缩小按键绑定（默认为 I 和 O），以便高效更改缩放级别以适应你的偏好或使用场景。
• 小地图下方的坐标。
• 小地图下方的当前生物群系名称。默认禁用，需要在模组设置中启用（按 Y）。
• 小地图下方的光照等级。默认也禁用，需要在模组设置中启用（按 Y）。
• 小地图下方的当前游戏时间。默认禁用。你可以选择 12 小时或 24 小时格式。
• 小地图下方的当前摄像机角度。默认禁用。
• 设置以隐藏/取消隐藏所有 UI 屏幕中的所有路径点坐标。可能对直播/视频有用。
• 设置以完全隐藏/取消隐藏下拉菜单中所有对服务器地址的提及。该设置默认为“部分”，在大多数情况下可能已足够。
• 更多设置。此处无法全部列出。请在游戏中按 Y 打开设置并查看。
• 2 个模组版本：完整版和公平游戏版。完整版没有任何限制。公平游戏版不显示任何实体或洞穴地图，更适合与不使用小地图的玩家进行 PVP。

论坛帖子 | 获取公平游戏版

获取 Xaero 的世界地图

常见问题

为什么路径点传送对我无效？

原因可能有很多。该模组会发送一个聊天命令将你传送到路径点，默认为 /tp @s x y z，因此需要适当的权限。原版 /tp 命令需要 OP 权限（启用作弊），但可以在安装了特定插件的非原版服务器上为命令设置单独的权限。使用的命令可以在小地图设置的“默认传送命令”选项中更改，或在每个服务器的路径点菜单的“传送聊天命令”选项中更改。非原版传送命令通常不支持 @s 这样的选择器，因此你可能需要从配置的命令中删除它。在世界地图上右键点击传送使用自己的命令设置。你可以在世界地图描述页面的常见问题中了解相关信息。

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

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

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

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

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

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

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

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

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

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

从小地图模组版本 21.6.0 开始，你可以通过制作资源包（或在你自己的模组中包含所需资源）来覆盖为实体显示的默认图标，使用你自己的精灵图/图片。除此之外，你还可以通过创建你自己的简单模组或在你现有模组中包含一些代码，来添加或改进实体类型变量支持（同一实体类型的不同变体拥有不同图标）。尽管对于较简单的多变量实体类型（大多数实体类型），这通常是不必要的。
默认情况下，小地图模组使用绑定到实体的实体渲染器/模型来渲染所有实体图标。这支持所有原版生物和一些简单双足/四足生物，这些生物的模型具有易于识别的头部模型部分（头、耳朵、鼻子等）。如果模组无法做到这一点，则会显示彩色点。

与覆盖图标相关的资源目录是 /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 的这个了不起的项目：https://www.curseforge.com/minecraft/texture-packs/xaeros-minimap-modded-support

如何在服务器上禁止使用洞穴模式和/或实体雷达？

为此，请在服务器端安装该模组（截至撰写本文时，需要 NeoForge/Forge/Fabric/Quilt 服务器）。

如果你的小地图版本至少为 25.3.0，请设置并使用“小地图服务器设置”按键绑定来打开服务器设置。你可以在此强制执行几乎所有选项，包括洞穴模式、实体雷达，甚至创建自定义实体雷达类别。

在较旧的模组版本上，当你启动服务器时，会在服务器目录（而不是世界文件夹）中创建一个新的“通用”配置文件，通常在“config”文件夹中。在配置文件中，你有多个选项可以禁用玩家的某些模组功能。更改需要重启服务器。

或者，如果你无法安装该模组，你可以在发送给玩家的服务器/系统消息（登录时）中包含以下字符串，这些字符串执行以下操作：

§f§a§i§r§x§a§e§r§o — 导致客户端禁用洞穴模式（包括世界地图）和实体雷达（公平游戏模式）

§x§a§e§r§o§m§m§n§e§t§h§e§r§i§s§f§a§i§r — 导致小地图洞穴模式在地狱中工作，尽管处于公平游戏模式。世界地图有一个单独的代码用于此，看起来几乎相同。

§n§o§m§i§n§i§m§a§p — 完全禁用小地图

§r§e§s§e§t§x§a§e§r§o — 重置所有系统消息标志

这里有一个第三方的 Spigot 插件可以简化你的操作（与我无关或由我创建）：XMMForceFairPlay
还有一个具有类似功能的第三方数据包（与我无关或由我创建）：Xaero 的服务器地图工具
使用任何第三方附加组件风险自负。

如何让原版客户端玩家加入我安装了模组的服务器？

在服务器目录（而不是世界文件夹）的 config 文件夹中查找“通用”配置文件，通常是 config/xaero/minimap。其中一个选项可以让你禁用状态效果的注册，这恰恰阻止了玩家加入。更改需要重启服务器。对世界地图模组也采取相同的操作。

对于开发者

要将你自己的模组接入此模组，首先将以下仓库添加到你的构建脚本中：

repositories {
    maven {
        url "https://chocolateminecraft.com/maven"
        name "Xaero's Maven"
    }
}

如果你使用 Forge，请确保你的项目中应用了 Mixin gradle 插件 (org.spongepowered.mixin)，除非你使用的是 1.12.2。

最后，添加以下一个或多个依赖声明，将 和 替换为你可以在 https://chocolateminecraft.com/maven/xaero/minimap 看到的具体值。

使用官方 Mojang 映射的 Forge（1.21.1 之前）：

implementation "xaero.minimap:xaerominimap-forge-<minecraft 版本>:<mod 版本>:dev"//故意不进行反混淆！

使用官方 Mojang 映射的 Forge（1.21.1 或之后）：

implementation "xaero.minimap:xaerominimap-forge-<minecraft 版本>:<mod 版本>"

使用其他映射的 Forge：

implementation fg.deobf("xaero.lib:xaerolib-forge-<minecraft 版本>:+")
implementation fg.deobf("xaero.minimap:xaerominimap-forge-<minecraft 版本>:<mod 版本>")

Fabric：

modImplementation "xaero.minimap:xaerominimap-fabric-<minecraft 版本>:<mod 版本>"

NeoForge：

implementation "xaero.minimap:xaerominimap-neoforge-<minecraft 版本>:<mod 版本>"

在多加载器设置中的“通用”项目中：

compileOnly "xaero.minimap:xaerominimap-common-<minecraft 版本>:<mod 版本>"

整合包及其他

允许使用此模组制作视频。

允许在整合包中使用，但需满足以下条件：

• 仅允许通过 CurseForge 或 Modrinth 对整合包进行盈利（包括在你的整合包描述中放置赞助链接/横幅），除非我已书面授权你在其他地方盈利。欢迎私信与我沟通。我更有可能给予你许可。
• 如果整合包在 CurseForge 和 Modrinth 之外分发，则你必须注明我的出处，为 CurseForge 和 Modrinth 之外的用户提供一个易于访问的指向我模组官方页面的链接。
• 整合包的名称和/或描述不得容易与我模组的名称/描述混淆。
• 如果我已经书面授权你在 CurseForge 和 Modrinth 之外对整合包进行盈利，那么，如果我要求你这样做，你必须移除 CurseForge 和 Modrinth 之外的盈利活动。