Difference between revisions of "Modding:Installing SMAPI on Mac"
Jump to navigation
Jump to search
Pathoschild (talk | contribs) (update header template) |
|||
| Line 8: | Line 8: | ||
==Install== | ==Install== | ||
| + | Quick note: SMAPI uses NET 5.0, which is supported on [https://github.com/dotnet/core/blob/main/release-notes/5.0/5.0-supported-os.md#macos Mac 10.15 or later]. These instructions might work if you're on mac 10.13 or 10.14; they will fail if you're on mac 10.12, in which case, see: [[Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_the_compatibility_branch]] | ||
| + | |||
# 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!). | ||
Revision as of 01:20, 12 January 2023
Player's guide to using mods 
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
Quick note: SMAPI uses NET 5.0, which is supported on Mac 10.15 or later. These instructions might work if you're on mac 10.13 or 10.14; they will fail if you're on mac 10.12, in which case, see: Modding:Player_Guide/Troubleshooting#SMAPI_doesn.27t_work_with_the_compatibility_branch
- Download the latest version of SMAPI (see a pictorial guide).
- Extract the .zip file somewhere (but not in your game folder!).
- 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
- Launch the installer again (see install steps).
- 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.