Fix problems as a player

Most problems are explained in the SMAPI log. This page shows how to read it and what the usual causes are.

Read the log#

1. While the game is running, read the SMAPI console window.
2. To read it afterwards, open SMAPI-latest.txt in the game's error log folder. On Windows this is %appdata%\StardewValley\ErrorLogs.
3. Search for NpcHelper, the NPC's name, or the mod's name. Every problem names the mod, the file, and the setting involved.
4. To ask for help, upload the log at smapi.io/log and share the link.

NPC Helper 2 does not appear in the console#

• You must start the game through SMAPI.
• Check that the folder is Mods/NpcHelper and that manifest.json is directly inside it. A doubled folder (Mods/NpcHelper/NpcHelper/...) is the most common mistake.
• Check that Stardew Valley is 1.6 or later and SMAPI is 4.0 or later.

An NPC mod is not loaded#

• SMAPI lists mods it skipped and why. Look for the mod's name near the start of the log.
• The mod needs NPC Helper 2 installed. If it is missing or too old, SMAPI says so.
• The mod's folder must be directly inside Mods, with manifest.json directly inside the mod's folder.
• If the mod has an NPC listed in the summary with a problem, the NPC was rejected. The message says which file, line, and setting is wrong. Report it to the mod's author, with your log.

The NPC is not in the Social tab#

• The author can hide an NPC until you meet them.
• The NPC may not have been loaded. Check the summary in the SMAPI console.
• If the NPC is rejected, the log gives the reason. Report it to the mod's author.

The NPC has no image or looks wrong#

• A message such as No sprite image found means the mod is missing its main image. Report it to the author.
• Artwork that changes by place or season is chosen by the NPC's current location and the season. Check at a different place or season before reporting it.

The NPC disappears while kissing or at the wedding#

The mod's sprite sheet has an empty frame for that pose. NPC Helper 2 warns about it in the log and names the frame. Report it to the mod's author.

A translation does not apply#

1. The game language must match the translation's language.
2. The NPC mod must be installed as well.
3. The translation must be installed in a way NPC Helper 2 can find: as a content pack, or as the older kind of translation that goes into the NPC mod's own folder. See Install NPC mods and translations.
4. Read the NPC Helper 2 summary. It warns when a translation is for an NPC that is not loaded and suggests the NPC it probably meant.

Warnings about a mod's folders#

A warning about a misspelled folder or file (such as NPCs, locale, or Dialogue.toml) is a mistake in the mod. It is not caused by your setup. Report it to the author.

Report a problem#

Include:

• The NPC Helper 2 version.
• The SMAPI log link from smapi.io/log.
• The name and version of the NPC mod.
• What you expected, and what happened instead.

Do not share your save files or unrelated personal information.