ThreeOSeven Studios - 制图师小地图

307 Studios - Cartographer

更远探索，不会迷路。307 Studios - Cartographer 的 1.0.3 版本结合了主题地表地图与分层高程洞穴地图，并集成了智能导航路径、实时引导、面包屑轨迹、扩展雷达以及完整的路径点/恢复系统，适用于 Minecraft 26.2。

小地图包括地形颜色、坡度阴影、航向朝上与北朝上模式、多种缩放级别、已保存的小/中/大 HUD 尺寸、圆形/圆角方形/方形边框、按住以展开查看，以及坐标、生物群系、海拔、八方向/度数、游戏时间、天数、FPS 和光照等级等详细信息。

按下 M 键打开不暂停游戏的全面屏探索地图。已探索的地形会针对每个世界和维度分别保存。拖拽可平移，使用鼠标滚轮缩放，查看光标下的世界坐标，按 R 或 Home 键返回玩家位置。按 M 或 Esc 键关闭地图。在客户端合法获取未知地形数据之前，这些区域将继续被地图迷雾覆盖。

在地下时，Cartographer 会自动切换到玩家当前 16 格高度带对应的持续洞穴平面。通道地面与地表使用不同的着色和阴影，封闭的通道在后续重新扫描时会清除，HUD 会标示当前活跃的 Y 轴高度带。在全面屏地图上按 C 键可在“地表”和“当前洞穴高度带”之间切换。自动洞穴地图可在小地图设置选项卡中禁用。

按下 B 键在您的位置创建路径点，或在全面屏地图光标处按 B 键创建路径点。滚轮缩放现在可使用持久化的粗略瓦片达到每像素 8 格。您也可以右键点击全面屏地图来标记该位置。路径点支持名称、分组、注释、精确坐标、维度、颜色、图标、可见性以及本地/全局范围。它们的标记会显示在小地图和全面屏地图上。

按下 U 键打开可搜索的路径点和死亡点管理器。可按当前维度、所有维度、死亡历史或隐藏标记来过滤列表；按距离、名称或最近活动排序；然后编辑、显示/隐藏、设为目标或删除条目。Cartographer 会自动记录死亡点，默认保留最近 10 个。死亡点也可以转换为普通路径点。

选择“设为目标”后，将添加水平距离和垂直高度差标签，并在目标保持激活状态时，在两份地图上记录有意义的移动轨迹。实时引导还会报告罗盘方位，提示是继续前进、左转、右转还是掉头，以及玩家是否已到达目的地。目标在其他维度时，会显示该维度名称，而不是误导性的路线。轨迹会随目标重置，并限制为仅限本次会话的 512 个点。智能导航会在已探索的地表或洞穴高度上绘制一条独立的青白双色路线，避开未知地形和陡峭边缘，支持部分远程路线，并在玩家位置或探索地图变化时重新计算。

按撇号键（`'`）打开 Cartographer 设置。“小地图”、“HUD 与信息”、“性能”、“导航”和“预设”选项卡可调整地图形状、四种仪表主题、方向、尺寸、缩放、HUD 布局、读数、绘图工作量、智能路线、面包屑、雷达标签以及四种精心配置的设置方案。预设更改会暂存，直到点击“保存”；点击“取消”则不会更改已保存的配置。

实体雷达可区分被动、中立、敌对、Boss、己方伙伴、玩家和掉落物等已知且客户端已渲染的实体，范围限制为 256 格和 256 个实体。附近的实体和重要实体可在全面屏地图上显示标签。玩家和掉落物接触为单独选择启用，默认关闭。Cartographer 绝不请求隐藏实体。

控制

所有键盘控制均可在 **选项 → 控制 → 按键绑定 →
307 Studios - Cartographer** 下更改。

**小地图与常规控制**

• **M** — 打开或关闭全面屏地图。
• **H** — 显示或隐藏 HUD 小地图。
• **撇号（`'`）** — 打开 Cartographer 设置。
• **B** — 在当前位置打开路径点编辑器。
• **U** — 打开路径点管理器。
• **按住 Z** — 临时放大小地图。
• **等号（`=`）** — 放大。
• **减号（`-`）** — 缩小。
• **N** — 在航向朝上和北朝上之间切换。
• **左方括号（`[`）** — 循环切换圆形、圆角方形和方形。
• **右方括号（`]`）** — 循环切换小、中、大尺寸。

**全面屏地图控制**

• **左键拖拽** — 在已探索地形上平移。
• **鼠标滚轮** — 朝光标方向或远离光标方向缩放。
• **右键点击** — 在所选地图位置打开路径点编辑器。
• **B** — 在地图光标处打开路径点编辑器。
• **R** 或 **Home** — 将地图重新居中到玩家位置。
• **C** — 在地表与玩家当前洞穴层之间切换。
• **等号（`=`）** 和 **减号（`-`）** — 在地图光标处缩放。
• **U** — 从地图打开路径点管理器。
• **撇号（`'`）** — 从地图打开 Cartographer 设置。
• **M** 或 **Esc** — 关闭全面屏地图。
• 屏幕上的 **添加**、**列表**、**设置** 和 **返回玩家位置** 按钮
    为常用操作提供鼠标访问方式。

**路径点和备份列表**

• **左键点击** 条目以选中。
• **双击** 路径点进行编辑。
• 使用 **鼠标滚轮** 滚动较长的路径点或备份列表。
• 屏幕上的按钮用于处理添加、编辑、显示/隐藏、设为目标、
    删除、转移、备份、恢复、保存和取消。

小地图和全面屏地图共享一个持久化的地形缓存。受限的“最近优先”观察器仅从客户端已完全加载的区块中记录地表列和洞穴通道；制图过程绝不请求或生成未加载的地形。在成功获得缓存工作线程确认后，未变化的区块观察将被抑制；饱和或失败的工作会保留，并以原始的世界和维度标识进行重试。

路径点数据使用原子化、带版本号的保存和五个滚动备份。如果当前路径点文档损坏，Cartographer 会先保留无法读取的文件，再打开一个干净的集合。管理器的“备份”界面会验证并预览每个快照，并要求再次点击确认才能恢复。

管理器的“转移”界面可导出便携、人类可读的路径点 JSON。导入前，Cartographer 会验证每个条目，并预览新增、冲突、错误、死亡历史修剪和最终数量。可选择匹配的 UUID 是跳过、替换还是复制；在集合更改前需要二次确认。完整的带版本号的转移架构包含在每个发布版 JAR 内的 `WAYPOINT-TRANSFER-FORMAT.md` 文件中。

版本 1.0.3 是当前已完成的发布版。它包含更小的 HUD 尺寸预设、文字安全信息卡、高度感知雷达，以及忽略树木冠层的洞穴探测功能。

由 Geminiz1978 在 307 Studios 旗下创建。

这款独立 Minecraft 模组与 Mojang Studios 或 Microsoft 无关联，亦未获得其认可。