File information

Last updated

Original upload

Created by


Uploaded by


Virus scan

Safe to use

About this mod

Shows the locations of NPC on the map page. Press TAB with the map open to access the mod menu for tooltip placements, immersion settings, and show NPC options.

Permissions and credits
Shows NPC locations on the map in real-time. Includes various settings to customize when to show NPCs.

For StardewValley v1.11 and SMAPI v1.6+
If you have issues, double-check that you have the lastest version of SMAPI.

Localization is still Work in Progress. The mod will not work perfectly for the StardewValley Localization Beta.


In the game folder that contains StardewValley.exe, you should also have StardewModdingAPI.exe and a Mods folder from installing SMAPI.
In your Mods folder, you should have a folder named NPCMapLocations
In NPCMapLocations folder, you should have at least two files; NPCMapLocations.dll, manifest.json.
You must run StardewModdingAPI.exe to load the game and use SMAPI mods.

Enabling Steam Achievements with SMAPI:

  1. In your game list, right click on Stardew Valley and click on Properties.
  2. Then click on SET LAUNCH OPTIONS... and in the text field, type:  StardewModdingAPI %command%
  3. This should run SMAPI when launching the game through Steam.
  4. The SMAPI contents must be in your SDV game folder for this to work. Otherwise, you have to put the path to your SMAPI contents in the launch options text field.

Open up the map from the game menu tab or by pressing "M." Use the TAB to open the mod menu.
If you want to change the open menu key, go to the config.json file and change the string value of menuKey.

Mod Menu Settings

Immersion Settings:
Always Show Villagers:

Shows everyone all the time.

Show Villagers Player Has Talked To:
Hides villagers the player hasn't talk to yet for the day.

Hide Villagers Player Has Talked To:
Hides villagers the player has talked to for the current day.

Only Show Villagers in Player's Location (toggle):
Hides Villagers who are not in the player's locations. NPCs inside of buildings will count as being in the respective location.

Only Show Villagers Within Specified Heart Level (toggle):
Hides Villagers who are not within the specified heart levels. Min and max are inclusive.
For example, if you only want to show NPCs with less than 4 hearts, set min to 0 and max to 3.
If you only want to show NPCs with at least 4 hearts but less than 11, set min to 4 and max to 10.

Extra Settings
- Show hidden villagers
Hidden Villagers will now be shown on the map with their markers dimmed. Hidden villagers will always be at the bottom of a stack.

- Mark NPCs with active daily quests or birthdays
Birthday NPCs will have a gift icon and Quest NPCs will have a ! icon. Marked villagers will always be at the top of a stack, unless hidden.

- Show traveling merchant
Will mark traveling merchant on the map when she is around.

- Show custom NPCs
Only shows up if custom NPCs are installed.

Include/Exclude villagers
Include or exclude which NPCs get shown. They will not show up even if "Show Hidden Villagers" is enabled.

Custom Configurations
In config.json, the villagers and any custom NPCs sprite crops for map markers can be adjusted.
How cropping works: 
You can change how the custom NPC's head is cropped to show up on the map by changing the number for villager or "crop" for custom NPCs. Setting it to 3 will move the NPC sprite 3 pixels, setting it to -3 will move the NPC sprite down by 3 pixels. It is set to 0 by default and will probably only need to be tweaked for custom NPC sprites that are particularly tall or short.

Find  "villagerCrop": { } and add villagers like so. This is the setting for this mod

"villagerCrop": {
    "Alex": 3,
    "Elliott": 2,
    "Harvey": 5,
    "Sam": 2,
    "Sebastian": 3

Custom NPCs
Find "customNPCs". There will already be an entry if you have custom NPCs installed. If it does not automatically generate an entry, then carefully make sure you installed the custom NPC correctly.

"customNPCs": {
    "Florence": {
        "id": 1,
        "crop": 0

Source code is available on Follow updates at