Difference between revisions of "Modding:Installing SMAPI on Mac"

From Stardew Valley Wiki
Jump to navigation Jump to search
(→‎Troubleshooting: remove reference to installing NET 5.0)
Line 27: Line 27:
 
==Troubleshooting==
 
==Troubleshooting==
 
<!--* If you're on an M1 Mac, try installing .NET 5.0.11 (see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#For_M1_Macs_Only:_Install_.NET_5.0.11|a pictorial guide]] for details). -->
 
<!--* If you're on an M1 Mac, try installing .NET 5.0.11 (see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#For_M1_Macs_Only:_Install_.NET_5.0.11|a pictorial guide]] for details). -->
 +
* If you are getting "Operation not permitted: 'internal', 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 [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
 
* See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting.
  

Revision as of 21:07, 4 March 2022

Modding:Player Guide/header

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

Install

  1. Download the latest version of SMAPI (see a pictorial guide).
  2. Extract the .zip file somewhere (but not in your game folder!).
  3. 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 "Operation not permitted: 'internal', 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.