How do I update? Just run the new installer, it'll update previous files automatically.
Is it safe to update? There are no expected breaking changes. All mods which work with SMAPI 4.1should work with 4.2 too.
Feel free to report issues with SMAPI itself here, but issues with specific mods should be reported on those mods' pages instead.
I have issues with SMAPI on Android? This page is SMAPI for PC (Linux/macOS/Windows) and Steam Deck. This is not the page for SMAPI on Android; see the Android install guide for more info.
I used Vortex to install or update SMAPI, and it's not working or updating correctly. Vortex bypasses the SMAPI installer and often causes issues. Please do not ask for help with SMAPI issues here if you installed or updated it using Vortex.
Or install SMAPI directly instead, which often solves the issue. If you still have issues after doing installing it directly, feel free to comment below!
My antivirus reports a trojan or deletes SMAPI files? SMAPI most likely doesn't have a trojan; see SMAPI files disappear or antivirus complains for info on why your antivirus may be reporting it, how to check if it's safe, and how to install SMAPI when that happens.
When I launch the game, the console appears temporarily and then exits, or Steam briefly shows "playing"? See Game doesn't launch in the troubleshooting guide for help with that.
How do I ask for help? You can often get a faster response by asking the community instead. If you do ask here, upload your SMAPI log and add a link to your message. This has useful info like what versions you have, which mods are installed, what happened in the game, etc. Please do this even if you don't see an error in the log.
Hi! I've been playing Stardew Valley with SMAPI for over two years on the same setup. After updating to Stardew Valley 1.6 and SMAPI 4.2.1, I'm experiencing serious issues that never happened before.The game occasionally crashes to desktop with no visible error message from SMAPI, but the entire screen turns bright blue and overly saturated, almost like a broken display color LUT. Windows Event Viewer reports a crash in `coreclr.dll` (exception code `0xc0000005`), and sometimes even `dwm.exe` (the Windows Desktop Window Manager) crashes alongside it.Through testing, I found that the crashes do not happen at random — they occur during **specific mod-driven events**. These aren't mods that previously caused any problems — and the crashes seem to happen inconsistently depending on what’s happening in-game.I suspect these crashes are related to changes in how SMAPI 4.x handles .NET runtime, especially when mods use dynamic actions during events. Maybe something about memory access or UI handling has become less tolerant in .NET 6?I love SMAPI . I just wanted to share this because the new versions seem much more prone to hard crashes during mod event triggers, and it's been making the game hard to enjoy recently.Thanks so much for all your hard work.
ciao, per qualche motivo dopo aver installato smapi ho avuto alcuni problemi con il suo funzionamento, ad esempio non riesco a costruire e spostare gli edifici di robin e non riesco a posizionare i tesori nella biblioteca, qualcuno potrebbe aiutarmi?
Oops, couldn't find the game automatically. Type the file path to the game directory (the one containing 'Stardew Valley.dll'), then press enter. You must specify a directory path to continue.
After installing SMAPI, the game started to launch very slowly, about 2 minutes after the console message: Mods loaded and ready. In the game menu, it freezes when you click Load game, and when you select saving, it loads forever. Any ideas what this might be related to? Or what needs to be done?
[SMAPI] SMAPI 4.2.1 with Stardew Valley 1.6.15 build 24356 on Microsoft Windows 11 家庭中文版[SMAPI] Mods go here: D:\steam\steamapps\common\Stardew Valley\Mods[SMAPI] Some of the game's content files were modified or corrupted. This may cause game crashes, errors, or other issues.See https://smapi.io/reset-content for help fixing this.Affected assets: - XACT/Wave Bank(1.4).xwb (missing)[SMAPI] Waiting for game to launch...[game] Game.Initialize() caught exception initializing XACT.FileNotFoundException: Could not find file 'D:\steam\steamapps\common\Stardew Valley\Content\XACT\Wave Bank(1.4).xwb'.File name: 'D:\steam\steamapps\common\Stardew Valley\Content\XACT\Wave Bank(1.4).xwb' at Microsoft.Win32.SafeHandles.SafeFileHandle.CreateFile(String fullPath, FileMode mode, FileAccess access, FileShare share, FileOptions options) at Microsoft.Win32.SafeHandles.SafeFileHandle.Open(String fullPath, FileMode mode, FileAccess access, FileShare share, FileOptions options, Int64 preallocationSize) at System.IO.Strategies.OSFileStreamStrategy..ctor(String path, FileMode mode, FileAccess access, FileShare share, FileOptions options, Int64 preallocationSize) at Microsoft.Xna.Framework.TitleContainer.PlatformOpenStream(String safeName) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\Platform\TitleContainer.Desktop.cs:line 29 at Microsoft.Xna.Framework.TitleContainer.OpenStream(String name) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\TitleContainer.cs:line 37 at Microsoft.Xna.Framework.Audio.AudioEngine.OpenStream(String filePath, Boolean useMemoryStream) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\Audio\Xact\AudioEngine.cs:line 61 at Microsoft.Xna.Framework.Audio.WaveBank..ctor(AudioEngine audioEngine, String waveBankFilename, Boolean streaming, Int32 offset, Int32 packetsize) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\Audio\Xact\WaveBank.cs:line 113 at StardewValley.Game1.InitializeSounds() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 2348[SMAPI] Loading mod metadata...[SMAPI] Loading mods...[SMAPI] Loaded 3 mods:[SMAPI] Console Commands 4.2.1 by SMAPI | Adds SMAPI console commands that let you manipulate the game.[SMAPI] Save Backup 4.2.1 by SMAPI | Automatically backs up all your saves once per day into its folder.[SMAPI] Tractor Mod 4.22.2 by Pathoschild | Lets you buy a tractor to more efficiently work with crops, clear twigs and rocks, etc.[SMAPI] Launching mods...[SMAPI] Mods loaded and ready![game] The game failed to launch: NullReferenceException: Object reference not set to an instance of an object. at StardewValley.Audio.AudioCueModificationManager.ApplyCueModification(String key) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Audio\AudioCueModificationManager.cs:line 121 at StardewValley.Audio.AudioCueModificationManager.ApplyAllCueModifications() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Audio\AudioCueModificationManager.cs:line 28 at StardewValley.Game1.AfterLoadContent() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 2471 at StardewModdingAPI.Framework.SGame.LoadContent() in SMAPI\Framework\SGame.cs:line 149 at StardewValley.Game1.Instance_LoadContent() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 2422 at StardewValley.GameRunner.LoadContent() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\LocalMultiplayer.cs:line 799 at StardewValley.GameRunner.Initialize() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\LocalMultiplayer.cs:line 655 at Microsoft.Xna.Framework.Game.DoInitialize() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\Game.cs:line 944 at Microsoft.Xna.Framework.Game.Run(GameRunBehavior runBehavior) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\MonoGame.Desktop\MonoGame.Framework\Game.cs:line 465 at StardewModdingAPI.Framework.SCore.RunInteractively() in SMAPI\Framework\SCore.cs:line 316[SMAPI] Game has ended. Press any key to exit.
10259 comments
SMAPI does not contain malware; it seems something changed recently with the macOS security restrictions.
You can follow the updated macOS install guide to fix that. Make sure to follow each step carefully, since it may not work if you skip a step.
Read this before asking for help or reporting an issue. Common questions are answered here.
帮助 帮助 !!!!
Type the file path to the game directory (the one containing 'Stardew Valley.dll'), then press enter.
You must specify a directory path to continue.
Anyone know why this is?
Thank you xo
我尝试再次下载并安装游戏，但它仍然存在下载的 SMAPI 是最新版本请问如何解决这个问题？
//smapi.io/log/8faf86a6f4e84885b63fef37e5bf89a8
Any ideas what this might be related to? Or what needs to be done?