Map Distance Fix

MapDistanceFix

一款非常简单的 Minecraft 模组，用于修复地图玩家指示器，使其始终显示玩家的位置和方向，即使在超出地图边界时也是如此，大大简化了藏宝图和其他地图物品的导航。

感谢大家达成 100 万次下载！

---

为什么需要这个模组？

在原版 Minecraft 中，当你远离地图边界时，玩家指示器会完全消失，或显示为通用的“player_off_map”和“player_off_limits”装饰，且不包含方向信息。此模组通过以下方式修复了这个问题：

1. 将地图外的玩家装饰转换为常规的玩家装饰
2. 保持正确的旋转，以显示你面对的方向
3. 确保玩家始终可见，以便更好地导航

---

功能

• 玩家始终可见：确保玩家图标在地图上始终可见，即使在远离地图边界时也是如此。
• 方向正确：显示玩家实际面对的方向，而不是通用的离图指示器。
• 距离显示：显示玩家与地图中心或最近结构的距离，帮助你导航至目的地。
• 可配置：通过 JSON 配置文件或游戏内 GUI（使用 Cloth Config 图形配置库）自定义距离显示设置。
• 游戏内命令：无需重启游戏即可重新加载配置和检查状态。
• 仅服务端：如果模组安装在服务端，则客户端无需任何修改。

---

可选依赖

• Cloth Config 图形配置库 - 启用游戏内配置 GUI。
• Mod Menu 模组菜单 - 提供从模组列表访问配置屏幕的途径。

这两个模组都是可选的。如果没有它们，你仍然可以通过直接编辑 JSON 配置文件或使用游戏内命令来配置此模组。

---

配置

模组会在 config/mapdistancefix.json 创建一个配置文件，包含以下选项：

选项	默认值	描述
showDistance	true	启用或禁用距离显示
showDistanceWhenOffMap	true	当玩家在地图边界外时显示距离
showDistanceInsideBoundaries	false	当玩家在地图边界内时也显示距离
showStructureDistances	true	显示到地图中最近结构的距离
distanceFormat	%dm	距离的格式字符串（使用 %d 代表距离值）
useShortUnits	true	对较大的距离使用简写格式，例如 "1.2k"
shortUnitThreshold	1000	切换为简写单位的距离阈值（以方块为单位）

---

游戏内配置

如果你安装了 Cloth Config 图形配置库 和 Mod Menu 模组菜单，你可以通过以下方式访问配置屏幕：

1. 打开游戏菜单
2. 点击“Mods 模组”（由 Mod Menu 添加）
3. 在列表中找到“Map Distance Fix”
4. 点击配置按钮

或者，如果你没有安装这些模组，可以使用命令：

命令

• /mapdistancefix config <配置项> set/reset/get 或 /mdf config <配置项> set/reset/get - 在游戏中更改配置
• /mapdistancefix status 或 /mdf status - 显示当前的配置设置
• /mapdistancefix reload 或 /mdf reload - 重新加载配置文件（如果已修改）（如果使用 /mdf config 命令则无需运行）

---

兼容性

• Java 兼容性：1.20.5 以上版本的 Minecraft 需要 Java 21，1.19.3 至 1.20.1 版本的 Minecraft 需要 Java 17。
• 服务端兼容性：在原版服务器上不起作用。但如果该模组安装在服务端，则客户端无需安装。
• 其他模组：应与大多数不严重修改地图的其他模组兼容。

---

故障排除

常见问题

配置屏幕未显示

• 确保你已同时安装了 Cloth Config 图形配置库和 Mod Menu 模组菜单（适用于 Fabric）。
• 检查这些模组的版本是否与你的 Minecraft 版本兼容。

距离文本在使用光影时显示异常

• 这是某些光影包已知的问题。距离文本的背景可能会显示为透明或出现故障。
• 如果这个问题困扰你，可以通过在配置文件中将 showDistance 设置为 false，或通过游戏内配置屏幕（如果安装了 Cloth Config）来禁用距离显示。

获取帮助

如果你遇到问题：

1. 检查最新的日志以获取错误信息
2. 确认 Fabric API 已正确安装
3. 尝试使用最少的模组来隔离冲突
4. 在 GitHub Issues 页面 报告问题

---

贡献

欢迎贡献！以下是你可以提供帮助的方式：

拉取请求

• 遵循现有的代码风格和约定
• 添加适当的注释和文档
• 提交前进行彻底测试
• 如果添加新功能，请更新 README

错误报告

• 使用 GitHub Issues 页面
• 包含 Minecraft 版本、模组版本和日志文件
• 描述重现问题的步骤

---

许可证

本项目采用 MIT 许可证。你可以随意在整合包中使用此模组，无需请求许可。但请勿在其他地方重新分发 JAR 文件！

---

致谢

• mappings.dev 在查找合适功能方面提供了巨大帮助
• Fabric Team 提供了出色的模组开发框架
• Minecraft 社区 提供了灵感和反馈
• 贡献者们 帮助改进了这个模组

由 MrErenK 为 Minecraft 社区 ❤️ 制作

如有问题、建议或需要支持，欢迎在 GitHub 上提出问题或在 CurseForge 页面发表评论！