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.
[SMAPI] Skipped mods[SMAPI] --------------------------------------------------[SMAPI] These mods could not be added to your game.[SMAPI] - Stardew Valley Expanded chinese-10342-1-15-9-1741909753\Stardew Valley Expanded\[CP] Stardew Valley Expanded\i18n because it contains files, but none of them are manifest.json.[SMAPI] - Stardew Valley Expanded chinese-10342-1-15-9-1741909753\Stardew Valley Expanded\Stardew Valley Expanded Code\i18n because it contains files, but none of them are manifest.json.
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.
i figured it out! you have to move/copy the smapi files inside your stardew valley game folder. once you do that and attempt to install smapi, it should show you the files your game is in so you can install smapi
the SMAPI log details are there:https://smapi.io/log/a5ccd998f59e4c0882c58cbebe2cb78f; main error: An error occurred in the base update loop: NullReferenceException: Object reference not set to an instance of an object.at StardewDruid.Character.Jester.TargetWork() in C:\StardewDruid\StardewDruid\Character\Jester.cs:line 480 at StardewDruid.Character.Character.ChooseBehaviour() in C:\StardewDruid\StardewDruid\Character\Character.cs:line 2402 at StardewDruid.Character.Character.update(GameTime time, GameLocation location) in C:\StardewDruid\StardewDruid\Character\Character.cs:line 1935 at StardewDruid.Character.Jester.update(GameTime time, GameLocation location) in C:\StardewDruid\StardewDruid\Character\Jester.cs:line 169 at StardewValley.GameLocation.updateCharacters(GameTime time) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Locations\GameLocation.cs:line 4617 at StardewValley.GameLocation.updateEvenIfFarmerIsntHere(GameTime time, Boolean ignoreWasUpdatedFlush) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Locations\GameLocation.cs:line 4654 at StardewValley.Game1._UpdateLocation(GameLocation location, GameTime time) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 6169 at StardewValley.Game1.<>c__DisplayClass735_0.<UpdateLocations>b__0(GameLocation location) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 6126 at StardewValley.Utility.ForEachLocation(Func`2 action, Boolean includeInteriors, Boolean includeGenerated) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Utility.cs:line 342 at StardewValley.Game1.UpdateLocations_PatchedBy<spacechase0.SpaceCore>(Game1 this, GameTime time) at StardewValley.Game1._update(GameTime gameTime) at StardewValley.Game1.Update(GameTime gameTime) at StardewModdingAPI.Framework.SCore.OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate) this error keeps looping indefinitely. I spent money to unlock the walnuts of island Ginger. After saving, the error came. How can I do? ple!
[SMAPI] Couldn't check for a new version of SMAPI. This won't affect your game, but you won't be notified of new versions if this keeps happening. [SMAPI] Couldn't check for new mod versions. This won't affect your game, but you won't be notified of mod updates if this keeps happening.
hello, Pathos! Hope you are well and long time no speak! ^__^ I'm having a weird issue with SMAPI unfortunately. I'm just getting back into modding, and I'm testing a small pack of mods to make sure they're functional for 1.6
anyway, long story short: SMAPI itself keeps freezing. The game itself is fine. But after the game launches, the SMAPI window will freeze after a short time has passed (as quickly as under 30 seconds). It won't let me scroll up to see anything that's passed, and it won't let me type a command. It may work at first, but if I have to go back a second or third time to type in a new command, it freezes. Sometimes it freezes in the middle of me typing a command. I'm not quite sure what's causing this. It may be a tech issue with my computer but I'm not sure what I should be looking for to figure it out.
here's a log just in case since I don't know if it's a particular mod causing it: https://smapi.io/log/6a8dcc9b0859456b8e802a103f1d49cd
EDIT: Ok I thiiiink I may have found the solution (knock on wood). Forcing my discrete graphics card on seems to have done the trick. For whatever reason, my laptop will not do it automatically even after following the instructions on the wiki, but if I do it manually, the freezing issue does indeed stop.
you can find the answer here: https://stardewvalleywiki.com/Modding:Player_Guide/Troubleshooting
Run the game on your dedicated graphics card (Windows only)Many computers have two options for running games: integrated graphics (part of the processor) and dedicated graphics (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that's not always the default (especially on laptops). If you're not sure if this applies to your computer, it's safe to just try the instructions below anyway — they just won't do anything if it doesn't apply.
From the start menu, search for Graphics Settings and open it.
In the window that opens, click "Browse" near the top and choose StardewModdingAPI.exe in your game folder (or Stardew Valley.exe if you play without mods).
In the app list, click "Options" under StardewModdingAPI (or Stardew Valley if you play without mods).
Change the Graphics preference to "High performance".
I have downloaded SMAPI from 2 different places. I get stuck on the loading screen before the game loads. When SMAPI did load the one time after waiting 10-20ish minutes the game crashed before I could load a save. How do I fix this? SMAPI logs: https://smapi.io/log/54cae0aa0e3c4236b27b9689ac0b5e6a
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.
10288 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.
main error:
An error occurred in the base update loop: NullReferenceException: Object reference not set to an instance of an object.at StardewDruid.Character.Jester.TargetWork() in C:\StardewDruid\StardewDruid\Character\Jester.cs:line 480
at StardewDruid.Character.Character.ChooseBehaviour() in C:\StardewDruid\StardewDruid\Character\Character.cs:line 2402
at StardewDruid.Character.Character.update(GameTime time, GameLocation location) in C:\StardewDruid\StardewDruid\Character\Character.cs:line 1935
at StardewDruid.Character.Jester.update(GameTime time, GameLocation location) in C:\StardewDruid\StardewDruid\Character\Jester.cs:line 169
at StardewValley.GameLocation.updateCharacters(GameTime time) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Locations\GameLocation.cs:line 4617
at StardewValley.GameLocation.updateEvenIfFarmerIsntHere(GameTime time, Boolean ignoreWasUpdatedFlush) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Locations\GameLocation.cs:line 4654
at StardewValley.Game1._UpdateLocation(GameLocation location, GameTime time) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 6169
at StardewValley.Game1.<>c__DisplayClass735_0.<UpdateLocations>b__0(GameLocation location) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:line 6126
at StardewValley.Utility.ForEachLocation(Func`2 action, Boolean includeInteriors, Boolean includeGenerated) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Utility.cs:line 342
at StardewValley.Game1.UpdateLocations_PatchedBy<spacechase0.SpaceCore>(Game1 this, GameTime time)
at StardewValley.Game1._update(GameTime gameTime)
at StardewValley.Game1.Update(GameTime gameTime)
at StardewModdingAPI.Framework.SCore.OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate)
this error keeps looping indefinitely. I spent money to unlock the walnuts of island Ginger. After saving, the error came.
How can I do? ple!
[SMAPI] Couldn't check for new mod versions. This won't affect your game, but you won't be notified of mod updates if this keeps happening.
我的smapi不显示更新了，我看不了哪些mod需要更新，以至于有的mod没更新爆红
anyway, long story short: SMAPI itself keeps freezing. The game itself is fine. But after the game launches, the SMAPI window will freeze after a short time has passed (as quickly as under 30 seconds). It won't let me scroll up to see anything that's passed, and it won't let me type a command. It may work at first, but if I have to go back a second or third time to type in a new command, it freezes. Sometimes it freezes in the middle of me typing a command. I'm not quite sure what's causing this. It may be a tech issue with my computer but I'm not sure what I should be looking for to figure it out.
here's a log just in case since I don't know if it's a particular mod causing it: https://smapi.io/log/6a8dcc9b0859456b8e802a103f1d49cd
EDIT: Ok I thiiiink I may have found the solution (knock on wood). Forcing my discrete graphics card on seems to have done the trick. For whatever reason, my laptop will not do it automatically even after following the instructions on the wiki, but if I do it manually, the freezing issue does indeed stop.
Run the game on your dedicated graphics card (Windows only)Many computers have two options for running games: integrated graphics (part of the processor) and dedicated graphics (a separate graphics card by NVIDIA or AMD). Stardew Valley should be run on the dedicated graphics, but that's not always the default (especially on laptops). If you're not sure if this applies to your computer, it's safe to just try the instructions below anyway — they just won't do anything if it doesn't apply.
in your game folder (or Stardew Valley.exe if you play without mods).
SMAPI logs: https://smapi.io/log/54cae0aa0e3c4236b27b9689ac0b5e6a