Xaero’s Minimap & World Map Quick Guide

Xaero 的小地图（Xaero’s Minimap）与世界地图（Xaero’s World Map）是一对常见的导航类模组组合：小地图负责在屏幕角落持续显示周边地形与信息，世界地图提供可拖拽缩放的全屏探索地图，并且二者可以联动共享数据与航点体系。

建议同时安装两者：小地图用于战斗/跑图时的即时判断，全屏世界地图用于长距离规划、回溯路线、整理航点与大范围地形判断。

What You Get

Minimap Highlights

小地图默认保持原版风格，并支持方形/圆形、旋转/锁北、缩放、透明度、位置等大量自定义。它还支持洞穴模式（自动判断头顶是否为“实体屋顶”以显示地下/地表信息）、实体雷达（玩家/生物/掉落物等显示为点或图标）、死亡点自动航点、区块网格与史莱姆区块叠加、光照叠加等。

小地图还提供“公平竞技（Fair-Play）版本”，通常会禁用实体雷达与洞穴地图等更强信息能力，适合对 PVP 公平性要求较高的服务器。

World Map Highlights

世界地图提供“自写入”的全屏探索地图：你探索过的区域会逐步写入并可随时查看。地图支持类似在线地图的拖拽与滚轮缩放、地图导出（PNG）、脚印路径回放（Footsteps）、资源包适配、以及与领地/队伍类模组的显示与交互（例如在地图上显示声明区块、盟友玩家，甚至在支持的情况下直接在地图上 claim/forceload）。

它还能在同一服务器地址下维护多张地图实例，并提供地图选择/确认机制，避免多世界/多维度/子服务器导致的地图串写。

Keybinds

说明：以下为常见默认按键。所有按键都可以在游戏的 Controls/Keybinds 中修改；若与整合包冲突，以你本地按键设置为准。

Minimap Keybinds

• Y：打开小地图设置界面，用于调整显示、雷达、洞穴模式、叠加层等。
• Z：临时放大小地图，方便快速观察更远范围。
• N：创建新航点（Waypoint）。
• U：打开航点列表与管理界面（编辑/删除/排序/切换集合等）。

World Map Keybinds

• M：打开全屏世界地图。
• 鼠标拖拽：移动地图视角。
• 鼠标滚轮：缩放地图。

Core Workflows

Quick Navigation

跑图时遇到岔路或地形复杂：先用 Z 临时放大小地图确认方向；需要做远距离规划时按 M 打开世界地图，快速对齐目标大区域再继续移动。

Waypoint Routine

• 到达关键位置（家、矿洞入口、要塞、村庄等）先按 N 立刻打点。
• 定期用 U 整理航点：分组（Waypoint Sets）、统一命名规则、关闭过期航点显示，保持画面干净。
• 如果服务器允许传送且你有权限，小地图/世界地图通常可通过发送指令实现航点传送；遇到不可用时优先检查权限与指令配置。

Advanced Features

Cave Mode

洞穴模式适用于地下挖矿、洞穴探险与建筑内部导航。建议在服务器允许的前提下开启，并根据自己电脑性能适当调整地图细节与刷新策略；如果你发现洞穴显示不符合预期，优先去设置里检查洞穴模式开关与相关阈值（例如屋顶判定范围）。

Entity Radar

实体雷达可以把玩家/友军/敌对生物/动物/掉落物等显示为点或图标，适合找动物、找队友、定位危险目标。若你在 PVP 服务器游玩，注意服务器规则可能会限制该功能；同时若使用 Fair-Play 版本，实体雷达可能默认不可用。

Overlays (Chunk, Slime, Light)

• 区块网格：用于对齐红石/建筑、寻找区块边界。
• 史莱姆区块叠加：适合规划史莱姆农场。
• 光照叠加：适合检查刷怪条件与照明覆盖。

这些叠加层建议按需开启，避免信息过载；在性能较弱的设备上也可以只保留最常用的一两项。

Waypoint Sets & Sharing

航点集合（Sets）非常适合按“世界/维度/工程/任务线”分类管理，例如：Overworld-Base、Nether-Highway、End-Farm 等。

多人联机时，可以通过航点管理界面把航点信息分享给队友（聊天共享），减少口头报坐标的沟通成本。

Multi-World Handling

在大型服务器或带大厅/子服的环境中，世界地图可能会要求你确认当前使用哪张地图实例。这是为了防止不同世界写到同一张地图上。

实用建议：

• 若你确定服务器会频繁切换世界/子服，优先使用“手动确认”策略，避免误写。
• 如果服务器支持并且服务端也装了相关支持，使用“服务端控制/识别”的模式通常更省心。

Exporting Map

世界地图支持导出 PNG 图片。适合做据点规划、分享探索进度或备份关键区域。注意：超大尺度全量导出可能会失败或耗时很久，建议按阶段导出或只导出需要的范围（如果你的版本/设置提供范围选择）。

Performance & Compatibility

Performance Tips

• 同时使用小地图与世界地图时，通常让小地图复用世界地图生成的纹理能更省资源。
• 如果你发现卡顿，优先降低地图细节、关闭不常用叠加层（史莱姆/光照/复杂雷达），并检查是否开启了过多渲染项。

Common Issues

• 按键无效：多数情况是按键冲突，在 Controls/Keybinds 里重新绑定即可。
• 地图像是“重置/丢失”：多人服务器可能因为地址变化、多世界识别、或地图选择模式导致你当前选中了空白地图。通常数据并未删除，只需要在地图选择菜单里切回原来的地图实例。
• 航点不显示：优先检查当前航点集合、维度/子世界选择、以及是否被设置为隐藏。

Recommended Defaults

• 常驻开启：小地图、坐标显示（按需）、基础航点。
• 按需开启：实体雷达、洞穴模式、史莱姆区块、光照叠加。
• PVP 服务器：优先使用 Fair-Play 或手动关闭雷达/洞穴功能，避免违规。

Quick Cheat Sheet

• 小地图设置：Y
• 临时放大小地图：Z
• 新建航点：N
• 航点管理：U
• 小地图缩放：I / O
• 打开世界地图：M