Modding:Player Guide/Troubleshooting - Revision history

imported>Pathoschild: /* "Skipped '...' because it was blocked by Windows Smart App Control" */ update: can now re-enable it without a reset in newer updates

2026-04-11T19:09:25Z

"Skipped '...' because it was blocked by Windows Smart App Control": update: can now re-enable it without a reset in newer updates

← Older revision		Revision as of 19:09, 11 April 2026
Line 299:		Line 299:
	The mod was blocked by the optional "Smart App Control" feature in Windows 11, which tries to guess whether an app is safe. It tends to be inaccurate and often changes its mind from one moment to the next. Unfortunately, you [https://support.microsoft.com/en-us/windows/smart-app-control-frequently-asked-questions-285ea03d-fa88-4d56-882e-6698afdb7003 can't bypass it for a known valid app].		The mod was blocked by the optional "Smart App Control" feature in Windows 11, which tries to guess whether an app is safe. It tends to be inaccurate and often changes its mind from one moment to the next. Unfortunately, you [https://support.microsoft.com/en-us/windows/smart-app-control-frequently-asked-questions-285ea03d-fa88-4d56-882e-6698afdb7003 can't bypass it for a known valid app].

	Smart App Control is only enabled if you accepted to send "optional diagnostic data" to Microsoft during Windows installation. You can safely disable it anytime~~. However, '''disabling it is irreversible'''; you'll need to reset Windows if you want to turn it back on later~~.		Smart App Control is only enabled if you accepted to send "optional diagnostic data" to Microsoft during Windows installation. You can safely disable (and re-enable) it anytime.

	If you want to disable Smart App Control:		If you want to disable Smart App Control:

imported>Pathoschild: /* Other issues playing the game */ remove "Two copies of saves": issue with Get Glam, which has been incompatible since SDV 1.6.0

2026-03-19T22:22:01Z

Other issues playing the game: remove "Two copies of saves": issue with Get Glam, which has been incompatible since SDV 1.6.0

← Older revision		Revision as of 22:22, 19 March 2026
Line 474:		Line 474:
	# Open the in-game menu and go to the options.		# Open the in-game menu and go to the options.
	# Set the ''Gamepad Mode'' option to either ''Force On'' (if you use a controller) or ''Force Off'' (if you use a keyboard and mouse).		# Set the ''Gamepad Mode'' option to either ''Force On'' (if you use a controller) or ''Force Off'' (if you use a keyboard and mouse).

	~~==Two copies of saves==~~
	~~Try uninstalling Get Glam if you have it installed.~~

	==Pet event repeating over and over==		==Pet event repeating over and over==

	You probably have a pet named the same thing as an NPC in the game, most likely a modded NPC (both reported instances have been Stardew Valley Expanded NPC names). Save editing to remove your pet may help, but is tricky and difficult. Narrowing down the cause of this issue has been somewhat difficult. You can try naming the pet something other than the name of an NPC, or rejecting the pet, and see if that helps, but you may end up with multiple pets.		You probably have a pet named the same thing as an NPC in the game, most likely a modded NPC (both reported instances have been Stardew Valley Expanded NPC names). Save editing to remove your pet may help, but is tricky and difficult. Narrowing down the cause of this issue has been somewhat difficult. You can try naming the pet something other than the name of an NPC, or rejecting the pet, and see if that helps, but you may end up with multiple pets.

imported>Pathoschild: /* Other issues playing the game */ remove "Game resolution changes when launched with SMAPI (Windows only)": no longer applicable in newer versions

2026-03-19T22:20:10Z

Other issues playing the game: remove "Game resolution changes when launched with SMAPI (Windows only)": no longer applicable in newer versions

@@ Line 415: / Line 415: @@
 # [[#Game doesn't launch|Check the debugging options under "Game doesn't launch"]].
 # [[#NoAudioHardwareException:_Audio_has_failed_to_initialize| Check for a NoAudioHardwareException and follow instructions there]]
 ==Save disappeared or doesn't load==

imported>Pathoschild: /* Other issues */ split into three sections (installing SMAPI, launching game, and playing game)

2026-03-19T22:18:07Z

Other issues: split into three sections (installing SMAPI, launching game, and playing game)

Show changes

imported>Pathoschild: /* "Skipped '...' because it doesn't have a manifest.json" */ + mod managers often cause this error

2026-03-19T22:07:00Z

"Skipped '...' because it doesn't have a manifest.json": + mod managers often cause this error

← Older revision		Revision as of 22:07, 19 March 2026
Line 274:		Line 274:
	=Specific errors when loading a mod=		=Specific errors when loading a mod=
	=="Skipped '...' because it doesn't have a manifest.json"==		=="Skipped '...' because it doesn't have a manifest.json"==
	SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. ~~That usually means it~~'s not a SMAPI mod, so it won't work ~~from~~ the <code>Mods</code> folder. See ~~that~~ mod's documentation for install instructions.		SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder.

			Common causes:
			* It's not a SMAPI mod, so it won't work in the <code>Mods</code> folder. See the mod's page or documentation for install instructions.
			* The mod isn't installed correctly. Try deleting and reinstalling the mod to fix that. If you're using a mod manager like Vortex, try [[Modding:Player Guide/Getting Started#Install mods\|reinstalling the mod yourself]] instead.

	=="Skipped '...' because it was blocked by Windows Smart App Control"<span id="smart-app-control"></span>==		=="Skipped '...' because it was blocked by Windows Smart App Control"<span id="smart-app-control"></span>==

imported>Pathoschild: /* Specific errors when loading a mod */ + Skipped '...' because it was blocked by Windows Smart App Control

2026-03-19T22:03:43Z

Specific errors when loading a mod: + Skipped '...' because it was blocked by Windows Smart App Control

@@ Line 275: / Line 275: @@
 =="Skipped '...' because it doesn't have a manifest.json"==
 SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.
 =Other issues=

imported>Pathoschild: /* Specific error messages */ split into 'specific errors when launching game' and 'specific errors when loading a mod' for clarity

2026-03-19T21:51:19Z

Specific error messages: split into 'specific errors when launching game' and 'specific errors when loading a mod' for clarity

← Older revision		Revision as of 21:51, 19 March 2026
Line 156:		Line 156:
	</dl>		</dl>

	=Specific ~~error messages~~=		=Specific errors when launching game=
	=="Could not load 'Stardew Valley' or one of its dependencies"==		=="Could not load 'Stardew Valley' or one of its dependencies"==
	SMAPI wasn't able to load the game's executable. There's a number of possible reasons for this:		SMAPI wasn't able to load the game's executable. There's a number of possible reasons for this:
Line 227:		Line 227:
	* Use the [https://www.stardewvalley.net/compatibility/ Stardew Valley compatibility branch] (note that that [[#Known issues\|mods don't work with that version]] currently);		* Use the [https://www.stardewvalley.net/compatibility/ Stardew Valley compatibility branch] (note that that [[#Known issues\|mods don't work with that version]] currently);
	* ''or'' [[#SMAPI doesn't work with compatibility branch\|downgrade to Stardew Valley 1.5.4 or earlier]] (note that you'll need to use older versions of SMAPI and many mods).		* ''or'' [[#SMAPI doesn't work with compatibility branch\|downgrade to Stardew Valley 1.5.4 or earlier]] (note that you'll need to use older versions of SMAPI and many mods).

	~~=="Skipped '...' because it doesn't have a manifest.json"==~~
	SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.

	=="missing executable" (Steam only)==		=="missing executable" (Steam only)==
Line 274:		Line 271:

	If neither of those fixes works, it's not clear what to do.		If neither of those fixes works, it's not clear what to do.

			=Specific errors when loading a mod=
			=="Skipped '...' because it doesn't have a manifest.json"==
			SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.

	=Other issues=		=Other issues=

imported>Pathoschild: move "SMAPI takes forever to load" out of 'specific error messages', remove '!' from heading

2026-03-19T21:49:46Z

move "SMAPI takes forever to load" out of 'specific error messages', remove '!' from heading

@@ Line 260: / Line 260: @@
 * Make sure you have the latest Stardew Valley {{version|link=0}}, which is 64-bit and doesn't have the 32-bit limitations of older versions.
 * If you still get the error, you might need to remove content mods you don't need (particularly content packs for Custom Music, SAAT or TMXL Map Toolkit, which can use a lot of memory).
 ==NoAudioHardwareException: Audio has failed to initialize==
@@ Line 335: / Line 326: @@
 ==Save disappeared or doesn't load==
 See [[Saves#Troubleshooting]].
 ==(Linux only) Multiplayer menu doesn't load==

imported>Pathoschild: hide sub-sub-section headers from TOC to simplify navigation

2026-03-19T21:44:48Z

hide sub-sub-section headers from TOC to simplify navigation

← Older revision		Revision as of 21:44, 19 March 2026
Line 2:		Line 2:

	Did something go wrong with your game? This is the page for you. (This page isn't only for players who use mods!)		Did something go wrong with your game? This is the page for you. (This page isn't only for players who use mods!)

			{{TOC\|limit=3}}

	=The basics=		=The basics=

imported>Margotbean: edits from User:MaddyMelody

2026-03-14T19:04:09Z

edits from User:MaddyMelody

← Older revision		Revision as of 19:04, 14 March 2026
Line 335:		Line 335:

	==(Linux only) Multiplayer menu doesn't load==		==(Linux only) Multiplayer menu doesn't load==
	The issue is down to a faulty execstack call~~<ref name="Steam forums (Stardew Valley - General Discussions): How to fix Stardew Valley online~~ (~~coop loading forever) on linux (Debian 13) due to glibc library problem">~~[https ~~colon~~ //steamcommunity.com/app/413150/discussions/0/695372304943764421]~~</ref>~~ in the call-stack within these bundled libraries that are causing the multiplayer library to crash and thus the menu to never load.		The issue is down to a faulty execstack call (See [https://steamcommunity.com/app/413150/discussions/0/695372304943764421 Steam discussion]) in the call-stack within these bundled libraries that are causing the multiplayer library to crash and thus the menu to never load.
	To fix this:		To fix this:
	# Obtain a version of patchelf for your distribution, or from upstream (the NixOS/patchelf GitHub repository).		# Obtain a version of patchelf for your distribution, or from [https://nixos.org/patchelf.html upstream] (the NixOS/patchelf GitHub repository).
	# Then, open a terminal, and navigate to your Stardew Valley root folder.		# Then, open a terminal, and navigate to your Stardew Valley root folder.
	# Run <code>patchelf --clear-execstack libGalaxy64.so</code>.		# Run <code>patchelf --clear-execstack libGalaxy64.so</code>.