Map Distance Fix - Map Distance Fix 地图距离修复

MapDistanceFix

一个非常简单的 Minecraft Fabric 模组，修复了地图玩家指示器，使其即使在超出地图边界时也能始终显示玩家的位置和方向，让导航寻宝地图和其他地图物品变得更加容易。

为什么需要这个模组？

在原版 Minecraft 中，当你远离地图边界时，玩家指示器要么完全消失，要么显示为没有方向信息的通用“player\off\map”和“playerofflimits”装饰。这个模组通过以下方式修复了这个问题：

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

功能

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

可选依赖

• Cloth Config - 启用游戏内配置 GUI
• Mod Menu - 从模组列表提供对配置屏幕的访问

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

配置

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

游戏内配置

如果你安装了 Cloth Config 和 Mod Menu，你可以通过以下方式访问配置屏幕：

• 打开游戏菜单
• 点击“Mods”（由 Mod Menu 添加）
• 在列表中找到“Map Distance Fix”
• 点击配置按钮

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

命令

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

兼容性

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

故障排除

常见问题

配置屏幕未出现

• 确保你同时安装了 Cloth Config 和 Mod Menu（适用于 Fabric）
• 检查版本是否与你的 Minecraft 版本兼容

使用光影时距离文本看起来很奇怪

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

获取帮助

如果遇到问题：

• 检查最新日志中的错误消息
• 验证 Fabric API 是否正确安装
• 尝试使用最少的模组来隔离冲突
• 在 GitHub Issues 页面 报告问题

贡献

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

拉取请求

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

错误报告

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

许可证

本项目采用 MIT 许可证。

你可以随意在你的整合包中使用这个模组，无需请求许可。但请不要将 jar 文件重新分发到其他地方！

致谢

• mappings.dev 在寻找合适函数方面提供了巨大帮助
• Fabric 团队 提供了出色的模组框架
• Minecraft 社区 提供了灵感和反馈
• 贡献者 帮助改进这个模组

由 MrErenK 为 Minecraft 社区 ❤️ 制作

如有问题、建议或需要支持，请随时在 GitHub 上提交 issue！