Immersive Minimaps
Most minimap mods plant a permanent square of terrain in the corner of your screen and never let go. Immersive Minimaps takes the opposite approach: the map only appears when it makes sense, and it disappears the moment it stops being useful. The result is a HUD that feels like part of the game rather than an overlay bolted on top of it.
This is a client-side addon built on top of Hoofprint, which itself runs on the Surveyor Map Framework. In practical terms, that means Immersive Minimaps renders the map data that Surveyor collects and Hoofprint manages, then hands it to you in a compact, unobtrusive overlay. If you have ever wanted map awareness without the clutter, this is the mod that delivers it.
How the Map Overlay Behaves
The core rule is simple and elegant. A minimap overlay displaying your surroundings becomes visible whenever you have a map in your inventory, including a map tucked inside a bundle. Lose the map, and the overlay vanishes. This single design decision changes how you play. You stop treating the minimap as a permanent crutch and start treating it as a tool you actually carry.
Because the overlay is tied to an item, it also opens up interesting inventory decisions. Do you keep a map in a bundle slot for quick reference, or leave it behind to free up space? Immersive Minimaps makes that choice matter, and it does so without adding menus or toggles you have to micromanage.
Supported Versions and Loaders
Immersive Minimaps is available for every version that Surveyor 1.0.0 has shipped for: 1.20.1, 1.21.1, 1.21.8, and 26.1. The mod is designed for Fabric, and Fabric API is required there. Neither Immersive Minimaps nor Hoofprint runs natively on NeoForge, but both work through Sinytra Connector, with Launchpad as an alternative path.
Dependencies matter here, so read carefully before you start. Hoofprint is mandatory. Versions 1.2.3 and above also require MRU. McQoy is recommended for configuring the mod, and Immersive Overlays is recommended if you want broader mod compatibility and richer HUD information.
Compatibility Notes
- Base mod supports Trinkets (Updated) only, for ease of maintenance.
- For modded backpacks and accessory mods, add Immersive Overlays so the mod can use its compatibility code.
- Immersive Overlays is also the recommended pairing for displaying additional information in the HUD.
If you are hunting for a build that matches your setup, search for a trusted source to download Immersive Minimaps and check the file list against your game version before grabbing anything. Players who prefer a guided setup can find Immersive Minimaps in the foxygame.net launcher, where the add-on catalog handles version matching and keeps everything updated without manual file shuffling.
How to Install Immersive Minimaps
Installation is straightforward once the dependencies are in place. Immersive Minimaps is a client-side mod, so you do not need it on a server.
- Confirm you are running Fabric for Minecraft 1.20.1, 1.21.1, 1.21.8, or 26.1.
- Install Fabric API and Hoofprint first.
- Add MRU if you are using version 1.2.3 or newer.
- Optionally add McQoy for configuration and Immersive Overlays for compatibility.
- Drop the Immersive Minimaps jar into your mods folder and launch the game.
That is the whole process for how to install the mod manually. If something misbehaves, check that every dependency matches your exact game version, since mismatched Hoofprint or MRU builds are the usual culprit.
Troubleshooting and Suggestions
Because Immersive Minimaps is an addon, the right place to report a problem depends on what is broken. Issues and suggestions about the minimap itself belong in the Immersive Minimaps issue tracker. Anything involving map sharing, explored map area, or automatic markers belongs with Surveyor, since that is where the underlying data comes from.
This distinction saves everyone time. The minimap is a rendering layer; Surveyor is the engine underneath it. Knowing which one owns your bug gets it fixed faster.
Final Thoughts
Immersive Minimaps earns its name. By tying the overlay to an item in your inventory, it keeps your screen clean while still giving you the spatial awareness you need. Pair it with Immersive Overlays, respect the dependency list, and you get one of the most thoughtful map experiences available for Minecraft. The Surveyor ecosystem is built to make mapping more accessible and open-source, and this mod is a fine example of that mission in action.