Changes

Using mods is easy! You just need to...

Using mods is easy! You just need to...

# Install SMAPI. That's the mod loader for Stardew Valley — it launches the game with mod support and lets mods interact directly with the game code. It's safely installed alongside your normal game, and you can uninstall it anytime.

# Install SMAPI. That's the mod loader for Stardew Valley — it launches the game with mod support and lets mods interact directly with the game code. It's safely installed alongside your normal game, and you can uninstall it anytime.

# Unzip mods into your <tt>Mods</tt> folder.

# Unzip mods into your <samp>Mods</samp> folder.

See [[#Frequent questions|frequent questions below]], or keep reading to get started!

See [[#Frequent questions|frequent questions below]], or keep reading to get started!

Yes, but it's extremely rare. Only a few mods affect your save file at all. If you avoid those, mods are very unlikely to corrupt your save file. In most cases, you can fix save corruption by [[Saves#Undo the last save|undoing the last save]].

Yes, but it's extremely rare. Only a few mods affect your save file at all. If you avoid those, mods are very unlikely to corrupt your save file. In most cases, you can fix save corruption by [[Saves#Undo the last save|undoing the last save]].

If you're worried, just back up [[Saves|your save files]] occasionally. That's strongly recommended even if you don't use mods, since save corruption is almost always caused by the game itself. SMAPI also creates a daily backup of your saves automatically; you can retrieve those from the <tt>Mods/SaveBackup</tt> folder.

If you're worried, just back up [[Saves|your save files]] occasionally. That's strongly recommended even if you don't use mods, since save corruption is almost always caused by the game itself. SMAPI also creates a daily backup of your saves automatically; you can retrieve those from the <samp>Mods/SaveBackup</samp> folder.

===Can I stop using mods later?===

===Can I stop using mods later?===

| &#32;

| &#32;

# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.

# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.

# Create a shortcut to the <tt>StardewModdingAPI.exe</tt> file (that <tt>.exe</tt> is inside [[#Find your game folder|your game folder]]).

# Create a shortcut to the <samp>StardewModdingAPI.exe</samp> file (that <samp>.exe</samp> is inside [[#Find your game folder|your game folder]]).

# Right-click the shortcut, choose <tt>Properties</tt>, and add this to the end of the <tt>Target</tt> field: <code> --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\SteamLibrary\steamapps\common\Stardew Valley\StardewModdingAPI.exe" --mods-path "Mods (multiplayer)"</code>.

# Right-click the shortcut, choose <samp>Properties</samp>, and add this to the end of the <samp>Target</samp> field: <code> --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\SteamLibrary\steamapps\common\Stardew Valley\StardewModdingAPI.exe" --mods-path "Mods (multiplayer)"</code>.

# Double-click that shortcut to launch SMAPI with the specified mod folder.

# Double-click that shortcut to launch SMAPI with the specified mod folder.

|-

|-

| &#32;

| &#32;

# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.

# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.

# Create a shortcut to your <tt>steam.exe</tt> file.

# Create a shortcut to your <samp>steam.exe</samp> file.

# Right-click the shortcut, choose <tt>Properties</tt>, and add this to the end of the <tt>Target</tt> field: <code>-applaunch 413150 --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\Steam\steam.exe" -applaunch 413150 --mods-path "Mods (multiplayer)"</code>.

# Right-click the shortcut, choose <samp>Properties</samp>, and add this to the end of the <samp>Target</samp> field: <code>-applaunch 413150 --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\Steam\steam.exe" -applaunch 413150 --mods-path "Mods (multiplayer)"</code>.

# Optionally you can click the <tt>"Change Icon..."</tt> button and browse to your Stardew Valley folder to change the icon of the shortcut from the Steam icon to the Stardew Valley Icon.

# Optionally you can click the <samp>"Change Icon..."</samp> button and browse to your Stardew Valley folder to change the icon of the shortcut from the Steam icon to the Stardew Valley Icon.

# Double-click that shortcut to make Steam launch SMAPI with the specified mod folder and all steam features.

# Double-click that shortcut to make Steam launch SMAPI with the specified mod folder and all steam features.

|-

|-

| <ol>

| <ol>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>

<li>Create a file like <tt>SMAPI_multiplayer.sh</tt> on your desktop.</li>

<li>Create a file like <samp>SMAPI_multiplayer.sh</samp> on your desktop.</li>

<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/StardewValley</tt> with the full path to the <tt>StardewValley</tt> file in [[#Find your game folder|your game folder]]):

<li>Edit the file and set the text to this (change the folder name as needed, and replace <samp>/path/to/StardewValley</samp> with the full path to the <samp>StardewValley</samp> file in [[#Find your game folder|your game folder]]):

<syntaxhighlight lang="bash">

<syntaxhighlight lang="bash">

#!/bin/bash

#!/bin/bash

| <ol>

| <ol>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>

<li>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</li>

<li>Create a file <samp>SMAPI_multiplayer.command</samp> on your desktop.</li>

<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/StardewValley/StardewModdingAPI.bin.osx</tt> with the full path to the <tt>StardewModdingAPI.bin.osx</tt> file in [[#Find your game folder|your game folder]]):

<li>Edit the file and set the text to this (change the folder name as needed, and replace <samp>/path/to/StardewValley/StardewModdingAPI.bin.osx</samp> with the full path to the <samp>StardewModdingAPI.bin.osx</samp> file in [[#Find your game folder|your game folder]]):

<syntaxhighlight lang="bash">

<syntaxhighlight lang="bash">

/path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"

/path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"

<li>Example: <code>~/Library/Application\ Support/Steam/steamapps/common/Stardew\ Valley/Contents/MacOS/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"</code></li>

<li>Example: <code>~/Library/Application\ Support/Steam/steamapps/common/Stardew\ Valley/Contents/MacOS/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"</code></li>

<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>

<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>

<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <tt>chmod u+x /path/to/SMAPI multiplayer.command</tt> to give yourself these access privileges.</li>

<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <samp>chmod u+x /path/to/SMAPI multiplayer.command</samp> to give yourself these access privileges.</li>

<li>Double-click the script to launch SMAPI with the specified mod folder.</li>

<li>Double-click the script to launch SMAPI with the specified mod folder.</li>

</ol>

</ol>

| <ol>

| <ol>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods(multiplayer)</code>. Note there shouldn't be a space between "Mods" and "(multiplayer)".</li>

<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods(multiplayer)</code>. Note there shouldn't be a space between "Mods" and "(multiplayer)".</li>

<li>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</li>

<li>Create a file <samp>SMAPI_multiplayer.command</samp> on your desktop.</li>

<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/steam_osx</tt> with the full path to the <tt>steam_osx</tt> file (you can find the path for <tt>steam_osx</tt> by using <tt>sudo find / -name steam_osx</tt>):

<li>Edit the file and set the text to this (change the folder name as needed, and replace <samp>/path/to/steam_osx</samp> with the full path to the <samp>steam_osx</samp> file (you can find the path for <samp>steam_osx</samp> by using <samp>sudo find / -name steam_osx</samp>):

<syntaxhighlight lang="bash">

<syntaxhighlight lang="bash">

/path/to/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"

/path/to/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"

<li>Example: <code>/Applications/Steam.app/Contents/MacOS/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"</code></li>

<li>Example: <code>/Applications/Steam.app/Contents/MacOS/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"</code></li>

<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>

<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>

<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <tt>chmod u+x /path/to/SMAPI multiplayer.command</tt> to give yourself these access privileges.</li>

<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <samp>chmod u+x /path/to/SMAPI multiplayer.command</samp> to give yourself these access privileges.</li>

<li>Double-click the script to make Steam launch SMAPI with the specified mod folder and all steam features.</li>

<li>Double-click the script to make Steam launch SMAPI with the specified mod folder and all steam features.</li>

</ol>

</ol>