If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving forwards. Thank you.

Mods / Minimal Mapping
Author: Apache
Side: Both
Created: Jul 9th 2024 at 9:58 PM
Last modified: May 31st at 10:21 PM
Downloads: 2089
Follow Unfollow 69
Latest release (for Vintage Story 1.20.11, outdated):
MinimalMapping_v2.3.4.zip
1-click install
Minimal Mapping
Minimal Mini Map
Modifies the game's mini-map, with configurable zoom and HUD options to encourage more immersive play.
These options are all togglable via the server-side chat command, `/minimalmapping minimap`.
- Disable 'V' Key Binding
- Disable "Show Coordinates HUD" in Settings Menu.
- Disable coordinates being shown when hovering over the mini-map.
- Disable mini-map scrolling.
- User configurable minimum, maximum, and default zoom levels for the mini-map.
- Coordinates HUD disabled by default, and cannot be enabled.
- Mini-map visible by default, but can still be manually hidden by player.
Minimal Waypoints
Controls how waypoints behave on the server: restrict pinning and optionally wipe player waypoints on login to maintain a minimal navigation experience.
These options are all togglable via the server-side chat command, `/minimalmapping waypoints`.
- Toggle whether waypoints can be pinned.
- Wipe the players' waypoints whenever they log in.
- Wipe the players' waypoints whenever they die.
Minimal World Map
Limits and controls the world map's scope, key binding and visibility so maps reveal only local areas unless explicitly allowed by the server.
These options are all togglable via the server-side chat command, `/minimalmapping worldmap`.
- Disabled 'M' Key Binding.
- Wipe the player's world map whenever they log in.
- Limit the player's world map to only the immediate local area.
- Control the distance, in chunks, away from the player the world map will reveal.
Server Side Commands
A full set of server-side commands to configure minimal mapping features, manage whitelists/blacklists and adjust per-world or global behaviour.
- /minimalmapping gui Show the minimal mapping GUI, where all these options can be configured.
- /minimalmapping scope [global|world] Change whether the mod should use global, or per world settings.
- /minimalmapping [feature] mode [disabled|enabled|whitelist|blacklist] Change the mode for the given feature.
- /minimalmapping [feature] whitelist Show players currently on the feature's whitelist.
- /minimalmapping [feature] whitelist [playerName] Add/Remove a player from the feature's whitelist.
- /minimalmapping [feature] blacklist Show players currently on the feature's blacklist.
- /minimalmapping [feature] blacklist [playerName] Add/Remove a player from the feature's blacklist.
- /minimalmapping minimap hotkey [on|off] Disable the 'V' hotkey for showing the co-ordinates.
- /minimalmapping minimap hud [on|off] Disable "Show Coordinates HUD" in Settings Menu.
- /minimalmapping minimap hover [on|off] Disable coordinates being shown when hovering over the mini-map.
- /minimalmapping minimap scroll [on|off] Disable mini-map scrolling.
- /minimalmapping minimap min [0.125-12] The minimum zoom level for the mini-map.
- /minimalmapping minimap default [0.25-6] The default zoom level for the mini-map.
- /minimalmapping minimap max [0.125-12] The maximum zoom level for the mini-map.
- /minimalmapping minimap force [on|off] Force the map to be enabled, regardless of world settings.
- /minimalmapping waypoints pins [on|off] Allow/disallow the pinning of waypoints.
- /minimalmapping waypoints wipe [on|off] Wipe the player's waypoints whenever they log in.
- /minimalmapping worldmap hotkey [on|off] Disable the 'M' hotkey for showing the world map.
- /minimalmapping worldmap wipe [on|off] Wipe the player's world map whenever they log in.
- /minimalmapping worldmap fog [on|off] Limit the player's world map to only the immediate local area.
- /minimalmapping worldmap fog-radius [1-32] The distance in chunks away from the player the world map will reveal.
Important Notices
Unfortunately, I am unable to release mods for versions of the game that are pre-releases, or release-candidates. I work on updating all of my mods for compatibility, once the stable version of the game has been released. Please do not report any errors that occur while using this mod with untested versions of the game.
Each of my mods has a structured issue tracker system in place. Please do not report errors, crashes, bugs, or issues here on the mod page. Please use the issue tracker that is linked at the top of the page.


Mod Version | For Game version | Downloads | Released | Changelog | Download | 1-click mod install* |
---|---|---|---|---|---|---|
2.3.4 | 114 | May 31st at 10:21 PM | MinimalMapping_v2.3.4.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogFixed: 1.20.11 compatibility fix | ||||||
2.3.3 | 109 | Mar 21st at 2:05 AM | MinimalMapping_v2.3.3.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogFixed: 1.20.6 compatibility fix | ||||||
2.3.2 | 230 | Jan 25th at 2:47 PM | MinimalMapping_v2.3.2.zip | 1-click install | ||
For the meme! | ||||||
2.3.1 | 149 | Jan 24th at 5:08 PM | MinimalMapping_v2.3.1.zip | 1-click install | ||
Linux messed things up again. | ||||||
2.3.0 | 56 | Jan 23rd at 1:58 AM | MinimalMapping_v2.3.0.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogGame Version Update: Parity update for 1.20.1 | ||||||
2.2.2 | 304 | Sep 24th 2024 at 2:19 AM | MinimalMapping_v2.2.2.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogFIxed: It helps if you fix both patches! | ||||||
2.2.1 | 107 | Sep 24th 2024 at 12:48 AM | MinimalMapping_v2.2.1.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogFIxed: Added a patch for a compatibility issue where client-side code is being called on the server. Still trying to find the underlying problem.
| ||||||
2.2.0 | 147 | Sep 8th 2024 at 12:33 PM | MinimalMapping_v2.2.0.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogAdded: Waypoints - Wipe the player's waypoint whenever they log in.
| ||||||
2.1.0 | 424 | Aug 1st 2024 at 3:37 AM | MinimalMapping_v2.1.0.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogAdded: Chat commands to configure the options for each feature. Now works a lot like Knapster. | ||||||
2.0.1 | 306 | Jul 10th 2024 at 9:23 AM | MinimalMapping_v2.0.1.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogFixed: World Map still had hotkey | ||||||
2.0.0 | 143 | Jul 9th 2024 at 10:00 PM | MinimalMapping_v2.0.0.zip | 1-click install | ||
Support the Mod Author
If you find this mod useful, and you would like to show appreciation for the work I produce; please consider supporting me, and my work, using one of the methods below. Every single expression of support is most appreciated, and makes it easier to produce updates, and new features for my mods, moving fowards. Thank you.
ChangelogUpdated: v1.0 was released in 2021 https://www.vintagestory.at/forums/topic/4384-mod-request-mini-map-only-with-simpler-waypoints/ |
Amazing mod honestly Apache
Would be nice if possible to have json configuration in modconfig for those hardcore runs that end up often and violently as configuring map each time is a bit of a hassle (not much but a bit :) )
Also super small request, maybe i missed the option, but its no longer possible to move map around when enabled, by a mouse, could this also be an option?
I'm also not sure how to get default possibility of zooming out map. I know im probably taking half of mod out of my playthrough but I use it as advanced tool to just have fog of war to 1 chunk and pretty much nothing else :)
Amazing mod, i'd only wish Apache that it would be possible to reenable moving map by holding down mouse button as its disable in mod (I only want to have a fog of war and no memory of terrain but still have pins and ability to navigate by my own paths - sort of like real map scouting would work :), so scroll would be nice )
Hi Apache, thanks for your work! The worldmap fog feature is so niche but precisely what I was looking for for better immersion!
I take you as a bit of a mapping/cartography enthusiast from how you have not one but two map mods.
So with that said, how would you feel about integrating with Craftable Cartography and/or its two forks (rebalance and classic i.e. non-magitech, my personal fave)?
I volunteer to contact the respective authors myself if it would make more sense for them to at least provide config and command support first. Or I could try to make a "3-in-1 Craftable Cartography CLI" myself if accommodating other people's mods is outside of your intended scope. I'm somewhat of a modding noob but I've had some years in professional .NET and have dabbled in Harmony before (for a different game), including safely transpiler patching other mods' harmony patches.
Could write a proper GitHub ticket too, if you prefer.
I also have some Developer tier worthy funds available if that's a prerequisite for significant feature requests.
what does this mod even do?
like, does it add a fog of war to the map, till your close to the land, and could reasonably 'see' it?
or does it just not add every generated chunk to the map right away, and only shows areas you've actually been?
Algernon, you'd need to do `/minimalmapping worldmap mode disable` to get vanilla operation for the world map as well.
I apologise. I realise now that this is very confusing, you need to "disable" the feature to enable the map.
Apache I did `/minimalmapping waypoints mode disable` then restarted the server, checked that waypoints mode was set to disabled and the world map still cannot be click and dragged/panned.
The blacklist is not working either: worldmap and minimap's modes are set to blacklist, a player is added and they can still use the worldmap and minimap even after a server restart
Also thanks for this mod, its exactly what our server needed
update: the panning fixed itself after either changing the mode to blacklist or after a second restart, but the blacklist is still not working
Noden, does `/minimalmapping waypoints disable` not work? You may need to restart the server, I can't remember what patches are in place on the server for it.
Is there a way to re-enable the ability to pan on the world map? It doesn't seem to be configurable.
My goal for my server is to disable minimap and coordinates, but allow world maps and markers.
Any way you could disable the CTRL+F3 keybind? People in servers with directions turned off and using compasses are using that keybind to find out which way they're looking which kinda defeats the purpose
Is there any mods that implement ingame map? Like an item.
Jonathonsky,
Try with these settings:
/minimialmapping minimap hotkey off
/minimialmapping minimap hud off
/minimialmapping minimap hover off
/minimialmapping minimap scroll off
When I start a game the minimap is disabled and CTRL+V still brings up coordinates. Is that intended or am I getting an interference with another mod? I tried it back when there was limited mini map but now everything map related is disabled and options dont seem to change anything.
Would it be possible to make it so that instead of when logging in and out it resets the map on death? I have friends that say they can't handle playing the game without the map, but I want a more Wilderness Survival experience, and so having it happen on death would be very good. Especially if you could make it only trigger when you die without any temporal respawn charges left.
LielenBlue, at the moment, no. I'll need to add an option to disable the minimap, and the F6 hotkey. I'll do that this weekend.
hello, I just wanted to ask if you can disable the mini map but keep the big map with this mod? I read the information and it seems like thats possible?
when i return for 1.20 i cant wait to use this, for my server idea im going to set up :3. being able to disable world map, but keep mini will be nice =D
Apache there was a discussion on the discord about ways of doing something similar on the discord, and when your comment was brought up I just had to say - That sounds amazing, and as long as there is the ability to toggle certain features within that it would be amazingly useful!
A "limited local memory" is exactly what I would want for a limited-map vintage story game, where prospecting isn't made overly tedious... But you are still required to navigate manually as the map doesn't give you everything immediately
BanCannon, I've been looking into making the map reveal controllable, and found some interesting things. I can't simply change the radius around the player that the map reveals. At least, not easily at all, it will take a lot more experimentation for that. However, I may have found something even better. I can limit the radius around the player that the map reveals, however with the added side-effect that those are the only chunks that are rendered. The fog-of-war closes back in around the player on the map, removing chunks from the map that were visible before. I can also remove all a player's waypoints when they log out, so waypoints only exist for the current play session... or not, so you will end up seeing a bunch of waypoints in the middle of the blank map.
What do you think, is that useful? Does it go too far?
I like this concept a lot. Nice work. Just the right amount of limitations for me to feel more immersion without completely removing the map.
BanCannon, it's an interesting proposition. I've just had a look at the code for it, and it's all over the place. At first glance, I have no idea what controls what. But I'll keep digging, and experiment with a few options. I like the idea.
I've started a work item for it, here: https://github.com/ApacheTech-VintageStory-Mods/MinimalMapping/issues/2
Is it possible to modify the distance from player that the map is filled in as well? The default distance at which the map is filled in is so great that you can basically scout by UAV/Satillite. I would like to turn this down along with using the ability to disable X,Y,Z coordinates so that players have a functioning map of where they've been (finding your way back someplace you've been/marking findings in effect) but not so great that they use the map to scout.
It has been explained to me via discord that players maps being filled it directly related to their computer loading a chunk. I assume this means the functionality being asked about would be difficult to implement if even possible.
Vinter_Nacht, that will be the next step. I'm going to add a similar config system as Knapster, with the admin commands. It will allow me to go back and look at the whole settings sync, and see if I can pull it up to Gantry. I think this is the first "Quality of Life" mod I made that actively degraded the quality of life for the player. :P
I really like what you've done here. It gives you a sense of situational awareness (close-up map view) without storing a world map in your head. Could you make the minimum zoom range configurable? In case someone may want to lock it to 3 rather than allowing to change to 2 from 3.