Map Distance Fix

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

MapDistanceFix

一个非常简单的 Minecraft 模组，可修复地图上的玩家指示器，使其始终显示玩家的位置和朝向，即使玩家位于地图边界之外，也能更轻松地使用藏宝图和其他地图类物品进行导航。

感谢大家带来的 100 万次下载！

为什么需要这个模组？

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

将地图外的玩家装饰转换为普通玩家装饰
保持正确的旋转方向，以显示你面朝的方向
确保玩家始终可见，从而更便于导航

功能

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

可选前置

Cloth Config – 启用游戏内配置界面
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，可以通过以下步骤进入配置界面：

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

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

命令

/mapdistancefix config <config> set/reset/get 或 /mdf config <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 Team 提供了出色的模组开发框架
Minecraft Community 提供了灵感和反馈
Contributors 帮助改进这个模组

MrErenK 为 Minecraft 社区倾情制作 ❤️

_如有疑问、建议或需要支持，欢迎在 GitHub 上提交 issue！_

_有关于整合包集成、版本请求或快速反馈的问题？欢迎通过 Discord 联系：@mrerenk_