Difference between revisions of "Modding:Installing SMAPI on Mac"
Jump to navigation
Jump to search
Margotbean (talk | contribs) m (Text replacement - "tt>" to "samp>") |
|||
Line 14: | Line 14: | ||
# Download the [https://smapi.io/ latest version of SMAPI]. | # Download the [https://smapi.io/ latest version of SMAPI]. | ||
## For a pictorial guide to installing SMAPI, see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI]]. | ## For a pictorial guide to installing SMAPI, see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI]]. | ||
− | # Extract the < | + | # Extract the <samp>.zip</samp> file somewhere (but not in your game folder!). |
− | # Double-click < | + | # Double-click <samp>install on Mac.command</samp>¹, 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). | 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). |
Revision as of 18:48, 4 November 2021
This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:
Install
- Install Mono. (The 'stable channel' version is fine. If this doesn't work, see Troubleshooting.) As of the upcoming SMAPI 3.13.0: Install .NET 5 instead.
- For a pictorial guide to installing Mono, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_Mono.
- For a pictorial guide to installing .NET 5, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_.NET_5.
- Download the latest version of SMAPI.
- For a pictorial guide to installing SMAPI, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI.
- 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.