Jump to content

Modding:Installing SMAPI on Mac: Difference between revisions

From Stardew Valley Wiki
imported>Pathoschild
tweak install guide links
imported>Pathoschild
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: Android • Linux • Steam Deck • Windows.

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.