Difference between revisions of "Modding:Installing SMAPI on Mac"
Nanogamer7 (talk | contribs) m |
Margotbean (talk | contribs) |
||
(30 intermediate revisions by 10 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{modding player guide header}} |
− | This page explains how to install SMAPI (the tool which lets you use mods) on | + | This page explains how to install SMAPI (the tool which lets you use mods) on macOS. |
− | + | ||
− | + | 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]]. | |
__TOC__ | __TOC__ | ||
==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 (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't work with the compatibility branch]] | |
− | # Download the [https://smapi.io/ latest version of SMAPI]. | + | |
− | # | + | # 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!). | |
− | + | # Double-click <samp>install on Mac.command</samp>¹, and follow the on-screen instructions. | |
− | |||
− | |||
− | # Double-click < | ||
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). | 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). | ||
− | <small> | + | <small>¹To install manually instead, see instructions in the installer's readme.</small> |
==Update== | ==Update== | ||
Line 25: | Line 22: | ||
==Uninstall== | ==Uninstall== | ||
− | # | + | # Launch the installer again (see [[#Install|install steps]]). |
− | # | + | # When prompted, choose the ''uninstall'' option. |
− | == | + | ==Troubleshooting== |
− | * | + | * If you are getting the <code>Operation not permitted: 'internal'</code> 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. | ||
+ | * On Ventura: | ||
+ | ** Install [https://iterm2.com/ iTerm] and set it to be your default Terminal. This is not optimal if you like using Terminal, but otherwise seems like a perfectly workable solution. | ||
+ | ** OR Temporarily disable System Integrity Protection. This is not a great solution, because it leaves your computer vulnerable, and you should absolutely not leave your computer in this state. | ||
+ | * See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting. | ||
{{Modding guide footer | {{Modding guide footer | ||
Line 37: | Line 42: | ||
}} | }} | ||
− | [[ | + | [[de:Modding:SMAPI auf Mac]] |
+ | [[es:Modding:Instalar SMAPI en Mac]] | ||
+ | [[zh:模组:在Mac上安装SMAPI]] |
Latest revision as of 04:04, 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't 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.
- On Ventura:
- Install iTerm and set it to be your default Terminal. This is not optimal if you like using Terminal, but otherwise seems like a perfectly workable solution.
- OR Temporarily disable System Integrity Protection. This is not a great solution, because it leaves your computer vulnerable, and you should absolutely not leave your computer in this state.
- See the troubleshooting page for general troubleshooting.