Difference between revisions of "Modding:Installing SMAPI on Mac"
(Add names) |
|||
Line 32: | Line 32: | ||
** Click the lock button to make changes, and then use the + button to add Terminal to the list of apps. | ** 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. | ** 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. | ||
+ | https://iterm2.com/ | ||
+ | ** 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. | * See the [[Modding:Player Guide/Troubleshooting|troubleshooting page]] for general troubleshooting. | ||
Revision as of 01:56, 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.27t_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.