Modding:Installing SMAPI on Mac

This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:

• Instructions for Android
• Instructions for Linux
• Instructions for Windows

Install

1. 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.
   1. For a pictorial guide to installing Mono, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_Mono.
   2. For a pictorial guide to installing .NET 5, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_.NET_5.
2. Download the latest version of SMAPI.
   1. For a pictorial guide to installing SMAPI, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI.
3. Extract the .zip file somewhere (but not in your game folder!).
4. 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

1. Launch the installer again (see install steps).
2. 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.

← Getting Started