Difference between revisions of "Modding:Installing SMAPI on Mac"
(Add names) |
|||
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 | + | 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 (Catalina) or later]. These instructions might work if you're on Mac 10.13 (High Sierra) or 10.14 (Mohave); they will fail if you're on Mac 10.12 (Sierra), 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]]). |
Revision as of 01:25, 12 January 2023
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 (Catalina) or later. These instructions might work if you're on Mac 10.13 (High Sierra) or 10.14 (Mohave); they will fail if you're on Mac 10.12 (Sierra), 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.