32
edits
Changes
Jump to navigation
Jump to search
mLine 2:
Line 2: − ==Install .NET 5== − From the instructions page, it says to: Install [https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5]. − − If you have an M1 Mac, you may need a different version. See the other section, [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#For_M1_Macs_Only:_Install_.NET_5.0.11]]. If you're not sure if you have an M1 Mac, go to the apple in the top left, click "About My Mac", and look under processor. If it says M1, then you have an M1 Mac. − − The following image is what the .NET 5 link in the instructions takes you to. Click the download circled in red. − − [[File:Dotnetnewscreenshot.png|500px]] − − Once you download the installer, it will look like this. You should double click on it to open, or right click and select open. − − [[File:1b NET installer.png|500px]] − − When you open the installer, it will have a series of steps to walk you through the installation. The following pictures circle which buttons to click along the way. − − [[File:1c NET installer 1.png|500px]] − − [[File:1d NET installer 2.png|500px]] − − Once it finishes, it should look like this. You can delete the .NET 5 installer package if you like. − − [[File:1e NET installer success.png|500px]] − − ==For M1 Macs Only: Install .NET 5.0.11== − − It seems like, at least for some users on M1 Macs, installing .NET 5.0.11 fixes things. You're going to need to go to the .NET 5.0.11 Github page and download it, link is [https://github.com/dotnet/core/blob/main/release-notes/5.0/5.0.11/5.0.11.md the .NET 5.0.11 Github], and it should look as follows: − − [[File:Alternative M1 dotNet.png|500px]] − − Once you have downloaded this installer, run it (similar to above). Please note that this is not guaranteed to work! But it is worth a try. − Line 81:
Line 50: − + Line 92:
Line 61: + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Modding:Installing SMAPI on Mac Pictorial Guide (view source)
Revision as of 20:09, 25 July 2023
, 20:09, 25 July 2023→Find and save your Mods folder: Adding the actual game path
__TOC__
__TOC__
==Install SMAPI==
==Install SMAPI==
From the instructions page: Download the [https://smapi.io/ latest version of SMAPI].
From the instructions page: Download the [https://smapi.io/ latest version of SMAPI].
[[File:17 Finder go to folder.png|500px]]
[[File:17 Finder go to folder.png|500px]]
Once you have the menu open, paste in the game path you saved from earlier. If you didn't save it, you can guess it using the pattern from the finding your mods folder page.
Once you have the menu open, paste in the game path you saved from earlier. If you didn't save it, you can guess it using the pattern from the finding your mods folder page. The game path will be /Users/<username>/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS and the Mods folder will be /Users/<username>/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/Mods
[[File:18 go to folder path.png|500px]]
[[File:18 go to folder path.png|500px]]
[[File:20 make mods alias.png|500px]]
[[File:20 make mods alias.png|500px]]
==Manually Launching SMAPI on M1 Mac==
Recent versions of MacOS, particularly those that rely on M1 chips, may present an error when attempting to launch SMAPI.
[[File:Nullpermissions.png|220px]]
This error is telling you that SMAPI's attempt to auto-launch was blocked because of a permissions issue. You can manually override this error. First click on the information button (blue circle with italicized i), which will reveal a file path to the auto-launcher.
[[File:Nullpermissionsinfo.png|400px]]
Double-click on the document icon to open a Finder window showing the hidden tmp folder with the SMAPI launcher. The tmp folder is in the hidden private folder, so it is easiest to access it directly through the error message.
If this is the first time you are doing this, your file will likely say open-smapi-terminal.sh (this is the default launcher that is created when installing SMAPI, and will not naturally be read by M1 Terminal).
[[File:Tmpsh.png|500px]]
Right-click (two-fingered click on trackpad) on open-smapi-terminal.sh and select Get Info. In the "Open With" section, open the drop-down menu and go all the way to the bottom to select "Other...". Your Applications folder will open.
[[File:Getinfosh.png|240px]]
[[File:Openwithother.png|260px]]
(It does not matter what the default application is -- if yours is not Sublime Text, don't worry about it, we're changing it anyway. It must be set to Terminal for SMAPI to launch.)
In your Applications folder, scroll down to find the Utilities folder and open it. You should find Terminal listed here. Select it and click "Add."
[[File:Utilitiesfolder.png|500px]]
If it is grayed out, use the drop-down menu below the applications list to Enable "All Applications". All applications may temporarily gray out, but they will shortly become available. Select Terminal and click "Add."
[[File:Enableall.png|500px]]
After clicking Add you should be returned to the tmp folder where the SMAPI launcher resides. Double-click on it to launch SMAPI with Terminal.
You may find you have to manually launch SMAPI every time you want to play. Once you have set Terminal as the launching application, manually launching is as simple as clicking on the info button in the error message, opening the tmp folder, and then double-clicking either the .sh or the .command launcher file. Both will launch SMAPI in terminal.
==OLD, NOT USED ANYMORE: Install .NET 5==
In the past, before SMAPI bundled .NET 5.0, these instructions were useful. They should no longer be relevant.
From the instructions page, it says to: Install [https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5].
If you have an M1 Mac, you may need a different version. See the other section, [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#For_M1_Macs_Only:_Install_.NET_5.0.11]]. If you're not sure if you have an M1 Mac, go to the apple in the top left, click "About My Mac", and look under processor. If it says M1, then you have an M1 Mac.
The following image is what the .NET 5 link in the instructions takes you to. Click the download circled in red.
[[File:Dotnetnewscreenshot.png|500px]]
Once you download the installer, it will look like this. You should double click on it to open, or right click and select open.
[[File:1b NET installer.png|500px]]
When you open the installer, it will have a series of steps to walk you through the installation. The following pictures circle which buttons to click along the way.
[[File:1c NET installer 1.png|500px]]
[[File:1d NET installer 2.png|500px]]
Once it finishes, it should look like this. You can delete the .NET 5 installer package if you like.
[[File:1e NET installer success.png|500px]]
==OLD, NOT USED ANYMORE: For M1 Macs Only: Install .NET 5.0.11==
In the past, before SMAPI bundled .NET 5.0, these instructions were useful. They should no longer be relevant.
It seems like, at least for some users on M1 Macs, installing .NET 5.0.11 fixes things. You're going to need to go to [https://github.com/dotnet/core/blob/main/release-notes/5.0/5.0.11/5.0.11.md the .NET 5.0.11 Github] and download the thing circled in red below:
[[File:Alternative M1 dotNet.png|500px]]
Once you have downloaded this installer, run it (similar to above). Please note that this is not guaranteed to work! But it is worth a try.
[[Category:Modding]]
[[Category:Modding]]