Difference between revisions of "Modding:Installing SMAPI on Mac"
Jump to navigation
Jump to search
Margotbean (talk | contribs) |
MouseyPounds (talk | contribs) (Updating as per Discord user Maximo#3952) |
||
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 | + | 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 [ | + | # 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 | + | # Download [https://smapi.io/ SMAPI]. |
− | # | + | # Open the Zip file you downloaded in the previous step to extract its contents. |
− | # | + | # 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== | ||
− | + | # Open the file <code>install on Mac.command</code>. | |
+ | # Choose to uninstall SMAPI. | ||
{{Modding guide footer | {{Modding guide footer |
Revision as of 02:11, 31 October 2018
This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:
Install
- Install the "stable channel" version of Mono. (If this doesn't work, see Troubleshooting.)
- Download SMAPI.
- Open the Zip file you downloaded in the previous step to extract its contents.
- Open Terminal, and then enter the following command:
mdfind -0 'kMDItemFSName = "install on Mac.command" && kMDItemContentType = "com.apple.terminal.shell-script"' | xargs -0 xattr -d com.apple.quarantine - In Finder, open the file
install on Mac.command
, 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).
Note:
- Step 4 is necessary because, by default, Gatekeeper will prevent you from opening unsigned script files downloaded via the Internet.
- To open Terminal, open Launchpad, type Terminal, and then press return.
- You must reinstall Mono whenever you update macOS.
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
- Open the file
install on Mac.command
. - Choose to uninstall SMAPI.