Modding:Installing SMAPI on Mac Pictorial Guide - Revision history

imported>Rogue.toast: /* Install SMAPI */

2024-12-11T02:09:11Z

Install SMAPI

← Older revision		Revision as of 02:09, 11 December 2024
Line 34:		Line 34:
	\|		\|

	<span style="font-size:180%;">'''STEP 4'''</span>		<span style="font-size:180%;">'''STEP 4a'''</span>

	[[File:11 SMAPI open warning.png\|center\|300px]]		[[File:11 SMAPI open warning.png\|center\|300px]]
	\|\| After you select open, a pop-up ~~will warn~~ you that SMAPI was not made by a big company that registered the app with Apple. This is okay, so select open.		\|\| After you select open, you might receive a pop-up warning. This warning alerts you that SMAPI was not made by a big company that registered the app with Apple. This is okay, so select open, and proceed to '''Step 7'''.
			\|-
			\|

			<span style="font-size:180%;">'''STEP 4b'''</span>

			[[File:MacOS SMAPI Warning 1.png\|center\|300px]]
			\|\| After you select open, you might receive a pop-up warning. This warning alerts you that MacOS blocked the opening of the SMAPI installer. Click "done" and proceed to the next step.
	\|-		\|-
	\|		\|

	<span style="font-size:180%;">'''STEP 5'''</span>		<span style="font-size:180%;">'''STEP 5'''</span>

			[[File:MacOS SMAPI Install.png\|center\|300px]]
			\|\| To bypass, navigate to System Settings --> Security & Privacy. Scroll down until you see the "Security" section. There you will see a message stating that MacOS has blocked the installer. Select "Open Anyway" and proceed to the next step.
			\|-
			\|

			<span style="font-size:180%;">'''STEP 6'''</span>

			[[File:MacOS SMAPI Warning 2.png\|center\|300px]]
			\|\| Another warning message will pop-up, alerting you that Apple couldn't verify the safety of the installer. It's safe, so click "Open Anyway" and the installer will start running.
			\|-
			\|

			<span style="font-size:180%;">'''STEP 7'''</span>

	[[File:12 SMAPI terminal 1.png\|700px]]		[[File:12 SMAPI terminal 1.png\|700px]]
Line 51:		Line 72:
	\|		\|

	<span style="font-size:180%;">'''STEP 6'''</span>		<span style="font-size:180%;">'''STEP 8'''</span>

	[[File:13 SMAPI terminal 2.png\|700px]]		[[File:13 SMAPI terminal 2.png\|700px]]
Line 58:		Line 79:
	\|		\|

	<span style="font-size:180%;">'''STEP 7'''</span>		<span style="font-size:180%;">'''STEP 9'''</span>

	[[File:14 SMAPI terminal 3.png\|700px]]		[[File:14 SMAPI terminal 3.png\|700px]]
Line 68:		Line 89:
	\|		\|

	<span style="font-size:180%;">'''STEP 8'''</span>		<span style="font-size:180%;">'''STEP 10'''</span>

	[[File:15 SMAPI terminal success.png\|700px]]		[[File:15 SMAPI terminal success.png\|700px]]

imported>Rogue.toast: /* Manually Launching SMAPI on M1 Mac */

2024-04-03T23:34:09Z

Manually Launching SMAPI on M1 Mac

← Older revision		Revision as of 23:34, 3 April 2024
Line 171:		Line 171:
	\|		\|

	<span style="font-size:180%;">'''STEP 5'''</span>		<span style="font-size:180%;">'''STEP 6'''</span>

	[[File:Utilitiesfolder.png\|center\|500px]]		[[File:Utilitiesfolder.png\|center\|500px]]
Line 181:		Line 181:
	\|		\|

	<span style="font-size:180%;">'''STEP 6'''</span>		<span style="font-size:180%;">'''STEP 7'''</span>

	[[File:Tmpsh2.png\|center\|500px]]		[[File:Tmpsh2.png\|center\|500px]]

imported>Rogue.toast: /* Manually Launching SMAPI on M1 Mac */ reformatted to table

2024-04-03T23:33:26Z

Manually Launching SMAPI on M1 Mac: reformatted to table

← Older revision		Revision as of 23:33, 3 April 2024
Line 125:		Line 125:

	==Manually Launching SMAPI on M1 Mac==		==Manually Launching SMAPI on M1 Mac==
			MacOS versions that rely on M1 chips may present an error when attempting to launch SMAPI. This error indicates that SMAPI's attempt to auto-launch was blocked because of a permissions issue. The following should help resolve the error.
			{\| class="wikitable"
			\|-
			! Visual !! Instructions
			\|-
			\|

	~~Recent versions of MacOS, particularly those that rely on M1 chips, may present an error when attempting to launch SMAPI.~~		<span style="font-size:180%;">'''STEP 1'''</span>

	[[File:Nullpermissions.png\|220px]]		[[File:Nullpermissions.png\|center\|220px]]
			\|\|First click on the information button (blue circle with italicized i), which will reveal a file path to the auto-launcher.
			\|-
			\|

	~~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.		<span style="font-size:180%;">'''STEP 2'''</span>

	[[File:Nullpermissionsinfo.png\|400px]]		[[File:Nullpermissionsinfo.png\|center\|400px]]
			\|\|Double-click on the '''tmp''' folder icon to bring up a new Finder window for that folder. This folder is hidden, so the easiest way to access it is directly through the error message.
			\|-
			\|

	~~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.		<span style="font-size:180%;">'''STEP 3'''</span>

	~~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\|center\|500px]]
			\|\|The first time you do this, you'll need to locate the file likely named <samp>open-smapi-terminal.sh</samp>. (This is the default launcher created when installing SMAPI and isn't automatically read by M1 Terminal.)

	~~[[File:Tmpsh~~.~~png~~\|~~500px]]~~		Right-click (two-fingered click on trackpad) on <samp>open-smapi-terminal.sh</samp> and navigate to ''Get Info''.
			\|-
			\|

			<span style="font-size:180%;">'''STEP 4'''</span>

	~~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\|center\|300 px]]
			\|\|Locate the "Open With" section and click on the blue arrow box to open the drop-down menu.
			\|-
			\|

	~~[[File~~:~~Getinfosh.png\|240px]]~~		<span style="font-size:180%;">'''STEP 5'''</span>
	~~[[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~~.)		[[File:Openwithother.png\|center\|260px]]
			\|\|Scroll to the bottom of the list and select "Other...". This will open the Applications folder.

	~~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~~."		(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.)
			\|-
			\|

	~~[[File~~:~~Utilitiesfolder.png\|500px]]~~		<span style="font-size:180%;">'''STEP 5'''</span>

	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:Utilitiesfolder.png\|center\|500px]]
			\|\|Scroll down to find the "Utilities" folder and double-click to open it. Locate '''Terminal''', select it, and click the blue "Add" button.
			\|-
			\|[[File:Enableall.png\|center\|500px]]
			\|\|If '''Terminal''' 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]]~~		<span style="font-size:180%;">'''STEP 6'''</span>

	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.		[[File:Tmpsh2.png\|center\|500px]]
			\|\|After clicking "Add" you should be returned to the '''tmp''' folder from Step 2. Double-click on the file named <samp>open-smapi-terminal.command</samp> 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.		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.



	[[Category:Modding]]		[[Category:Modding]]


	==History==		==History==
	{{History\|Updated for SMAPI 4.0.0 and later.}}		{{History\|Updated for SMAPI 4.0.0 and later.}}

imported>Rogue.toast at 21:09, 31 March 2024

2024-03-31T21:09:47Z

← Older revision		Revision as of 21:09, 31 March 2024
Line 161:		Line 161:

	[[Category:Modding]]		[[Category:Modding]]


			==History==
			{{History\|Updated for SMAPI 4.0.0 and later.}}

imported>Rogue.toast at 21:06, 31 March 2024

2024-03-31T21:06:22Z

← Older revision		Revision as of 21:06, 31 March 2024
Line 159:		Line 159:
	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.		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]]

imported>Rogue.toast at 10:44, 31 March 2024

2024-03-31T10:44:49Z

← Older revision		Revision as of 10:44, 31 March 2024
Line 75:		Line 75:

	(Note: The game path is almost invisible in dark mode, so you may want to change to light mode.)		(Note: The game path is almost invisible in dark mode, so you may want to change to light mode.)
	\|
	\|}		\|}

Line 123:		Line 122:
	Repeat steps 1-3, substituting the Mods folder path in step 2:		Repeat steps 1-3, substituting the Mods folder path in step 2:
	<samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/Mods</samp>.		<samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/Mods</samp>.
	\|
	\|}		\|}

imported>Rogue.toast: /* Install SMAPI */ reduced image size for better readability

2024-03-31T10:43:54Z

Install SMAPI: reduced image size for better readability

← Older revision		Revision as of 10:43, 31 March 2024
Line 12:		Line 12:
	<span style="font-size:180%;">'''STEP 1'''</span>		<span style="font-size:180%;">'''STEP 1'''</span>

	[[File:8 SMAPI website.png\|~~750px~~]]		[[File:8 SMAPI website.png\|700px]]
	\|\| To start, pick an option for downloading -- any of these listed will work. Please be sure to check which version of SMAPI you need! SMAPI 4.0.0 or later will only work on SDV 1.6. If you are still playing SDV 1.5.6 you will need a previous version of SMAPI, which you can get from [https://github.com/Pathoschild/SMAPI/releases the GitHub Releases page.]		\|\| To start, pick an option for downloading -- any of these listed will work. Please be sure to check which version of SMAPI you need! SMAPI 4.0.0 or later will only work on SDV 1.6. If you are still playing SDV 1.5.6 you will need a previous version of SMAPI, which you can get from [https://github.com/Pathoschild/SMAPI/releases the GitHub Releases page.]

Line 22:		Line 22:
	<span style="font-size:180%;">'''STEP 2'''</span>		<span style="font-size:180%;">'''STEP 2'''</span>

	[[File:9 SMAPI installer.png\|~~750px~~]]		[[File:9 SMAPI installer.png\|700px]]
	\|\| Once unzipped, double-click on the folder to open its contents. Locate the <samp>install on macOS.command</samp> file.		\|\| Once unzipped, double-click on the folder to open its contents. Locate the <samp>install on macOS.command</samp> file.
	\|-		\|-
Line 43:		Line 43:
	<span style="font-size:180%;">'''STEP 5'''</span>		<span style="font-size:180%;">'''STEP 5'''</span>

	[[File:12 SMAPI terminal 1.png\|~~750px~~]]		[[File:12 SMAPI terminal 1.png\|700px]]
	\|\| Next, a new window should open in Terminal. If it doesn't, or if the window doesn't look like the next image, just quit Terminal and re-open the install file.		\|\| Next, a new window should open in Terminal. If it doesn't, or if the window doesn't look like the next image, just quit Terminal and re-open the install file.

Line 53:		Line 53:
	<span style="font-size:180%;">'''STEP 6'''</span>		<span style="font-size:180%;">'''STEP 6'''</span>

	[[File:13 SMAPI terminal 2.png\|~~750px~~]]		[[File:13 SMAPI terminal 2.png\|700px]]
	\|\| This step is to select your font color. Select one, input the number, and press enter.		\|\| This step is to select your font color. Select one, input the number, and press enter.
	\|-		\|-
Line 60:		Line 60:
	<span style="font-size:180%;">'''STEP 7'''</span>		<span style="font-size:180%;">'''STEP 7'''</span>

	[[File:14 SMAPI terminal 3.png\|~~800px~~]]		[[File:14 SMAPI terminal 3.png\|700px]]
	\|\| The final step is to choose where SMAPI will install. Option 1 is the default MacOS location -- '''Double check the file path is correct.''' For most users, it should read: <samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</samp>.		\|\| The final step is to choose where SMAPI will install. Option 1 is the default MacOS location -- '''Double check the file path is correct.''' For most users, it should read: <samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</samp>.

Line 70:		Line 70:
	<span style="font-size:180%;">'''STEP 8'''</span>		<span style="font-size:180%;">'''STEP 8'''</span>

	[[File:15 SMAPI terminal success.png\|~~800px~~]]		[[File:15 SMAPI terminal success.png\|700px]]
	\|\| If successfully installed, you should see that two bundled mods were installed: Console Commands and Save Backup. You will then see "SMAPI is installed!" on the last line. Copy and save the game path at the top of the window for when you want to find your Mods folder.		\|\| If successfully installed, you should see that two bundled mods were installed: Console Commands and Save Backup. You will then see "SMAPI is installed!" on the last line. Copy and save the game path at the top of the window for when you want to find your Mods folder.

imported>Rogue.toast: /* Find and save your Mods folder */ reformatted to remove section headers

2024-03-31T10:41:35Z

Find and save your Mods folder: reformatted to remove section headers

← Older revision		Revision as of 10:41, 31 March 2024
Line 86:		Line 86:
	\|		\|

	==='''STEP 1'''~~===~~		<span style="font-size:180%;">'''STEP 1'''</span>

	[[File:17 Finder go to folder.png\|500px]]		[[File:17 Finder go to folder.png\|500px]]
	\|\|Start by opening the Finder menu.		\|\|Start by opening the Finder menu.
Line 94:		Line 95:
	\|		\|

	==='''STEP 2'''~~===~~		<span style="font-size:180%;">'''STEP 2'''</span>

	[[File:18 go to folder path.png\|500px]]		[[File:18 go to folder path.png\|500px]]
	\|\|Paste in the game path you saved from earlier. The default game path is:		\|\|Paste in the game path you saved from earlier. The default game path is:
Line 101:		Line 103:
	\|		\|

	==='''STEP 3'''~~===~~		<span style="font-size:180%;">'''STEP 3'''</span>

	[[File:19 make alias.png\|500px]]		[[File:19 make alias.png\|500px]]
	\|\|Hit return or select "Go," and Finder will take you directly to the /MacOS folder. This is especially helpful if you want to switch between different sets of mods.		\|\|Hit return or select "Go," and Finder will take you directly to the /MacOS folder. This is especially helpful if you want to switch between different sets of mods.
Line 113:		Line 116:
	\|		\|

	==='''STEP 4'''~~===~~		<span style="font-size:180%;">'''STEP 4'''</span>

	[[File:20 make mods alias.png\|500px]]		[[File:20 make mods alias.png\|500px]]
	\|\|To simplify the process further, you can make an alias of just your Mods folder. Then all you have to do to add mods is drag and drop the unzipped folders into this one. '''It is very important to put mods in this folder and not anywhere else, or they will not work because SMAPI will not find them!'''		\|\|To simplify the process further, you can make an alias of just your Mods folder. Then all you have to do to add mods is drag and drop the unzipped folders into this one. '''It is very important to put mods in this folder and not anywhere else, or they will not work because SMAPI will not find them!'''

imported>Rogue.toast: /* Install SMAPI */ reformatted to remove section headers

2024-03-31T10:40:16Z

Install SMAPI: reformatted to remove section headers

← Older revision		Revision as of 10:40, 31 March 2024
Line 10:		Line 10:
	\|-		\|-
	\|		\|
	==='''STEP 1'''~~===~~		<span style="font-size:180%;">'''STEP 1'''</span>

	[[File:8 SMAPI website.png\|750px]]		[[File:8 SMAPI website.png\|750px]]
	\|\| To start, pick an option for downloading -- any of these listed will work. Please be sure to check which version of SMAPI you need! SMAPI 4.0.0 or later will only work on SDV 1.6. If you are still playing SDV 1.5.6 you will need a previous version of SMAPI, which you can get from [https://github.com/Pathoschild/SMAPI/releases the GitHub Releases page.]		\|\| To start, pick an option for downloading -- any of these listed will work. Please be sure to check which version of SMAPI you need! SMAPI 4.0.0 or later will only work on SDV 1.6. If you are still playing SDV 1.5.6 you will need a previous version of SMAPI, which you can get from [https://github.com/Pathoschild/SMAPI/releases the GitHub Releases page.]
Line 19:		Line 20:
	\|		\|

	==='''STEP 2'''~~===~~		<span style="font-size:180%;">'''STEP 2'''</span>

	[[File:9 SMAPI installer.png\|750px]]		[[File:9 SMAPI installer.png\|750px]]
	\|\| Once unzipped, double-click on the folder to open its contents. Locate the <samp>install on macOS.command</samp> file.		\|\| Once unzipped, double-click on the folder to open its contents. Locate the <samp>install on macOS.command</samp> file.
Line 25:		Line 27:
	\|		\|

	=== '''STEP 3''' ~~===~~		<span style="font-size:180%;">'''STEP 3'''</span>
	[[File:10 SMAPI installer open.png\|400px]]
			[[File:10 SMAPI installer open.png\|center\|400px]]
	\|\| Highlight the file, right click on it (on a trackpad, two finger click), and select open.		\|\| Highlight the file, right click on it (on a trackpad, two finger click), and select open.
	\|-		\|-
	\|		\|

	=== '''STEP 4''' ~~===~~		<span style="font-size:180%;">'''STEP 4'''</span>
	[[File:11 SMAPI open warning.png\|300px]]
			[[File:11 SMAPI open warning.png\|center\|300px]]
	\|\| After you select open, a pop-up will warn you that SMAPI was not made by a big company that registered the app with Apple. This is okay, so select open.		\|\| After you select open, a pop-up will warn you that SMAPI was not made by a big company that registered the app with Apple. This is okay, so select open.
	\|-		\|-
	\|		\|

	=== '''STEP 5''' ~~===~~		<span style="font-size:180%;">'''STEP 5'''</span>

	[[File:12 SMAPI terminal 1.png\|750px]]		[[File:12 SMAPI terminal 1.png\|750px]]
	\|\| Next, a new window should open in Terminal. If it doesn't, or if the window doesn't look like the next image, just quit Terminal and re-open the install file.		\|\| Next, a new window should open in Terminal. If it doesn't, or if the window doesn't look like the next image, just quit Terminal and re-open the install file.
Line 46:		Line 51:
	\|		\|

	=== '''STEP 6''' ~~===~~		<span style="font-size:180%;">'''STEP 6'''</span>

	[[File:13 SMAPI terminal 2.png\|750px]]		[[File:13 SMAPI terminal 2.png\|750px]]
	\|\| This step is to select your font color. Select one, input the number, and press enter.		\|\| This step is to select your font color. Select one, input the number, and press enter.
Line 52:		Line 58:
	\|		\|

	=== '''STEP 7''' ~~===~~		<span style="font-size:180%;">'''STEP 7'''</span>

	[[File:14 SMAPI terminal 3.png\|800px]]		[[File:14 SMAPI terminal 3.png\|800px]]
	\|\| The final step is to choose where SMAPI will install. Option 1 is the default MacOS location -- '''Double check the file path is correct.''' For most users, it should read: <samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</samp>.		\|\| The final step is to choose where SMAPI will install. Option 1 is the default MacOS location -- '''Double check the file path is correct.''' For most users, it should read: <samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</samp>.
Line 61:		Line 68:
	\|		\|

	=== '''STEP 8''' ~~===~~		<span style="font-size:180%;">'''STEP 8'''</span>

	[[File:15 SMAPI terminal success.png\|800px]]		[[File:15 SMAPI terminal success.png\|800px]]
	\|\| If successfully installed, you should see that two bundled mods were installed: Console Commands and Save Backup. You will then see "SMAPI is installed!" on the last line. Copy and save the game path at the top of the window for when you want to find your Mods folder.		\|\| If successfully installed, you should see that two bundled mods were installed: Console Commands and Save Backup. You will then see "SMAPI is installed!" on the last line. Copy and save the game path at the top of the window for when you want to find your Mods folder.

imported>Rogue.toast: /* Find and save your Mods folder */ reformat into table

2024-03-31T09:47:31Z

Find and save your Mods folder: reformat into table

← Older revision		Revision as of 09:47, 31 March 2024
Line 71:		Line 71:

	==Find and save your Mods folder==		==Find and save your Mods folder==
	~~On a Mac, if~~ you~~'ve~~ saved ~~where~~ SMAPI ~~installed mods~~, you can ~~use~~ Finder ~~functions~~ to ~~get~~ to your Mods folder, then save an alias ~~of your Mods folder~~ somewhere convenient.		Using the game path you copied & saved during SMAPI installation, you can direct Finder to go directly to your Mods folder, where you can then save an alias somewhere convenient.
			{\| class="wikitable"
	~~Start by going to the Finder menu and going to Go, then Go to Folder.~~		\|-
			! Visual !! Instructions
			\|-
			\|

			==='''STEP 1'''===
	[[File:17 Finder go to folder.png\|500px]]		[[File:17 Finder go to folder.png\|500px]]
			\|\|Start by opening the Finder menu.

	~~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		Navigate to "Go," then "Go to Folder."
			\|-
			\|

			==='''STEP 2'''===
	[[File:18 go to folder path.png\|500px]]		[[File:18 go to folder path.png\|500px]]
			\|\|Paste in the game path you saved from earlier. The default game path is:
			<samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</samp>.
			\|-
			\|

			==='''STEP 3'''===
			[[File:19 make alias.png\|500px]]
			\|\|Hit return or select "Go," and Finder will take you directly to the /MacOS folder. This is especially helpful if you want to switch between different sets of mods.


	Once you hit return, it will take you to your Mods folder. It's inside a folder named MacOS, which is helpful to be able to navigate to later, especially if you want to switch between different sets of mods. To ~~make your life easier, you can~~ make an alias ~~of this~~ folder ~~by right clicking~~ and ~~selecting~~ Make Alias~~, then moving~~ the alias ~~somewhere convenient like your Documents or Desktop~~.		To make an alias, right click on the folder and select "Make Alias" from the menu. This will create a new folder named "MacOS alias."

	~~[[File:19 make alias.png\|500px]]~~

	~~If you prefer to keep things simple~~, ~~you can make an~~ alias ~~of just~~ your ~~mods folder. Then all you have to do to add mods is drag and drop their unzipped folders into this~~ folder. ~~It is very important to put mods in this folder and not anywhere else, or they will not work because SMAPI will not find them!~~		Next, move the alias somewhere convenient like your Documents folder or on your Desktop.
			\|-
			\|

			==='''STEP 4'''===
	[[File:20 make mods alias.png\|500px]]		[[File:20 make mods alias.png\|500px]]
			\|\|To simplify the process further, you can make an alias of just your Mods folder. Then all you have to do to add mods is drag and drop the unzipped folders into this one. '''It is very important to put mods in this folder and not anywhere else, or they will not work because SMAPI will not find them!'''

			Repeat steps 1-3, substituting the Mods folder path in step 2:
			<samp>/Users/username/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/Mods</samp>.
			\|
			\|}

	==Manually Launching SMAPI on M1 Mac==		==Manually Launching SMAPI on M1 Mac==