Difference between revisions of "Modding:Installing SMAPI on Mac"

From Stardew Valley Wiki
Jump to navigation Jump to search
(→‎Install: + note for SMAPI 3.13.0)
Line 10: Line 10:
 
==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#"looks like Mono isn't installed" (Linux/Mac only)|Troubleshooting]].) {{SMAPI upcoming|3.13.0|inline=1|Install [https://dotnet.microsoft.com/download/dotnet/5.0 .NET 5] instead.}}
 
# 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#"looks like Mono isn't installed" (Linux/Mac only)|Troubleshooting]].) {{SMAPI upcoming|3.13.0|inline=1|Install [https://dotnet.microsoft.com/download/dotnet/5.0 .NET 5] instead.}}
 +
## For a pictorial guide to installing Mono, see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_Mono]].
 +
## For a pictorial guide to installing .NET 5, see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_.NET_5]].
 
# Download the [https://smapi.io/ latest version of SMAPI].
 
# Download the [https://smapi.io/ latest version of SMAPI].
 +
## For a pictorial guide to installing SMAPI, see [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI]].
 
# Extract the <tt>.zip</tt> file somewhere (but not in your game folder!).
 
# Extract the <tt>.zip</tt> file somewhere (but not in your game folder!).
 
# Double-click <tt>install on Mac.command</tt>¹, and follow the on-screen instructions.
 
# Double-click <tt>install on Mac.command</tt>¹, and follow the on-screen instructions.

Revision as of 04:00, 14 October 2021

Modding:Player Guide/header

This page explains how to install SMAPI (the tool which lets you use mods) on MacOS. See also:

Install

  1. Install Mono. (The 'stable channel' version is fine. If this doesn't work, see Troubleshooting.) As of the upcoming SMAPI 3.13.0: Install .NET 5 instead.
    1. For a pictorial guide to installing Mono, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_Mono.
    2. For a pictorial guide to installing .NET 5, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_.NET_5.
  2. Download the latest version of SMAPI.
    1. For a pictorial guide to installing SMAPI, see Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Installing_SMAPI.
  3. Extract the .zip file somewhere (but not in your game folder!).
  4. 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

  1. Launch the installer again (see install steps).
  2. When prompted, choose the uninstall option.

Troubleshooting

  • If the game freezes when loading a save with no error in the SMAPI window, try reinstalling Mono (see install step 1).
  • If the SMAPI window no longer appears after a game update, reinstall SMAPI to fix the launcher.
  • See the troubleshooting page for general troubleshooting.
Retrieved from "https://stardewvalleywiki.com/mediawiki/index.php?title=Modding:Installing_SMAPI_on_Mac&oldid=127793"