Changes

m
spelling correction
Line 17: Line 17:     
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 Mac|macOS]];
+
* [[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===
Line 40: Line 40:  
|-
 
|-
 
| [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]
Line 121: Line 121:  
Tips:
 
Tips:
 
<ul>
 
<ul>
<li>If you have a lot of mods, you can optionally organise them into subfolders. SMAPI will automatically search inside each folder until it finds one with files.
+
<li>If you have a lot of mods, you can optionally organize them into subfolders. SMAPI will automatically search inside each folder until it finds one with files.
 
<pre>
 
<pre>
 
📁 Stardew Valley/
 
📁 Stardew Valley/
Line 273: Line 273:     
===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.
Line 290: Line 290:  
===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"
Line 333: Line 335:  
</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)"
/path/to/StardewValley/StardewModdingAPI.bin.osx --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>
 
|-
 
|-
Line 351: Line 352:  
<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)"
Line 369: Line 370:  
   |next = [[../Troubleshooting|Troubleshooting]]
 
   |next = [[../Troubleshooting|Troubleshooting]]
 
}}
 
}}
 +
 +
[[Category:Modding]]
    
[[de:Modding:Spieleranleitung/Erste Schritte]]
 
[[de:Modding:Spieleranleitung/Erste Schritte]]
5

edits