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.
@EDIT2: I think I might have solved this issue by simply running the .exe instead of the .bat file. I'll leave this post as it is for it might help someone out. If you are running into the issued described below, try to open the "install" subfolder inside the main Smapi folder you unziped and running the "SMAPI.installer.exe" file. It'll just... work, I guess.
I have turned off my antivirus software. Not only that, I have actually killed anything running in the background just to be safe. I downloaded the installer and tried installing under these conditions on at least three different days, the most recent being today. I have tried the methods below at least three different times, all with no success.
I will try to describe, step by step, what happens when I try to apply the solution described in the Troubleshooting page. The folder is inside my standard Windows Download folder, renamed "smapi" for simplification. After Shift+RightClicking, I choose "Open PowerShell window here". I apologize in advance for any weird naming, as I'm brazilian and my OS is in portuguese, so I'm freely translating the options and they might not reflect, in literis, the english option.
The screen opens with only the following line: PS C:\Users\pdant\Downloads\smapi>
I paste the "./"install on Windows.bat"" as described in the solution, press enter and nothing happens. It just goes to the line below: PS C:\Users\pdant\Downloads\smapi> ./"install on Windows.bat" PS C:\Users\pdant\Downloads\smapi>
Just to be safe, I try pasting the ""install on Windows.bat"", which is the CMD option, but again, nothing happens. PS C:\Users\pdant\Downloads\smapi> "install on Windows.bat" install on Windows.bat PS C:\Users\pdant\Downloads\smapi>
I also oppened CMD and navigated there to try and open the file through it, but it did not work too. All it does is just open another CMD window but it just starts in the smapi installaer folder: C:\Users\pdant>cd Downloads C:\Users\pdant\Downloads>cd smapi C:\Users\pdant\Downloads\smapi>dir O volume na unidade C é OS Pasta de C:\Users\pdant\Downloads\smapi 17/04/2025 22:01 <DIR> . 17/04/2025 21:48 <DIR> .. 25/03/2025 22:11 1.209 install on Linux.sh 25/03/2025 22:11 115 install on macOS.command 25/03/2025 22:11 1.426 install.bat 25/03/2025 22:11 <DIR> internal 25/03/2025 22:11 2.267 README.txt 4 arquivo(s) 5.017 bytes 3 pasta(s) 126.187.593.728 bytes disponíveis C:\Users\pdant\Downloads\smapi>start install.bat C:\Users\pdant\Downloads\smapi>
I could not think of any other way to solve this, sadly.
@EDIT: I have also tried the PowerShell comands using an inverted bar - \ - as it seem to be used in my OS instead of the normal one - / - but the results were the same.
10257 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?
======================
Hey there! I'm running into the "SMAPI installer opens, then immediately closes" error described in the Troubleshooting Page. Currently on version 4.1.10. However, the steps described in the troubleshooting solution are not solving it, sadly. Here is the link to the log.
I have turned off my antivirus software. Not only that, I have actually killed anything running in the background just to be safe. I downloaded the installer and tried installing under these conditions on at least three different days, the most recent being today. I have tried the methods below at least three different times, all with no success.
I will try to describe, step by step, what happens when I try to apply the solution described in the Troubleshooting page. The folder is inside my standard Windows Download folder, renamed "smapi" for simplification. After Shift+RightClicking, I choose "Open PowerShell window here". I apologize in advance for any weird naming, as I'm brazilian and my OS is in portuguese, so I'm freely translating the options and they might not reflect, in literis, the english option.
The screen opens with only the following line:
PS C:\Users\pdant\Downloads\smapi>
I paste the "./"install on Windows.bat"" as described in the solution, press enter and nothing happens. It just goes to the line below:
PS C:\Users\pdant\Downloads\smapi> ./"install on Windows.bat"
PS C:\Users\pdant\Downloads\smapi>
Just to be safe, I try pasting the ""install on Windows.bat"", which is the CMD option, but again, nothing happens.
PS C:\Users\pdant\Downloads\smapi> "install on Windows.bat"
install on Windows.bat
PS C:\Users\pdant\Downloads\smapi>
I also oppened CMD and navigated there to try and open the file through it, but it did not work too. All it does is just open another CMD window but it just starts in the smapi installaer folder:
C:\Users\pdant>cd Downloads
C:\Users\pdant\Downloads>cd smapi
C:\Users\pdant\Downloads\smapi>dir
O volume na unidade C é OS
Pasta de C:\Users\pdant\Downloads\smapi
17/04/2025 22:01 <DIR> .
17/04/2025 21:48 <DIR> ..
25/03/2025 22:11 1.209 install on Linux.sh
25/03/2025 22:11 115 install on macOS.command
25/03/2025 22:11 1.426 install.bat
25/03/2025 22:11 <DIR> internal
25/03/2025 22:11 2.267 README.txt
4 arquivo(s) 5.017 bytes
3 pasta(s) 126.187.593.728 bytes disponíveis
C:\Users\pdant\Downloads\smapi>start install.bat
C:\Users\pdant\Downloads\smapi>
I could not think of any other way to solve this, sadly.
@EDIT: I have also tried the PowerShell comands using an inverted bar - \ - as it seem to be used in my OS instead of the normal one - / - but the results were the same.