MapDistanceFix

A very simple Minecraft Fabric 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.

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, helping you navigate to your destination
• Configurable: Customize distance display settings via a JSON config file or in-game GUI
• In-Game Commands: Reload config and check status without restarting the game
• Client-Side Only: No server modifications required - should work on any server, but always showing the player outside the boundaries for player maps requires the mod to be installed in the server side.

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.

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
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:

1. Opening the game menu
2. Clicking "Mods" (added by Mod Menu)
3. Finding "Map Distance Fix" in the list
4. Clicking the configuration button

Commands

• /mapdistancefix reload or /mdf reload - Reload the configuration file
• /mapdistancefix status or /mdf status - Display current configuration settings
• /mapdistancefix clearcache or /mdf clearcache - Clear the map center cache

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:

1. Converting off-map player decorations to regular player decorations
2. Maintaining correct rotation to show which direction you're facing
3. Ensuring the player is always visible for better navigation.

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: Should work on any Minecraft server (vanilla, Fabric, Forge, Paper, etc.)
• Multiplayer: Compatible with multiplayer environments. For always showing players even outside boundaries, the mod needs to be installed on the server as well.
• Other Mods: Should be compatible with most other mods that don't heavily modify map rendering

Troubleshooting

Common Issues

Player decoration not showing

• Make sure you're looking at a map item, not just the world map

Config screen not appearing

• Make sure you have both Cloth Config and Mod Menu 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 showDistance to false in the config file or through the in-game config screen (if Cloth Config is installed).

Getting Help

If you encounter issues:

1. Check the latest logs for error messages
2. Verify that Fabric API is correctly installed
3. Try with minimal mods to isolate conflicts
4. 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

• 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!