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 Linux|Instructions for Linux]]
| + | |
− | * [[Modding:Installing SMAPI on Windows|Instructions for Windows]]
| + | 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== |
− | # Install [https://www.mono-project.com/download/stable/ Mono]. (The 'stable channel' version is fine. If this doesn't work, see [[Modding:Player Guide/Troubleshooting#Linux/Mac: "looks like Mono isn't installed"|Troubleshooting]].)
| + | Quick note: As of version 4.0.0, SMAPI uses NET 6.0, which is supported on '''[https://github.com/dotnet/core/blob/main/release-notes/6.0/supported-os.md#macos Mac 10.15 (Catalina) or later]'''. These instructions will fail if you're on Mac 10.12 (Sierra), Mac 10.13 (High Sierra), or 10.14 (Mohave), 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].
| |
− | # Open the <tt>.zip</tt> file you downloaded to extract its contents.
| |
− | # Open Terminal, and enter this command:<pre>mdfind -0 'kMDItemFSName = "install on Mac.command" && kMDItemContentType = "com.apple.terminal.shell-script"' | xargs -0 xattr -d com.apple.quarantine</pre>''This is needed because [https://support.apple.com/kb/HT202491 Gatekeeper] prevents you from opening unsigned script files you download by default. To open Terminal: open [https://support.apple.com/kb/HT202635 Launchpad], type <tt>Terminal</tt>, and then press <tt>return</tt>.'' | |
− | # In Finder, open the file <code>install on Mac.command</code>, 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).
| + | # 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!). |
| + | # Right-click <samp>install on Mac.command</samp> and choose ''open''. |
| + | # Follow the on-screen instructions.¹ |
| | | |
− | <small>To install manually instead, see instructions in the installer's readme.</small> | + | 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>¹To install manually instead, see instructions in the installer's readme.</small> |
| | | |
| ==Update== | | ==Update== |
Line 22: |
Line 23: |
| | | |
| ==Uninstall== | | ==Uninstall== |
− | # Open the file <code>install on Mac.command</code>. | + | # Launch the installer again (see [[#Install|install steps]]). |
− | # Choose to uninstall SMAPI. | + | # When prompted, choose the ''uninstall'' option. |
| | | |
− | ==Special notes for macOS== | + | ==Troubleshooting== |
− | * You may need to reinstall Mono when updating macOS. | + | * If you are getting the <code>Operation not permitted: 'internal'</code> error, do the following steps: |
− | * You may need to reinstall SMAPI when the game updates. | + | ** 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 <samp>install on MacOS.command</samp>. |
| + | * 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 33: |
Line 42: |
| |next = | | |next = |
| }} | | }} |
| + | |
| + | [[de:Modding:SMAPI auf Mac]] |
| + | [[es:Modding:Instalar SMAPI en Mac]] |
| + | [[zh:模组:在Mac上安装SMAPI]] |