Modding:Installing SMAPI on Mac
Revision as of 04:06, 1 December 2021 by Pathoschild (talk | contribs) (→Install: update for Stardew Valley 1.5.5 release)
This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:
Install
- Install .NET 5 (see a pictorial guide).
- Download the latest version of SMAPI (see a pictorial guide).
- Extract the .zip file somewhere (but not in your game folder!).
- Double-click install on Mac.command¹, and follow the on-screen instructions.
That's it! Just launch the game to play with mods. You don't need to change your Steam launch options (that's only needed on Windows).
¹To install manually instead, see instructions in the installer's readme.
Update
Just install the new version; the installer will automatically clean up previous versions.
Uninstall
- Launch the installer again (see install steps).
- When prompted, choose the uninstall option.
Troubleshooting
- If the game freezes when loading a save with no error in the SMAPI window, try reinstalling Mono (see install step 1).
- If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
- See the troubleshooting page for general troubleshooting.