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

From Stardew Valley Wiki
Jump to navigation Jump to search
(tweak install guide links)
(update for new Steam Deck page, remove outdated content)
Line 1: Line 1:
 
{{Modding:Player Guide/header}}
 
{{Modding:Player Guide/header}}
  
This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:
+
This page explains how to install SMAPI (the tool which lets you use mods) on macOS.
* [[Modding:Installing SMAPI on Android|Instructions for Android]]
+
 
* [[Modding:Installing SMAPI on Linux|Instructions for Linux or Steam Deck]]
+
See instructions for: [[Modding:Installing SMAPI on Android|Android]] [[Modding:Installing SMAPI on Linux|Linux]] • [[Modding:Installing SMAPI on Steam Deck|Steam Deck]] [[Modding:Installing SMAPI on Windows|Windows]].
* [[Modding:Installing SMAPI on Windows|Instructions for Windows]]
 
  
 
__TOC__
 
__TOC__
  
 
==Install==
 
==Install==
# <!--Install [https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5] (see [[Modding:Installing SMAPI on Mac Pictorial Guide#Install .NET 5|a pictorial guide]]).-->
 
 
# Download the [https://smapi.io/ latest version of SMAPI] (see [[Modding:Installing SMAPI on Mac Pictorial Guide#Install SMAPI|a pictorial guide]]).
 
# Download the [https://smapi.io/ latest version of SMAPI] (see [[Modding:Installing SMAPI on Mac Pictorial Guide#Install SMAPI|a pictorial guide]]).
 
# Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).
 
# Extract the <samp>.zip</samp> file somewhere (but not in your game folder!).
Line 26: Line 24:
  
 
==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 are getting the <code>Operation not permitted: 'internal'</code> error, do the following steps:
 
* If you are getting the <code>Operation not permitted: 'internal'</code> error, do the following steps:
 
** Open System Preferences
 
** Open System Preferences

Revision as of 17:50, 5 June 2022

Modding:Player Guide/header

This page explains how to install SMAPI (the tool which lets you use mods) on macOS.

See instructions for: AndroidLinuxSteam DeckWindows.

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 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.