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.
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.
[SMAPI] Skipped mods [SMAPI] -------------------------------------------------- [SMAPI] These mods could not be added to your game. [SMAPI] - SMAPI 4.2.1 installer because the SMAPI installer isn't a mod (you can delete this folder after running the installer file).
im a bit confused, smapi was working fine for me yesterday, but now it keeps saying it cant find or load files, specifically seeming to be Mono.Cecil and 0Harmony, alongside maybe a few others? ive been searching and cant seem to find an answer on what to do anywhere, can anyone help?? im on windows and it wont even launch the game. just says game has ended.
10282 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.
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
在 System.Signature.GetSignature(Void* pCorSig, Int32 cCorSig, RuntimeMethodHandleInternal fieldHandle, IRuntimeMethodInfo methodHandle, RuntimeMethodType declaringType)
在 System.Reflection.RuntimeMethodInfo.<get_Signature>g__LazyCreateSignature|24_0()
在 System.Reflection.RuntimeMethodInfo.get_ReturnType()
在 HarmonyLib.Patch.GetMethod(MethodBase original)
在 System.Linq.Enumerable.SelectArrayIterator`2.ToList()
在 System.Linq.Enumerable.ToList[TSource](IEnumerable`1 source)
在 HarmonyLib.PatchSorter.Sort(MethodBase original)
在 HarmonyLib.PatchFunctions.UpdateWrapper(MethodBase original, PatchInfo patchInfo)
在 HarmonyLib.PatchProcessor.Patch()
在 AlternativeTextures.Framework.Patches.Shop Locations.ShopBuilderPatch.Apply(Harmony harmony) 于 C:\Users\Floogen\Documents\GitHub Repos\AlternativeTextures\AlternativeTextures\Framework\Patches\Shop Locations\ShopBuilderPatch.cs 第22行
在 AlternativeTextures.AlternativeTextures.Entry(IModHelper helper) 于 C:\Users\Floogen\Documents\GitHub Repos\AlternativeTextures\AlternativeTextures\AlternativeTextures.cs 第146行
[PyTK Lite] 使用 PyTK Lite
[SpaceCore] 未能应用 'SpaceCore.Patches.SaveGamePatcher' 修补程序;某些功能可能无法正常工作。技术细节:
System.InvalidOperationException: 无法找到方法 StardewValley.SaveGame.GetSerializer 进行修补。
在 SpaceCore.Patches.SaveGamePatcher.Apply(Harmony harmony, IMonitor monitor) 中,C:\Users\space\Programming\StardewValley\StardewValleyMods\SpaceCore\Patches\SaveGamePatcher.cs 第 49 行
在 Spacechase.Shared.Patching.HarmonyPatcher.Apply(Mod mod, IPatcher[] patchers) 中,C:\Users\space\Programming\StardewValley\StardewValleyMods\SpaceSharedPatching\HarmonyPatcher.cs 第 21 行
[SMAPI] --------------------------------------------------
[SMAPI] These mods could not be added to your game.
[SMAPI] - SMAPI 4.2.1 installer because the SMAPI installer isn't a mod (you can delete this folder after running the installer file).
InvalidCastException:无法将类型为“System.Collections.Generic.Dictionary'2[System.Int32,System.String]”的对象强制转换为类型“Microsoft.Xna.Framework.Graphics.Texture2D”
随后进入游戏所有帽子都不能正常显示,我尝试不用SMAPI进入游戏就是正常的,也尝试过把所有使用的MOD文件删除了,发现只要用SMAPI启动游戏就会出现这个情况,麻烦问下这要如何解决,谢谢~