MapDistanceFix
一款非常简单的 Minecraft 模组,用于修复地图上的玩家指示器,使其始终显示玩家的位置和朝向,即使在地图边界之外也是如此,从而让导航藏宝图和其他地图物品变得更加容易。
感谢大家达到 100 万次下载!!
为什么需要这个模组?
在原版 Minecraft 中,当你远离地图边界时,玩家指示器要么完全消失,要么显示为通用的“player_off_map”和“player_off_limits”装饰,且没有方向信息。此模组通过以下方式解决了这个问题:
- 将地图外的玩家装饰转换为常规玩家装饰
- 保持正确的旋转角度以显示你面朝的方向
- 确保玩家始终可见,以便更好地导航
功能特性
- 玩家始终可见:确保玩家图标在地图上始终可见,即使位于地图边界之外很远的位置
- 正确方向:显示玩家实际的朝向,而不是通用的地图外指示器
- 距离显示:显示玩家到地图中心或最近结构的距离,帮助你导航至目的地
- 可配置:通过 JSON 配置文件或使用 Cloth Config 在游戏内 GUI 自定义距离显示设置
- 游戏内命令:无需重启游戏即可重载配置并检查状态
- 仅服务端:如果模组已安装在服务端,则客户端无需进行任何修改
可选依赖项
- 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,可以通过以下步骤访问配置界面:
- 打开游戏菜单
- 点击“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 版本兼容
光影下距离文本显示异常
- 这是某些光影包已知的问题。距离文本背景可能呈现透明或故障效果。
- 如果这让你感到困扰,请在配置文件中或通过游戏内配置界面(如果安装了 Cloth Config)将
showDistance设置为false以禁用距离显示。
获取帮助
如果你遇到问题:
- 检查最新日志中的错误消息
- 验证 Fabric API 是否正确安装
- 尝试使用最少量的模组以隔离冲突
- 在 GitHub Issues 页面 报告问题
贡献
欢迎贡献!以下是你可以提供帮助的方式:
拉取请求 (Pull Requests)
- 遵循现有的代码风格和惯例
- 添加适当的注释和文档
- 提交前进行全面测试
- 如果添加了新功能,请更新 README
Bug 报告
- 使用 GitHub Issues 页面
- 包含 Minecraft 版本、模组版本和日志文件
- 描述重现问题的步骤
许可证
本项目采用 MIT 许可证授权。 你可以自由地在整合包中使用此模组而无需征得许可。但请不要在任何其他地方重新分发 jar 文件!
致谢
- mappings.dev 在查找合适函数方面提供了巨大帮助
- Fabric Team 提供了优秀的模组开发框架
- Minecraft 社区 提供了灵感和反馈
- 贡献者 帮助改进了此模组
由 MrErenK 用 ❤️ 为 Minecraft 社区制作
如有问题、建议或支持需求,欢迎在 GitHub 上开启 Issue!
有问题、整合包集成咨询、版本请求或快速反馈?请在 Discord 联系:@mrerenk
MapDistanceFix
A very simple Minecraft mod that fixes map player indicators to always show the player's position and direction, even when outside map boundaries, making it much easier to navigate treasure maps and other map items.
Thanks everyone for 1 million downloads!!
Why This Mod?
In vanilla Minecraft, when you're far from a map's boundaries, the player indicator either disappears entirely or shows as a generic "player_off_map" and "player_off_limits" decorations without directional information. This mod fixes that by:
- Converting off-map player decorations to regular player decorations
- Maintaining correct rotation to show which direction you're facing
- Ensuring the player is always visible for better navigation
Features
- Always Visible Player: Ensures the player icon is always visible on maps, even when far outside the map boundaries
- Correct Direction: Shows the player's actual facing direction instead of a generic off-map indicator
- Distance Display: Shows the distance from the player to the map center or to the nearest structure, helping you navigate to your destination
- Configurable: Customize distance display settings via a JSON config file or in-game GUI using cloth config
- In-Game Commands: Reload config and check status without restarting the game
- Server-Side Only: No client modifications required if the mod is installed on the server
Optional Dependencies
- Cloth Config - Enables in-game configuration GUI
- Mod Menu - Provides access to the config screen from the mod list
Both mods are optional. Without them, you can still configure the mod by editing the JSON config file directly or via in-game commands
Configuration
The mod creates a configuration file at config/mapdistancefix.json with the following options:
| Option | Default | Description |
|---|---|---|
showDistance |
true |
Enable or disable distance display |
showDistanceWhenOffMap |
true |
Show distance when the player is outside the map boundaries |
showDistanceInsideBoundaries |
false |
Show distance even when the player is inside the map boundaries |
showStructureDistances |
true |
Show the distance to the nearest structure in the map |
distanceFormat |
%dm |
Format string for distance (use %d for the distance value) |
useShortUnits |
true |
Use short format like "1.2k" for large distances |
shortUnitThreshold |
1000 |
Distance threshold (in blocks) for switching to short units |
In-Game Configuration
If you have Cloth Config and Mod Menu installed, you can access the configuration screen by:
- Opening the game menu
- Clicking "Mods" (added by Mod Menu)
- Finding "Map Distance Fix" in the list
- Clicking the configuration button
or if you don't have these mods, you can use commands:
Commands
/mapdistancefix config <config> set/reset/getor/mdf config <config> set/reset/get- Change configs in-game/mapdistancefix statusor/mdf status- Display current configuration settings/mapdistancefix reloador/mdf reload- Reload the configuration file if modified (no need to run if using /mdf config command)
Compatibility
- JAVA Compatibilty: Java 21 is required for Minecraft versions above 1.20.5, Java 17 is required for Minecraft versions above 1.19.3 till 1.20.1.
- Server Compatibility: Does not work on vanilla servers. But if the mod is installed on the server, its not required to install on the client.
- Other Mods: Should be compatible with most other mods that don't heavily modify maps.
Troubleshooting
Common Issues
Config screen not appearing
- Make sure you have both Cloth Config and Mod Menu (for fabric) installed
- Check that the versions are compatible with your Minecraft version
Distance text looks weird with shaders
- This is a known issue with some shader packs. The distance text background may appear transparent or glitchy.
- If this bothers you, disable the distance display by setting
showDistancetofalsein the config file or through the in-game config screen (if Cloth Config is installed).
Getting Help
If you encounter issues:
- Check the latest logs for error messages
- Verify that Fabric API is correctly installed
- Try with minimal mods to isolate conflicts
- Report issues on the GitHub Issues page
Contributing
Contributions are welcome! Here's how you can help:
Pull Requests
- Follow existing code style and conventions
- Add appropriate comments and documentation
- Test thoroughly before submitting
- Update README if adding new features
Bug Reports
- Use the GitHub Issues page
- Include Minecraft version, mod version, and log files
- Describe steps to reproduce the issue
License
This project is licensed under the MIT License. Feel free to use this mod in your modpacks without asking for permission. But please do not redistribute the jar files anywhere else!
Acknowledgments
- mappings.dev for the huge help with finding proper functions
- Fabric Team for the excellent modding framework
- Minecraft Community for inspiration and feedback
- Contributors who help improve this mod
Made with ❤️ by MrErenK for the Minecraft community
For questions, suggestions, or support, feel free to open an issue on GitHub!
Have a question, modpack integration inquiry, version request or quick feedback? Reach out on Discord: @mrerenk
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 Map Distance Fix
- 修复了 NeoForge 服务器初始化问题
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
AE2:一款流行的自动化与存储模组
模组
那是什么?一个 Waila/Hwyla 的分支。
评论 0
登录后参与评分
还没有评论,来抢沙发吧