105,906
edits
Changes
Jump to navigation
Jump to search
Line 17:
Line 17: − + + − * [[Modding:Installing SMAPI on Mac|macOS]];+ − + − Line 29:
Line 29: − + Line 40:
Line 40: − + Line 64:
Line 64: − + Line 74:
Line 74: + + Line 106:
Line 108: − − ====Finding and Saving Your Game Folder on a Mac==== − − If you need help finding or saving your Mods folder on a Mac, you can try this: [[Modding:Installing_SMAPI_on_Mac_Pictorial_Guide#Find_and_save_your_Mods_folder|Mac Pictorial Guide]] Line 275:
Line 273: − + − + Line 292:
Line 290: + + Line 313:
Line 313: + + + + + + + + Line 327:
Line 335: − + − + − + − + − + − /path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)" − + − + − + Line 345:
Line 352: − + Line 363:
Line 370: + + − +
no edit summary
See the instructions for:
See the instructions for:
* [[Modding:Installing SMAPI on Android|Android]];
* [[Modding:Installing SMAPI on Windows|Windows]];
* [[Modding:Installing SMAPI on Mac|macOS]];
* [[Modding:Installing SMAPI on Linux|Linux]];
* [[Modding:Installing SMAPI on Linux|Linux]];
* [[Modding:Installing SMAPI on Steam Deck|Steam Deck]] (the handheld console);
* [[Modding:Installing SMAPI on Steam Deck|Steam Deck]];
* or [[Modding:Installing SMAPI on Android|Android]].
* or [[Modding:Installing SMAPI on Windows|Windows]].
===Find mods===
===Find mods===
<li>[https://www.nexusmods.com/stardewvalley/mods/topalltime/ most popular mods on Nexus];</li>
<li>[https://www.nexusmods.com/stardewvalley/mods/topalltime/ most popular mods on Nexus];</li>
<li>[https://gist.github.com/Pathoschild/b608892d3e60bd25d0eea71ca7584649 recommendations for a first playthrough];</li>
<li>[https://gist.github.com/Pathoschild/b608892d3e60bd25d0eea71ca7584649 recommendations for a first playthrough];</li>
<li>[https://stardewmodding.miraheze.org/wiki/Category:Recommendations recommendations from other players];</li>
<li>[https://stardewmodding.wiki.gg/wiki/Category:Recommendations recommendations from other players];</li>
<li>search for mods here:
<li>search for mods here:
{| class="wikitable"
{| class="wikitable"
|-
|-
| [https://www.moddrop.com/stardew-valley/ ModDrop]
| [https://www.moddrop.com/stardew-valley/ ModDrop]
| Many mods are released here.<br /><small>You can use their ModDrop client (Windows only) to install/manage/auto-update your mods, or download mods directly from the website without registration needed.</small>
| Many mods are released here.<br /><small>You can use their ModDrop client (Windows only) to install/manage/auto-update your mods.</small>
|-
|-
| [https://forums.stardewvalley.net/index.php?resources/ Official forums]
| [https://forums.stardewvalley.net/index.php?resources/ Official forums]
|-
|-
| Windows
| Windows
| GOG: <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</code><br /> or <code>C:\GOG Games\Stardew Valley</code><br />Steam: <code>C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</code><br />Xbox App：<code>C:\Program Files\ModifiableWindowsApps\Stardew Valley</code>
| GOG: <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</code><br /> or <code>C:\GOG Games\Stardew Valley</code><br />Steam: <code>C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</code><br />Xbox App：<code>C:\XboxGames\Stardew Valley</code>
|-
|-
| Android
| Android
| Mac
| Mac
| GOG: <code>/Applications/Stardew Valley.app/Contents/MacOS</code><br />Steam: <code>~/Library/Application Support/Steam/SteamApps/common/Stardew Valley/Contents/MacOS</code>
| GOG: <code>/Applications/Stardew Valley.app/Contents/MacOS</code><br />Steam: <code>~/Library/Application Support/Steam/SteamApps/common/Stardew Valley/Contents/MacOS</code>
See also a [[Modding:Installing SMAPI on Mac Pictorial Guide#Find and save your Mods folder|pictorial guide to finding the folder on macOS]].
|}
|}
For images, please see [[Modding:Installing_SMAPI_on_Windows#Xbox_app]]
For images, please see [[Modding:Installing_SMAPI_on_Windows#Xbox_app]]
}}
}}
===Install mods===
===Install mods===
===What is SMAPI?===
===What is SMAPI?===
SMAPI is the mod loader for Stardew Valley. It works fine with GOG and Steam achievements, it's compatible with Linux/Mac/Windows and (unofficially) Android, you can uninstall it anytime, and there's a friendly community if you need help. SMAPI is required for most types of Stardew Valley mod.
SMAPI is the mod loader for Stardew Valley. It works fine with GOG and Steam achievements, it's compatible with Linux/Mac/Windows and (unofficially) Android, you can uninstall it anytime, and there's a friendly community if you need help. SMAPI is required for most types of Stardew Valley mods.
SMAPI does a lot for you. For example, it will...
SMAPI does a lot for you. For example, it will...
# Load mods into the game and provide APIs they can use. Many types of mod aren't possible without SMAPI.
# Load mods into the game and provide APIs they can use. Many types of mods aren't possible without SMAPI.
# Rewrite mods for crossplatform compatibility, so you can use almost any mod on any platform.
# Rewrite mods for crossplatform compatibility, so you can use almost any mod on any platform.
# Intercept errors. If a mod crashes or causes an error, SMAPI will intercept the error, show the error details in the console window, and in most cases automatically recover the game.
# Intercept errors. If a mod crashes or causes an error, SMAPI will intercept the error, show the error details in the console window, and in most cases automatically recover the game.
===Can I have different mod groups?===
===Can I have different mod groups?===
Yep, SMAPI has built-in support for different mod groups. The instructions may seem complex, but it's easy once you get the hang of it:
Yep, SMAPI has built-in support for different mod groups. The instructions may seem complex, but it's easy once you get the hang of it:
For simplicity, you can also just rename the Mods folder to something else.
{| class="wikitable"
{| class="wikitable"
# 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.
# 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.
|-
|-
| Windows (Steam, Non-Steam Game Method)
|  
# 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>.
# Add SMAPI as a Non-Steam Game to your library a second time. Follow the second set of instructions in [[Modding:Installing SMAPI on Windows#Steam|installing SMAPI on Windows]] - it is highly suggested you alter the title in your Steam Library to differentiate between mod groups, such as "Stardew Valley Modded" and "Stardew Valley Modded Multiplayer".
# Right-click the new SMAPI entry in your Steam Library, select "Properties", and add this to the end of the Target field: <code> --mods-path "Mods (multiplayer)"</code>. '''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>.
# Click the "Play" button in the new SMAPI entry in Steam to make Steam launch SMAPI with the specified mod folder and all Steam features.
|-
|-
| Linux
| Linux
</ol>
</ol>
|-
|-
| Mac
| Mac (non-Steam)
| <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> (no spaces).</li>
<li>Create a file <samp>SMAPI_multiplayer.command</samp> on your desktop.</li>
<li>Create a text file on your desktop with the same name as the mod group, for example <samp>SMAPI_multiplayer</samp> and format as Plain Text.</li>
<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]]):
<li>Input ~ followed by your folder path ([[#Find your game folder|your game folder]]). Add the following text to the end of the string:
<syntaxhighlight lang="bash">
<syntaxhighlight lang="bash"> --mods-path "Mods(multiplayer)"
</syntaxhighlight></li>
</syntaxhighlight></li>
<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 --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>Save the file, then 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: <samp>chmod u+x /path/to/SMAPI multiplayer.command</samp> 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 on your desktop to launch SMAPI with the specified mod folder.</li>
</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 <samp>SMAPI_multiplayer.command</samp> 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 <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>):
<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>find /Applications -name steam_osx</samp> or if that does not work use the longer search <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)"
|next = [[../Troubleshooting|Troubleshooting]]
|next = [[../Troubleshooting|Troubleshooting]]
}}
}}
[[Category:Modding]]
[[de:Modding:Spieleranleitung/Erste Schritte]]
[[de:Modding:Spieleranleitung/Erste Schritte]]
[[es: Modding:Guía del jugador/Introducción]]
[[es:Modding:Guía del jugador/Introducción]]
[[fr:Modding:Guide Joueur/Commencer]]
[[fr:Modding:Guide Joueur/Commencer]]
[[pt:Modificações:Guia do Jogador/Começando]]
[[pt:Modificações:Guia do Jogador/Começando]]
[[ru:Модификации:Руководство по использованию модификаций/Введение]]
[[ru:Модификации:Руководство по использованию модификаций/Введение]]
[[zh:模组:使用指南/入门]]
[[zh:模组:使用指南/入门]]