NPC Map Locations is a Stardew Valley mod which shows the locations of NPC and farmers on the world map and on a minimap.
- Install the latest version of SMAPI.
- Install this mod from Nexus Mods.
- Run the game using SMAPI.
Open the in-game map to see the positions for all NPCs, horses, players, and buildings. The map supports custom locations and NPCs automatically.
While the map is open, press TAB (or Y on a controller) to show the mod options. You can
show/hide characters automatically based on various criteria (e.g. after they're talked to, when in
same location, within a certain distance, quests and/or birthdays, etc).
You can optionally enable a minimap. You can move it by holding CTRL + right-click on the minimap,
then dragging it to the new position.
See the author guide for more info.
The mod creates a config/global.json file in its mod folder the first time you run it, and a
separate file for each save. You can open those files in a text editor to configure the mod.
These are the available settings (most configurable through the in-game menu except the key bindings and update rate):
| setting | what it affects |
|---|---|
NameTooltipMode |
The tooltip position when pointing at something on the map. You can cycle this in-game using the TooltipKey option below. Default 1. |
ImmersionOption |
Which NPCs to display. The possible values are All (all villagers), TalkedTo (villagers you talked to today), and NotTalkedTo (villagers you didn't talked today). Default All. |
ByHeartLevelHeartLevelMinHeartLevelMax |
Whether to only show villagers whose hearts with the player is between HeartLevelMin and HeartLevelMax. Default false, 0, and 12. |
OnlySameLocation |
Whether to only show villagers in the same location as the player. Default false. |
MarkQuests |
Whether to mark NPCs with quests or birthdays today. Default true. |
ShowChildren |
Whether to show player children on the map. Default false. |
ShowFarmBuildings |
Whether to show farm buildings on the map. Default true. |
ShowHiddenVillagers |
Whether to show villagers that would normally be hidden. Default false. |
ShowHorse |
Whether to show horses on the map. Default false. |
ShowTravelingMerchant |
Whether to show the Traveling Merchant when she's in the forest. Default true. |
NpcBlacklist |
The list of NPCs that should be hidden. Default empty. |
ShowMinimap |
Whether to show the floating minimap. Default false. |
MinimapXMinimapYMinimapWidthMinimapHeight |
The minimap's pixel position and size on screen, if it's enabled. Default x=12, y=12, width=75, height=45. |
MinimapExclusions |
Where the minimap should be disabled (not case-sensitive). Each value can be...
|
NpcExclusions |
NPC names to hide from the map. default empty. |
NpcMarkerOffsets |
Custom offsets when drawing vanilla NPCs. You generally shouldn't change this. |
MenuKey |
The key binding to open the options menu when on the map view. Default "Tab". |
TooltipKey |
The key binding to cycle the tooltip position when on the map view. Default "Space". |
MinimapToggleKey |
The key binding to toggle the floating minimap. Default "OemPipe" (i.e. the ` |
MinimapCacheWTicks |
The number of ticks between each minimap update. Default 15. |
NpcCacheTicks |
The number of ticks between each update to NPC markers. Default 30. |
-
Why do I see duplicate villagers on the map with UI Info Suite?
UI Info Suite has a feature to show villagers, so having it installed alongside this mod will show duplicate villagers. To continue using this mod, see the UI Info Suite options to disable its NPC tracking. -
Does the map work with map recolors and custom maps?
Yep. The mod doesn't change the world map itself, so it's compatible with all recolors and custom world maps. -
Does the mod support custom locations/NPCs?
Yep. For mod authors, see the author guide for more info on how this works.
Compatible with Stardew Valley 1.6+ on Linux/macOS/Windows, both single-player and multiplayer.
In multiplayer, the mod will only work if the host player has it installed.