10307 comments

  1. Pathoschild
    Pathoschild
    • premium
    • 4,145 kudos
    Locked
    Sticky
    Why does macOS detect SMAPI as malware?

    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.
  2. Pathoschild
    Pathoschild
    • premium
    • 4,145 kudos
    Locked
    Sticky
    STOP!
    Read this before asking for help or reporting an issue. Common questions are answered here.


    What's new in SMAPI 4.2?
    SMAPI 4.2 has various bug fixes and improvements, an improved translation API, and mod events on the shipping menu.

    See the release highlights and release notes for more info.
    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.1 should 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.

    You can either:
    Where can I see fixes for common issues?
    See the mod troubleshooting guide!
    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.
  3. RockingSisyphus
    RockingSisyphus
    • member
    • 0 kudos
    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?
    1. RockingSisyphus
      RockingSisyphus
      • member
      • 0 kudos
      And again the game crush with no log,I can only report the log from windows:
      [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]
  4. andypuk1980ishere
    andypuk1980ishere
    • member
    • 0 kudos
    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. 
  5. AngelArcSage
    AngelArcSage
    • member
    • 0 kudos
    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?
  6. Gamphitrite
    Gamphitrite
    • member
    • 0 kudos
    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?
  7. MotenaiRonin
    MotenaiRonin
    • member
    • 2 kudos
    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?

    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. 
    1. Baer94
      Baer94
      • member
      • 0 kudos
      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.
  8. GymB0B
    GymB0B
    • member
    • 0 kudos
    can someone help my figure out why i can run the file to install smapi
  9. youdide
    youdide
    • member
    • 0 kudos
    [21:49:45 ERROR SpaceCore] Mod crashed on entry and might not work correctly. Technical details:AggregateException:发生一个或多个错误-P HarmonyLib. HarmonyException:方法null中的修补异常-P ArgumentException:补丁方法的未定义目标methad static System. Boolean SpaceCare. VanillaAsset Exponsion. FarmerAlwaysAcceptVirtualCurrencyPatch1:Prefix Staat HormonyLib.PatchClassProcessor.PatchlWithAttributes(MethodBase& lastOriginal, Boolean unpatch)在HarmonyLib.PatchClassProcessor.Patch ()--内部异常堆栈跟踪的结束--在HarmonyLib.PatchClassProcessor。ReportException(异常异常,MethodBase original)在HarmonyLib.PatchClassProcessor.Patch ()at HarmonyLib.Harmony.oPatchAllPb__10_O(Type type)在HarmonyLib.CollectionExtensions.Do[Type](lEnumerable'L sequence,Action'L Action)at HarmonyLib.Harmony.PatchAll(Assembly assembly)在HarmonyLib.Harmony.PatchAllOat Spacechase.Shared.Patching.HarmonyPatcher.Apply(Mod mod, lPatcher[] patchers)在SpaceCore.SpaceCore.Entry[IModHelper Helper]在StardewModdingAPI.MobileAndroidModLoaderManager.qbc_DisplayClass13_D.oTryStartModEntrybb_0()at System.Threading.Tasks.Task.Innerlnvoke()在System.Threading.Task.Task.Qbc.9.cctorbb__281_0(Object Obj)在System.Threading.ExecutionContext.Runlniment(ExecutionContext,ContextCallback回调,对象状态)--来自上一个位置的堆栈跟踪结束--在System.Threading.ExecutionContext.Runlniment(ExecutionContext,ContextCallback回调,对象状态)at System.Threading.Tasks.TaskExecuteWWithThreadLocal(Task&currentTaskSlot, Thread threadPoolThread)--内部异常堆栈跟踪的结束--at StardewModdingAPIMobileAndroidModLoaderManager.TryStartModEntry[IMod mod)在StardewModdingAPlFromework.SCore.LoadMods(IModMetadatal]Mods,JsonHelper JsonHelper,contentcoordator contentCore,ModDatobase modDatabase)
  10. baizhaoyang0211
    baizhaoyang0211
    • member
    • 0 kudos
    [游戏]基本更新循环中发生错误:InvalidOperationException:XML 文档 (0, 0) 中存在错误。
    ---> 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 行
  11. mikucl
    mikucl
    • member
    • 0 kudos
    [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)
  12. YANBAOSHIZHU
    YANBAOSHIZHU
    • member
    • 0 kudos
    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.

    Platform WINDOWS
    Game version 1.6.15
    SMAPI log https://smapi.io/log/6439c57b529741b6b635eeb2982ec645