translators
8,445
edits
Changes
Jump to navigation
Jump to search
Line 1:
Line 1: − + − + − * [[Modding:Installing SMAPI on Linux|Instructions for Linux]]+ − * [[Modding:Installing SMAPI on Windows|Instructions for Windows]]+ − # 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 [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). − + + + + − * 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. − + Line 28:
Line 23: − + − # Choose to uninstall SMAPI.+ + + + + + + + + + + + + Line 35:
Line 42: + + + +
→Install: change double-click to right-click + open (this allows bypassing some security restrictions for newly downloaded files)
{{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.
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: 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]]
'''Note''':
# 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.¹
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>
<small>¹To install manually instead, see instructions in the installer's readme.</small>
==Update==
==Update==
==Uninstall==
==Uninstall==
# Open the file <code>install on Mac.command</code>.
# 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 <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
|next =
|next =
}}
}}
[[de:Modding:SMAPI auf Mac]]
[[es:Modding:Instalar SMAPI en Mac]]
[[zh:模组:在Mac上安装SMAPI]]