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 Mac. See also: | + | This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also: |
| * [[Modding:Installing SMAPI on Linux|Instructions for Linux]] | | * [[Modding:Installing SMAPI on Linux|Instructions for Linux]] |
| * [[Modding:Installing SMAPI on Windows|Instructions for Windows]] | | * [[Modding:Installing SMAPI on Windows|Instructions for Windows]] |
Line 8: |
Line 8: |
| | | |
| ==Install== | | ==Install== |
− | # Install [http://www.mono-project.com/ Mono] (if this doesn't work, see [[Modding:Player Guide/Troubleshooting#Linux/Mac: "looks like Mono isn't installed"|troubleshooting page]]). | + | # Install the "stable channel" version of [https://www.mono-project.com/download/stable/ Mono]. (If this doesn't work, see [[Modding:Player Guide/Troubleshooting#Linux/Mac: "looks like Mono isn't installed"|Troubleshooting]].) |
− | # Download the [https://smapi.io latest version of SMAPI]. | + | # Download [https://smapi.io/ SMAPI]. |
− | # Extract the <tt>.zip</tt> file somewhere (but not in your game folder!). | + | # Open the Zip file you downloaded in the previous step to extract its contents. |
− | # Run the <tt>install on Mac.command</tt> file, and follow the on-screen instructions.<br />''The installer will detect your game and add SMAPI for you.'' | + | # Open Terminal, and then enter the following command:<br/><br/><kbd>mdfind -0 'kMDItemFSName = "install on Mac.command" && kMDItemContentType = "com.apple.terminal.shell-script"' | xargs -0 xattr -d com.apple.quarantine</kbd> |
| + | # In Finder, open the file <code>install on Mac.command</code>, and then 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). | | 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). |
| + | |
| + | '''Note''': |
| + | |
| + | * Step 4 is necessary because, by default, [https://support.apple.com/kb/HT202491 Gatekeeper] will prevent you from opening unsigned script files downloaded via the Internet. |
| + | * To open Terminal, open [https://support.apple.com/kb/HT202635 Launchpad], type <kbd>Terminal</kbd>, and then press <kbd><kbd>return</kbd></kbd>. |
| + | * You must reinstall Mono whenever you update macOS. |
| | | |
| <small>To install manually instead, see instructions in the installer's readme.</small> | | <small>To install manually instead, see instructions in the installer's readme.</small> |
Line 21: |
Line 28: |
| | | |
| ==Uninstall== | | ==Uninstall== |
− | Run <tt>mono install.exe</tt> and choose ''uninstall''.
| + | # Open the file <code>install on Mac.command</code>. |
| + | # Choose to uninstall SMAPI. |
| | | |
| {{Modding guide footer | | {{Modding guide footer |