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: Oct 20th at 12:28 AM
Downloads: 2273
Follow Unfollow 73
Recommended download (for Vintage Story 1.21.0, 1.21.1 and 1.21.2 - 1.21.5):
MinimalMapping_v3.0.0.zip
1-click install
Minimal Mapping
Minimal Waypoints
Reduce waypoint clutter and reliance by controlling pin behaviour and optionally wiping player waypoints on login or death.
These options are configured via the server command namespace /minimalmapping waypoints.
- Allow or disallow pinning of waypoints (pinning is prevented when disabled).
- Optionally wipe a player's waypoints when they log in.
- Optionally wipe a player's waypoints when they die.
Minimal World Map
Restrict world‑map and mini-map usage and scope so players only reveal local areas unless expressly permitted by server settings.
Configure these behaviours via /minimalmapping worldmap.
- Disable the 'M' hotkey for opening the world map.
- Disable the 'V' hotkey for showing the coordinates HUD.
- Disable the mini‑map hotkey (F6) and control mini‑map visibility from the same namespace.
- Wipe a player's world map on login or on death (optional).
- Disable coordinates appearing when hovering over the mini‑map.
- Disable click‑and‑drag scrolling of the mini‑map.
- Configure minimum, maximum and default mini‑map zoom levels.
- Option to keep the mini‑map visible by default while still allowing players to hide it manually.
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 or remove a player from the feature's whitelist.
- /minimalmapping [feature] blacklist Show players currently on the feature's blacklist.
- /minimalmapping [feature] blacklist [playerName] Add or remove a player from the feature's blacklist.
- /minimalmapping worldmap worldmap-hotkey [on|off] Disable or enable the 'M' hotkey for the world map.
- /minimalmapping worldmap minimap-hotkey [on|off] Disable or enable the mini-map hotkey (F6).
- /minimalmapping worldmap wipe-at-login [on|off] Wipe the player's world map whenever they log in.
- /minimalmapping worldmap wipe-on-death [on|off] Wipe the player's world map whenever they die.
- /minimalmapping worldmap coordinates-hud [on|off] Allow or disallow the on-screen coordinates HUD for players.
- /minimalmapping worldmap coordinates-hover [on|off] Enable or disable showing coordinates when hovering over the mini-map.
- /minimalmapping worldmap minimap-scroll [on|off] Enable or disable mini-map scrolling.
- /minimalmapping worldmap zoom-min [0.25-12] Set the minimum mini-map zoom level.
- /minimalmapping worldmap zoom-default [0.25-12] Set the default mini-map zoom level.
- /minimalmapping worldmap zoom-max [0.25-12] Set the maximum mini-map zoom level.
- /minimalmapping worldmap force-minimap [on|off] Force the mini-map to be active by default.
- /minimalmapping waypoints pins [on|off] Allow or disallow pinning of waypoints.
- /minimalmapping waypoints wipe-at-login [on|off] Wipe a player's waypoints when they log in.
- /minimalmapping waypoints wipe-on-death [on|off] Wipe a player's waypoints when they die.
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* |
|---|---|---|---|---|---|---|
| 3.0.0 | 92 | Oct 20th at 12:28 AM | MinimalMapping_v3.0.0.zip | 1-click install | ||
|
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. This is a major update, moving from .NET7 to .NET8, and includes a full re-write of the Gantry MDK.
![]() | ||||||
| 2.3.4 | 134 | 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 | 114 | 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 | 235 | Jan 25th at 2:47 PM | MinimalMapping_v2.3.2.zip | 1-click install | ||
|
For the meme! | ||||||
| 2.3.1 | 156 | Jan 24th at 5:08 PM | MinimalMapping_v2.3.1.zip | 1-click install | ||
|
Linux messed things up again. | ||||||
| 2.3.0 | 61 | 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 | 311 | 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 | 114 | 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 | 155 | 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 | 432 | 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 | 318 | 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 | 151 | 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/ | ||||||
The fog of war feature is exactly what I've been looking for! I'm excited to see it come back someday :)
v3.0.0 has now been released.
For now, I have had to remove the fog of war effects. I'll come back to these in the future, and try to get it all working properly.
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.