Minecraft 迷你地图mod——Xaero's Minimap，这是一个方便的小地图mod，可以显示周围的实体，包括玩家、怪物和物品，还可以放置自己的路点等等。

一、核心特色

1.原生美学设计

• 保留原版《我的世界》视觉风格，无缝融入游戏体验。
• 首创旋转方形小地图，支持切换为圆形地图或锁定方向（通过箭头指示）。

2.动态信息显示

• 实体追踪：以自定义颜色圆点或头像图标显示玩家、生物、掉落物等。
• 多维度探测：支持地表及洞穴模式，实时渲染周围方块环境。

3.路径标记系统

• 自定义路标：在游戏世界和小地图同步显示，支持坐标导航与传送功能（可选）。
• 方向指引：除基本罗盘方位外，可保存关键位置便于回溯。

4.多版本适配

• 完整版：全功能体验。
• 公平竞技版（Fair-Play） ：专为PVP设计，遵守服务器规则。

---

二、⚠️ 重要警告

• 禁止与XaeroPlus同时使用：该第三方插件非官方合作，可能导致严重崩溃或无法追踪的漏洞，且据传与服务器破坏组织有关联，可能威胁服务器建筑安全。

三、下载链接：

四、技术说明

• 客户端为主：单机安装即可运行大部分功能。
• 服务端可选：安装后可启用额外功能（如世界识别）。

---

五、功能一览

📌 核心功能

1.原版风格适配

• 完美契合《我的世界》原版美术风格，提供沉浸式体验。
• 性能优化：相比同类模组运行更流畅。

2.高度自定义显示

• 尺寸与形状：支持自动调整大小，可选方形/圆形两种地图样式。
• 位置微调：可自由拖动至屏幕任意位置，支持1像素级偏移（兼容其他UI模组）。
• 颜色模式：
  • 原版模式（Vanilla） ：使用游戏地图默认配色，可选启用生物群系色调。
  • 精准模式（Accurate） ：直接采用方块纹理与生物群系真实颜色。

3.动态缩放与视角

• 默认按Z键临时放大地图，支持居中显示或完全缩略视图。
• 地形渲染：通过“地形深度”（Terrain Depth）和“地形坡度”（Terrain Slopes）自定义地图阴影效果。

---

🎮 交互与控制

1.快捷键绑定

• 所有键位均集成在游戏原生控制菜单中，例如：
  • B键：新建路标（Waypoint）。
  • U键：打开路标列表（支持批量编辑/排序/跨维度查看）。
  • I/O键：快速缩放地图。

2.物品绑定功能

• 可配置需手持特定物品（如指南针）才显示小地图，增强生存模式代入感。

3.多人游戏兼容

• 与Xaero's World Map联动：默认复用世界地图模组生成的地图纹理，提升性能。
• 服务器端控制：通过药水效果限制玩家功能（如禁用实体雷达/洞穴地图等），支持中立/有害两种效果类型（如xaerominimap:no_entity_radar_harmful）。

---

📍 路标系统（Waypoints）

1.智能路标管理

• 无限路标：支持传送（需权限），可隐藏或按最大绘制距离筛选。
• 分类存储：通过“路标集”（Waypoint Sets）分组，快捷键快速切换。
• 死亡标记：自动生成骷髅图标标记死亡位置，旧标记可转为普通路标。

2.共享与协作

• 直接在游戏聊天中分享路标给其他玩家（通过路标列表操作）。

---

🌍 环境与实体显示

1.多维度探测

• 洞穴模式：自动识别地下环境（可调整“屋顶”判定范围，避免误触发）。
• 区块网格：显示区块边界，史莱姆区块会标记绿色覆盖层。

2.实体雷达

• 敌对/友好生物：黄色圆点或头像图标（可自定义颜色）。
• 玩家/物品：分别显示为白色圆点/红色圆点。
• 其他实体（如箭、物品框）：紫色圆点（可单独禁用）。

3.信息叠加

• 可选显示坐标、生物群系名称、光照等级、游戏时间（12/24小时制）、摄像机角度等。

---

⚙️ 高级设置与版本差异

1.隐私与流媒体适配

• 隐藏路标坐标/服务器地址（默认“部分隐藏”）。

2.双版本设计

• 完整版：全功能无限制。
• 公平竞技版（Fair-Play） ：禁用实体显示与洞穴地图，适合PVP公平对抗。

3.多语言支持

• 已翻译为多种语言。

---

📝 使用建议

• 按Y键打开设置菜单探索全部功能（如光照覆盖层可自定义检测0-7级亮度，用于标记怪物生成点）。
• 服务器推荐安装服务端模组以实现多世界独立路标存储，否则依赖世界出生点判定（可靠性较低）。

---

六、常见问题解答（FAQ）

📍 路标传送功能失效问题

1.权限不足

• 默认使用/tp @s x y z指令传送，需满足以下条件：
  • 原版服务器：需开启作弊（OP权限）。
  • 插件服务器：需安装权限管理插件（如LuckPerms），并单独配置/tp指令权限。
• 自定义指令：
  • 全局修改：在模组设置中调整"Default Teleport Command" 。
  • 单服务器修改：通过路标菜单（U键）中的"Teleport Chat Command" 选项。
  • 注意：非原版指令可能不支持@s选择器，需手动移除。

2.传送按钮被禁用

• 子世界（Sub-world）冲突：
  • 若当前路标属于非自动选择的子世界（如手动创建的维度存档），需在路标菜单（U键）→ Options → 选择正确子世界并点击"Make Sub-world Auto" 同步数据。
• 服务器配置限制：
  • 检查路标菜单中的"Teleportation" 选项是否被禁用。若被禁用，需手动编辑配置文件：
  • 路径：游戏目录 → xaero/minimap（旧版为XaeroWaypoints）。
  • 建议：修改前退出游戏并备份文件。

---

🗺️ 路标突然消失问题

1.服务器地址变更

• 在路标菜单（U键）中：
  1. 左上角下拉菜单选择旧服务器地址。
  2. 点击Options → "Make World/Server Auto" 。
  3. 右上角下拉菜单检查标记为"(auto)" 的子世界是否恢复。

2.世界地图模组联动问题

• 错误的地图确认：
  • 在世界地图界面（左下角图标）确认当前地图选择是否正确，此操作直接影响路标显示。
  • 建议切换为自动地图选择模式（适用于多数服务器）。
• 子世界关联：
  • 已确认的地图会绑定对应的"(auto)"子世界，可在路标菜单中手动切换或通过"Make Sub-World Auto" 重置关联。

3.无世界地图模组时的解决方案

多世界检测干扰：若服务器插件修改了指南针行为（如指向床而非出生点），可能导致子世界识别错误。

修复步骤：

1. 在目标维度（如主世界）的路标菜单中，选择正确的子世界 → "Make Sub-world Auto"
2. 对每个维度重复操作。
3. 单世界服务器建议关闭"Multiworld Detection" （Options菜单）。

---

📮 技术支持

如按上述步骤仍未解决，可通过官方渠道联系开发者（附问题描述与日志文件）。

Mastodon（Twitter替代平台） : mas.to/@xaero96

总结：多数路标问题源于权限、子世界配置或服务器变更，通过菜单调整或文件编辑即可修复。

---

⚠️ 其他注意事项

• 配置文件安全：编辑前务必关闭游戏并备份xaero/minimap文件夹。
• 跨维度操作：切换维度后需重新绑定子世界。
• 插件冲突：若问题由新增插件引起，可尝试联系服务器管理员移除或调整插件配置。

---

🎨 自定义图标方法

📌 基础要求

1.启用实体图标显示

• 在模组设置 → "Entity Radar Categories" 中，选择以下任一模式：
  • Always：始终显示图标
  • Player List：按玩家列表显示
• 注意：若未启用，实体将以默认彩色圆点显示。

1. 通过资源包覆盖默认图标（v21.6.0+）

• 路径规则：
  在资源包中创建目录：

  /assets/xaerominimap/entity/icon/  

参考模组JAR内同名目录的文件结构（可提取示例文件）。

示例文件：example_mod/example_entity.json 定义了实体example_mod:example_entity的图标逻辑。

配置文件说明：

• 编辑JSON文件以指定：
  • 图标纹理路径
  • 实体变种（Variant）匹配规则
  • 模型渲染参数（v21.8.0+支持）
• 提示：开启debugEntityVariantIds选项可在聊天栏打印实体变种ID，便于调试。

2. 通过模组代码扩展变种支持

• 适用场景：
  需为复杂多变种实体（如不同纹理的同一生物）分配独立图标时。
• 实现方式：
  • 创建附属模组或修改现有模组，注册自定义变种逻辑。
  • 多数简单实体（如原版生物）无需此操作，模组已内置支持。

---

3.🛠️ 高级功能（v21.8.0+）

• 自定义模型渲染：
  通过JSON文件配置实体模型的特定部位（如头部、耳朵）用于图标生成。示例：为僵尸添加不同头盔图标的变种支持。
• 原版实体参考：
  查看/assets/xaerominimap/entity/icon/definition/minecraft/内的示例，了解原版生物的特殊变种处理。

---

4.🔗 实践案例

• 推荐资源包：
  Xaero's Minimap Modded Support 。提供大量模组生物图标预设，可直接使用或参考其实现方式。

---

5.⚠️ 注意事项

1. 优先级：资源包覆盖 > 模组内置逻辑。
2. 调试工具：开启配置文件的debugEntityVariantIds选项快速获取变种ID。
3. 兼容性：复杂模型实体可能仍需回退到圆点显示，需手动配置模型绑定。

总结：通过资源包或简单模组即可高度自定义小地图实体图标，兼顾易用性与扩展性。

---

🛡️ 如何禁用洞穴模式与实体雷达

1.服务器端安装模组

• 适用服务器：Forge/Fabric/Quilt
• 配置文件路径：服务器根目录 → config/xaerominimap-common
• 修改选项：直接禁用洞穴模式或实体雷达功能，需重启生效。

2.通过系统消息快速控制
在玩家登录时发送以下特殊字符串（无需服务器安装）：

• §f§a§i§r§x§a§e§r§o → 强制启用公平竞技模式（禁用洞穴模式+实体雷达）
• §x§a§e§r§o§w§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 → 重置所有消息标记

---

🌐 兼容原版客户端玩家

• 关键配置：
  编辑服务器端xaerominimap-common配置文件 → 禁用状态效果注册（避免阻止原版玩家加入）。
• 同步操作：对世界地图模组（Xaero's World Map）重复相同设置。

---

七、🎥 视频与整合包使用条款

1.视频制作

• 允许：自由录制包含本模组的视频，无需授权。

2.整合包分发

• 基础规则：
  • 仅允许通过CurseForge/Modrinth盈利（包括描述中的赞助链接）。
  • 其他平台盈利需书面授权（私信联系作者，通常会同意的）。
• 非官方平台分发要求：
  • 必须提供模组官方页面链接（供用户访问）。
  • 整合包名称/描述不得与官方模组混淆。
• 授权撤销权：若作者要求，需立即移除非CurseForge/Modrinth的盈利。

---

八、Xaero's Minimap 开发者信息

---

🌐curseforge原版链接：

https://www.curseforge.com/minecraft/mc-mods/xaeros-minimap

📢 关注开发者

• Mastodon（Twitter替代平台） : mas.to/@xaero96
  （获取最新开发动态和更新通知）

💖 支持开发者

• Patreon赞助: patreon.com/xaero96
  （您的支持将帮助模组持续优化与更新）

🙏 致谢

感谢所有使用者的喜爱与支持！

---

本文内容源于互联网搬运，仅限于小范围内传播学习和文献参考，如果有侵权与不实之处请第一时间联系我们删除。