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 or Steam Deck
• Instructions for Windows

Install

2. Download the latest version of SMAPI (see a pictorial guide).
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 you are getting the Operation not permitted: 'internal' error, do the following steps:
  • Open System Preferences
  • Go to "Security and Privacy", then go to the "Privacy" tab.
  • Scroll down to "Full Disk Access".
  • Click the lock button to make changes, and then use the + button to add Terminal to the list of apps.
  • Try again to run install on MacOS.command.
• See the troubleshooting page for general troubleshooting.

← Getting Started