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.
game crash with this error: [SMAPI] An error occurred in the game's draw loop: ArgumentOutOfRangeException: Specified argument was out of the range of valid values.at System.String.SplitInternal(ReadOnlySpan1 separators, Int32 count, StringSplitOptions options)at StardewModdingAPI.Toolkit.Utilities.PathUtilities.GetSegments(String path, Nullable1 limit) in SMAPI.Toolkit\Utilities\PathUtilities.cs:line 45at StardewModdingAPI.Toolkit.Utilities.PathUtilities.NormalizeAssetName(String assetName) in SMAPI.Toolkit\Utilities\PathUtilities.cs:line 62at StardewModdingAPI.Framework.Content.AssetName..ctor(String baseName, String localeCode, Nullable1 languageCode) in SMAPI\Framework\Content\AssetName.cs:line 48at StardewModdingAPI.Framework.Content.AssetName.Parse(String rawName, Func2 parseLocale) in SMAPI\Framework\Content\AssetName.cs:line 89at StardewModdingAPI.Framework.ContentCoordinator.ParseAssetName_PatchedBy<Platonymous.PyTKLite.ScaleUp>(ContentCoordinator this, String rawName, Boolean allowLocales)at ContentPatcherAnimations.Patches.SpriteBatchPatcher.After_Draw(Texture2D& texture, Nullable1& sourceRectangle)at Microsoft.Xna.Framework.Graphics.SpriteBatch.Draw_PatchedBy<BleakCodex.SpritesInDetail__Platonymous.PyTKLite.ScaleUp.Spritebatch__spacechase0.ContentPatcherAnimations__spacechase0.SpaceCore>(SpriteBatch this, Texture2D texture, Vector2 position, Nullable1 sourceRectangle, Color color, Single rotation, Vector2 origin, Single scale, SpriteEffects effects, Single layerDepth)at StardewModdingAPI.Framework.Rendering.SDisplayDevice.DrawImpl(Tile tile, Location location, Single layerDepth, Texture2D tileSheetTexture)at xTile.Display.XnaDisplayDevice.DrawTile_PatchedBy<PeacefulEnd.DynamicReflections>(XnaDisplayDevice this, Tile tile, Location location, Single layerDepth) at xTile.Layers.Layer.DrawNormal_PatchedBy<PeacefulEnd.DynamicReflections>(Layer this, IDisplayDevice displayDevice, Rectangle mapViewport, Location displayOffset, Int32 pixelZoom, Single sort_offset) at StardewValley.Game1.DrawWorld(GameTime time, RenderTarget2D target_screen) at StardewValley.Game1._draw(GameTime gameTime, RenderTarget2D target_screen) at StardewModdingAPI.Framework.SGame._draw(GameTime gameTime, RenderTarget2D target_screen)
can anyone help me to figure out what cause it and how to fix it?
Hello there, my game is now refusing to load from Steam and I'm not sure what the error is, I've just updated a few mods, Content Patcher, Generic Mod Config Menu, Lookup Anything, Json Assets, Automate, Spacecore and Central Station, but I can't figure out what is going on, it loaded fine before I updated them so one of them has messed up something, if I post the SMAPI log, can someone give me any ideas? https://smapi.io/log/970caa058d9d423eb682759841f39daa [Edit] Ok I think I fixed it, something got messed up somewhere when I replaced the files rather than deleting the outdated mods and putting the updated files in as new ones, I think one or two of them are a bit finicky like that.
Hey so i am running this on CachyOS (Linux through steam), and no matter what i do, i can install SMAPI but the game wont load up the mods. The game boots up every time no problem, and runs like a dream, but no matter what i do i cant get the game to recognize it has mods installed. Worked once, then never again, any help?
I don't have any issues when running the vanilla game, but when I try to launch it through Smapı, I hear the game’s startup sounds, but the screen stays black. I’ve reinstalled both the game and Smapı, but the problem still isn’t fixed. :( Can you help me with this?
The last steamos update (3.7.8) introduced the Galaxy API bug. Without being a Linux power user, is there something in the works to address the online capability glitch?
I am experiencing the same issue with my steam deck/steamos. Through my online research someone suggested to revert to the pervious version of the steamos. This has worked for me.
Restart the steam deck. During boot up hold the "..." button (on the right side). The screen should appear. There will be 4 options. Choose the pervious version 3.6.24 or the second option down. Steam deck will run command text. Let that run and complete. Big picture mode will load automatically upon complete.
[game] An error occurred in the base update loop: NullReferenceException: Object reference not set to an instance of an object. at StardewValley.NPC.doPlayRobinHammerAnimation() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\NPC.cs:line 1202 at StardewValley.NPC.update(GameTime time, GameLocation location) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\NPC.cs:line 3574 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)
My English is not good, so I can only try my best to describe it clearly. When I clicked on the Mani store, there was no response at all, only SMAPI popped up with red text, and then I checked other stores without any problems. When I returned to the title interface, new red text appeared again. This is an online archive, and both it and its single file have this issue. I did not encounter any problems when opening other individual archives for experimentation. I have tried other stores without any problems, but there is only one mod for Mani Store at home, NEXUS ending in 29997. I suspect there may be a problem with it, but even if I delete all mods, the error still persists. So I don't understand now, I can only hope that someone can solve it.
10307 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.
[SMAPI] An error occurred in the game's draw loop: ArgumentOutOfRangeException: Specified argument was out of the range of valid values.at System.String.SplitInternal(ReadOnlySpan
1 separators, Int32 count, StringSplitOptions options)
at StardewModdingAPI.Toolkit.Utilities.PathUtilities.GetSegments(String path, Nullable1 limit) in SMAPI.Toolkit\Utilities\PathUtilities.cs:line 45
at StardewModdingAPI.Toolkit.Utilities.PathUtilities.NormalizeAssetName(String assetName) in SMAPI.Toolkit\Utilities\PathUtilities.cs:line 62at StardewModdingAPI.Framework.Content.AssetName..ctor(String baseName, String localeCode, Nullable1 languageCode) in SMAPI\Framework\Content\AssetName.cs:line 48
at StardewModdingAPI.Framework.Content.AssetName.Parse(String rawName, Func2 parseLocale) in SMAPI\Framework\Content\AssetName.cs:line 89
at StardewModdingAPI.Framework.ContentCoordinator.ParseAssetName_PatchedBy<Platonymous.PyTKLite.ScaleUp>(ContentCoordinator this, String rawName, Boolean allowLocales)at ContentPatcherAnimations.Patches.SpriteBatchPatcher.After_Draw(Texture2D& texture, Nullable1& sourceRectangle)
at Microsoft.Xna.Framework.Graphics.SpriteBatch.Draw_PatchedBy<BleakCodex.SpritesInDetail__Platonymous.PyTKLite.ScaleUp.Spritebatch__spacechase0.ContentPatcherAnimations__spacechase0.SpaceCore>(SpriteBatch this, Texture2D texture, Vector2 position, Nullable1 sourceRectangle, Color color, Single rotation, Vector2 origin, Single scale, SpriteEffects effects, Single layerDepth)
at StardewModdingAPI.Framework.Rendering.SDisplayDevice.DrawImpl(Tile tile, Location location, Single layerDepth, Texture2D tileSheetTexture)at xTile.Display.XnaDisplayDevice.DrawTile_PatchedBy<PeacefulEnd.DynamicReflections>(XnaDisplayDevice this, Tile tile, Location location, Single layerDepth)at xTile.Layers.Layer.DrawNormal_PatchedBy<PeacefulEnd.DynamicReflections>(Layer this, IDisplayDevice displayDevice, Rectangle mapViewport, Location displayOffset, Int32 pixelZoom, Single sort_offset)
at StardewValley.Game1.DrawWorld(GameTime time, RenderTarget2D target_screen)
at StardewValley.Game1._draw(GameTime gameTime, RenderTarget2D target_screen)
at StardewModdingAPI.Framework.SGame._draw(GameTime gameTime, RenderTarget2D target_screen)
can anyone help me to figure out what cause it and how to fix it?
[table]-System[/table][table]-Provider[ Name] Application
Error
[ Guid] {a0e9b465-b939-57d7-b27d-95d8e925ff57}
[/table][table]EventID1000[/table][table]Version0[/table][table]Level2[/table][table]Task100[/table][table]Opcode0[/table][table]Keywords0x8000000000000000[/table][table]-TimeCreated[ SystemTime] 2025-05-30T16:13:19.8289051Z
[/table][table]EventRecordID1332[/table][table]Correlation[/table][table]-Execution[ ProcessID] 42152
[ ThreadID] 15448
[/table][table]ChannelApplication[/table][table]ComputerTheChosen[/table][table]-Security[ UserID] S-1-5-21-1894140824-3240915609-2394508137-1003
[/table]
[table]-EventData[/table][table]AppNameStardewModdingAPI.exe[/table][table]AppVersion4.2.1.0[/table][table]AppTimeStamp670d0000[/table][table]ModuleNameunknown[/table][table]ModuleVersion0.0.0.0[/table][table]ModuleTimeStamp00000000[/table][table]ExceptionCodec0000005[/table][table]FaultingOffset0000000000000000[/table][table]ProcessId0x4688[/table][table]ProcessCreationTime0x1dbd17963b1913b[/table][table]AppPathD:\steam\steamapps\common\Stardew
Valley\StardewModdingAPI.exe[/table][table]ModulePathunknown[/table][table]IntegratorReportId0ab87107-b23d-4b5c-b82b-c0e52541b2b7[/table][table]PackageFullName[/table][table]PackageRelativeAppId[/table]
https://smapi.io/log/970caa058d9d423eb682759841f39daa
[Edit] Ok I think I fixed it, something got messed up somewhere when I replaced the files rather than deleting the outdated mods and putting the updated files in as new ones, I think one or two of them are a bit finicky like that.
https://forums.stardewvalley.net/threads/galaxy-api-not-loading-with-glibc-2-41.36974/#post-160943
This is the issue I'm having and no I can't run the game by proton because I've run mods based on the native Linux version of smapi.
Restart the steam deck. During boot up hold the "..." button (on the right side). The screen should appear. There will be 4 options. Choose the pervious version 3.6.24 or the second option down. Steam deck will run command text. Let that run and complete. Big picture mode will load automatically upon complete.
---> System.Xml.XmlException:缺少根元素。
在 System.Xml.XmlTextReaderImpl.Throw(异常 e)
在 System.Xml.XmlTextReaderImpl.ParseDocumentContent()
上 在 System.Xml.XmlTextReaderImpl.Read()
在 System.Xml.XmlReader.MoveToContent()
上 Microsoft.Xml.Serialization.GeneratedAssembly.XmlSerializationReaderFarmer.Read173_Farmer---()
内部异常堆栈跟踪---
结束在 System.Xml.Serialization.XmlSerializer.Deserialize(XmlReader xmlReader, String encodingStyle, XmlDeserializationEvents 事件)
在 System.Xml.Serialization.XmlSerializer.Deserialize(流)
在 Netcode.NetRefBase'2.deserialize(BinaryReader reader, XmlSerializer serializer) 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Network\NetFields\NetRef.cs:第 109
行在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Network\Client.cs:第 122
行的 StardewValley.Network.Client.Client.receiveAvailableFarmhands(BinaryReader msg) 在 SMAPI\Framework\SMultiplayer.cs:第 336
行的 StardewModdingAPI.Framework.SMultiplayer.OnClientProcessingMessage(IncomingMessage message, Action'1 sendMessage, Action resume)在 StardewValley.SDKs.Steam.SteamNetClient.receiveMessagesImpl() 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\SDKs\Steam\SteamNetClient.cs:第 406
行 在 StardewValley.Network.Client.receiveMessages() 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Network\Client.cs:第 68
行在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Menus\FarmhandMenu.cs:line 302
在 StardewValley.Menus.TitleMenu.update(游戏时间) 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Menus\TitleMenu.cs:line 2008
在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:第 5079
行在 StardewValley.Game1._update(GameTime gameTime) 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:第 4376
行在 StardewValley.Game1.Update(GameTime gameTime) 在 D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\Game1.cs:SMAPI\Framework\SCore.cs 中 StardewModdingAPI.Framework.SCore.OnPlayerInstanceUpdating(SGame instance, GameTime gameTime, Action runUpdate) 的第 3454
行:第 1095 行
at StardewValley.NPC.doPlayRobinHammerAnimation() in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\NPC.cs:line 1202
at StardewValley.NPC.update(GameTime time, GameLocation location) in D:\GitlabRunner\builds\Gq5qA5P4\0\ConcernedApe\stardewvalley\Farmer\Farmer\NPC.cs:line 3574
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)
When I clicked on the Mani store, there was no response at all, only SMAPI popped up with red text, and then I checked other stores without any problems. When I returned to the title interface, new red text appeared again.
This is an online archive, and both it and its single file have this issue. I did not encounter any problems when opening other individual archives for experimentation.
I have tried other stores without any problems, but there is only one mod for Mani Store at home, NEXUS ending in 29997.
I suspect there may be a problem with it, but even if I delete all mods, the error still persists.
So I don't understand now, I can only hope that someone can solve it.
Platform WINDOWS
Game version 1.6.15
SMAPI log https://smapi.io/log/6439c57b529741b6b635eeb2982ec645