2.280
Bearbeitungen
Änderungen
Zur Navigation springen
Zur Suche springen
Modding:SMAPI auf Windows (Quelltext anzeigen)
Version vom 10. Mai 2021, 03:16 Uhr
, 03:16, 10. Mai 2021Erstellt, Links übersetzt, Installation A+B übersetzt
{{Modding:Spieleranleitung/Überschrift}}
{{Übersetzen}}
Diese Seite erklärt, wie du SMAPI (das Werkzeug welches dich Mods verwenden lässt) auf Linux installieren kannst. Siehe auch:
* [[:en:Modding:Installing SMAPI on Android|[Englisch] Anleitung für Android]]
* [[Modding:SMAPI auf Linux|Anleitung für Linux]]
* [[Modding:SMAPI auf Mac|Anleitung für Mac]]
__TOC__
==Installation==
===Option A: Nutze SMAPIs Installationsprogramm===
: ''Siehe auch [https://www.youtube.com/watch?v=9ULXeC9CL0c inoffizielle Videoanleitung (Englisch)].''
:# Starte das Spiel mindestens einmal ohne SMAPI (damit es eine Ersteinrichtung durchführen kann).
:# Lade die [https://smapi.io/ neueste Version von SMAPI herunter].
:# Extrahiere die <tt>.zip</tt> Datei irgendwo (aber nicht im Spielordner!).
:# Doppelklick <tt>install on Windows.bat</tt>¹ und folge den Bildschirmanweisungen.
:# Siehe [[#Starte SMAPI über Steam oder GOG Galaxy|Launch SMAPI through Steam or GOG Galaxy]] für die letzten Schritte.
<small>¹ Informationen zur manuellen Installation können in den Anweisungen der Readme-Datei im Installationsprogramm gefunden werden.</small>
===Option B: Nutze ModDrop===
ModDrop ist ein Mod-Manager, der SMAPI unterstützt. Es kann SMAPI installieren, auf dem neuesten Stand halten und die Installation und das Aktualisieren von Mods vereinfachen.
# [https://www.moddrop.com Installiere ModDrop] und öffne den Clienten.
# In the top-right corner, click ''Install SMAPI'' or ''Update Available''.
# A window should appear that says something like "A new version of SMAPI is available." Click the ''Install'' button and follow the on-screen instructions.
===Option C: Benutze Vortex===
Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods.
:# Log into a [https://www.nexusmods.com Nexus Mods] account.
:# Install and launch [https://www.nexusmods.com/about/vortex/ Vortex].
:# Click the ''Log In or Register'' button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the ''Mod Manager Download'' buttons on Nexus mod pages. Accept the authorization.
:# Set up Stardew Valley in Vortex by clicking the left-hand ''games'' tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand ''Settings'' tab.
:# Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI.
:# After SMAPI is installed in Vortex, click ''enable'' and you're done!
:# See [[#Launch SMAPI through Steam or GOG Galaxy|Launch SMAPI through Steam or GOG Galaxy]] for the final steps.
==Aktualisiere SMAPI==
===Option A: use SMAPI's installer===
Just install the new version; the installer will automatically clean up previous versions. (You don't need to configure Steam again.)
===Option B: use ModDrop===
If you use the [https://www.moddrop.com ModDrop mod manager]:
# Click ''Update Available'' in the top-right if it appears.
# Follow the on-screen instructions.
===Option C: use Vortex===
If you use the [https://www.nexusmods.com/about/vortex/ Vortex mod manager]:
# Go to {{nexus mod|2400|SMAPI's mod page}} and download it using the ''Mod Manager Download'' button.
# Click ''Open Vortex'' when the popup appears.
# Click the Vortex window, and the notification bell will appear with a notification in the upper right. Click ''install'' and then ''enable''.
==Deinstallieren==
# Run [[#Install|run the installer]] again, but choose ''uninstall'' to remove SMAPI.
# If you [[#Launch SMAPI through Steam or GOG Galaxy|configured Steam or GOG Galaxy]] to launch SMAPI, undo your changes:
#* '''Steam:''' in the Steam client: right-click on ''Stardew Valley'', choose ''Properties > General > Set Launch Options'', and blank the launch options textbox.
#* '''GOG Galaxy:''' in the GOG Galaxy client: click on Stardew Valley, click the settings icon next to the 'Play' button, click ''Manage installation > Configure'', and clear the ''Custom executables / arguments'' checkbox.
(If you want to play without mods temporarily, you can just launch <tt>Stardew Valley.exe</tt> directly or rename your <tt>Mods</tt> folder instead.)
==Starte SMAPI über Steam oder GOG Galaxy==
If you use Steam or GOG Galaxy, and want them to track your achievements and game time, you can configure them to launch SMAPI.
If you don't care about achievements or tracking game time, you can just launch <tt>StardewModdingAPI.exe</tt> in [[Modding:Spieleranleitung/Erste_Schritte#Finde_deinen_Spielordner|your game folder]] to play with mods.
===Steam===
You can launch SMAPI through the Steam client to enable the overlay and achievements.
# Keep SMAPI's installer window open.<br /><small>(If you already closed it, just run it again. No need to uninstall first.)</small>
# Copy the text '''in the installer window''' that looks like this ([https://community.playstarbound.com/threads/smapi-stardew-modding-api.108375/page-139#post-3292321 see how to copy text]):<br />[[File:Modding - installing SMAPI on Windows - installer Steam text.png]]<br />'''Make sure you copy the entire line, including both quotation marks <code>"</code> and the <code>%command%</code> part.''' <br /><small>Your final path should look something like this: <code>"Your path here" %command%</code></small>
# In the Steam client, right-click on ''Stardew Valley'' and choose ''Properties'':<br />[[File:Modding - installing SMAPI on Windows - Steam 1.png]]
# Click the textbox under ''Launch Options'':<br />[[File:Modding - installing SMAPI on Windows - Steam 2.png]]
# Replace anything in the textbox with the text you copied from the installer.<br /><small>To paste text, click in the box and press {{key|CTRL}} and {{key|V}}.</small>
# Click OK to save your changes.
# From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.
===GOG Galaxy===
You can use SMAPI through the GOG Galaxy client to track your play time. The steps below tell GOG Galaxy to launch a batch script, which in turn launches StardewModdingAPI.exe. This is because telling GOG Galaxy to launch StardewModdingAPI.exe directly causes the SMAPI console to be invisible, which can hide important errors and warning messages.
# Open Notepad and paste in the following: <code>start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"</code> If Stardew Valley and SMAPI are not installed at <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\</code>, (the default location for most people), replace that location with the location of where you installed Stardew Valley.
# Click on File, then Save As... <br />[[File:Save_batch_script.png|800px]]
# Navigate to your Stardew Valley installation folder and change the file type from Text Documents to All Files as shown below and then click Save. <br />[[File:Choose_batch_extension.png|800px]]
# Then type <code>start.bat</code> for the file name as shown below <br />[[File:Name_batch_script.png|800px]]
# In the GOG Galaxy client, click on Stardew Valle' and then the settings icon on the right-hand side of the 'Play' button, then hover over 'Manage installation' and click 'Configure...' as shown below. <br /> [[File:Gog_galaxy_configure.png|800px]]
# A new menu will appear. Check the "Custom executables / arguments" box. <br />[[File:Gog_galaxy_custom_launch.png|400px]]
# Then click 'Add another executable / arguments' <br /> [[File:Gog_galaxy_add_exectuable.png|400px]]
# Select start.bat in the window that appears and then click Open. <br />[[File:Select_batch_file.png|800px]]
# Finally, click the circle next to 'Default Executable' underneath File 2, then click OK. <br />[[File:Gog_galaxy_select_default_executable.png|400px]]
# From now on, you can launch Stardew Valley through GOG Galaxy and both the SMAPI console and game will load as expected!
==Fehlerbehebung==
==="Oops, couldn't find the game automatically"===
If the installer shows that message, you can help it find the game folder. To do that:
# Exit the installer.
# [[Modding:Spieleranleitung/Erste_Schritte#Finde_deinen_Spielordner|Finde deinen Spielordner]].
# Move the installer '''folder''' into the game folder. (Make sure you move the whole folder, not just the files inside it!)
# Run the installer again and it should auto-detect the game folder now.
You can safely delete the installer folder when it's done.
===Probleme mit SMAPI oder Mods===
See the [[Modding:Spieleranleitung/Problembehebung|troubleshooting page]] for help with issues after installation.
{{Modding Anleitung Fußnote
|prev = [[Modding:Spieleranleitung/Erste Schritte|Erste Schritte]]
|next =
}}
[[en:Modding:Installing SMAPI on Windows]]
[[es:Modding:Instalar SMAPI en Windows]]
[[zh:使用模组:在Windows上安装SMAPI]]
{{Übersetzen}}
Diese Seite erklärt, wie du SMAPI (das Werkzeug welches dich Mods verwenden lässt) auf Linux installieren kannst. Siehe auch:
* [[:en:Modding:Installing SMAPI on Android|[Englisch] Anleitung für Android]]
* [[Modding:SMAPI auf Linux|Anleitung für Linux]]
* [[Modding:SMAPI auf Mac|Anleitung für Mac]]
__TOC__
==Installation==
===Option A: Nutze SMAPIs Installationsprogramm===
: ''Siehe auch [https://www.youtube.com/watch?v=9ULXeC9CL0c inoffizielle Videoanleitung (Englisch)].''
:# Starte das Spiel mindestens einmal ohne SMAPI (damit es eine Ersteinrichtung durchführen kann).
:# Lade die [https://smapi.io/ neueste Version von SMAPI herunter].
:# Extrahiere die <tt>.zip</tt> Datei irgendwo (aber nicht im Spielordner!).
:# Doppelklick <tt>install on Windows.bat</tt>¹ und folge den Bildschirmanweisungen.
:# Siehe [[#Starte SMAPI über Steam oder GOG Galaxy|Launch SMAPI through Steam or GOG Galaxy]] für die letzten Schritte.
<small>¹ Informationen zur manuellen Installation können in den Anweisungen der Readme-Datei im Installationsprogramm gefunden werden.</small>
===Option B: Nutze ModDrop===
ModDrop ist ein Mod-Manager, der SMAPI unterstützt. Es kann SMAPI installieren, auf dem neuesten Stand halten und die Installation und das Aktualisieren von Mods vereinfachen.
# [https://www.moddrop.com Installiere ModDrop] und öffne den Clienten.
# In the top-right corner, click ''Install SMAPI'' or ''Update Available''.
# A window should appear that says something like "A new version of SMAPI is available." Click the ''Install'' button and follow the on-screen instructions.
===Option C: Benutze Vortex===
Vortex is a mod manager by Nexus Mods. It can install SMAPI, keep it updated, and simplify installing/updating mods.
:# Log into a [https://www.nexusmods.com Nexus Mods] account.
:# Install and launch [https://www.nexusmods.com/about/vortex/ Vortex].
:# Click the ''Log In or Register'' button in the upper-middle part of the Vortex main screen. A web browser should open asking whether to authorize Vortex to sync with your Nexus Mods account. That enables the ''Mod Manager Download'' buttons on Nexus mod pages. Accept the authorization.
:# Set up Stardew Valley in Vortex by clicking the left-hand ''games'' tab, finding Stardew Valley, and clicking it. You may wish to set up the download folder locations as well in the left-hand ''Settings'' tab.
:# Click the notification bell in the upper-right hand corner, which will prompt you to download and install SMAPI.
:# After SMAPI is installed in Vortex, click ''enable'' and you're done!
:# See [[#Launch SMAPI through Steam or GOG Galaxy|Launch SMAPI through Steam or GOG Galaxy]] for the final steps.
==Aktualisiere SMAPI==
===Option A: use SMAPI's installer===
Just install the new version; the installer will automatically clean up previous versions. (You don't need to configure Steam again.)
===Option B: use ModDrop===
If you use the [https://www.moddrop.com ModDrop mod manager]:
# Click ''Update Available'' in the top-right if it appears.
# Follow the on-screen instructions.
===Option C: use Vortex===
If you use the [https://www.nexusmods.com/about/vortex/ Vortex mod manager]:
# Go to {{nexus mod|2400|SMAPI's mod page}} and download it using the ''Mod Manager Download'' button.
# Click ''Open Vortex'' when the popup appears.
# Click the Vortex window, and the notification bell will appear with a notification in the upper right. Click ''install'' and then ''enable''.
==Deinstallieren==
# Run [[#Install|run the installer]] again, but choose ''uninstall'' to remove SMAPI.
# If you [[#Launch SMAPI through Steam or GOG Galaxy|configured Steam or GOG Galaxy]] to launch SMAPI, undo your changes:
#* '''Steam:''' in the Steam client: right-click on ''Stardew Valley'', choose ''Properties > General > Set Launch Options'', and blank the launch options textbox.
#* '''GOG Galaxy:''' in the GOG Galaxy client: click on Stardew Valley, click the settings icon next to the 'Play' button, click ''Manage installation > Configure'', and clear the ''Custom executables / arguments'' checkbox.
(If you want to play without mods temporarily, you can just launch <tt>Stardew Valley.exe</tt> directly or rename your <tt>Mods</tt> folder instead.)
==Starte SMAPI über Steam oder GOG Galaxy==
If you use Steam or GOG Galaxy, and want them to track your achievements and game time, you can configure them to launch SMAPI.
If you don't care about achievements or tracking game time, you can just launch <tt>StardewModdingAPI.exe</tt> in [[Modding:Spieleranleitung/Erste_Schritte#Finde_deinen_Spielordner|your game folder]] to play with mods.
===Steam===
You can launch SMAPI through the Steam client to enable the overlay and achievements.
# Keep SMAPI's installer window open.<br /><small>(If you already closed it, just run it again. No need to uninstall first.)</small>
# Copy the text '''in the installer window''' that looks like this ([https://community.playstarbound.com/threads/smapi-stardew-modding-api.108375/page-139#post-3292321 see how to copy text]):<br />[[File:Modding - installing SMAPI on Windows - installer Steam text.png]]<br />'''Make sure you copy the entire line, including both quotation marks <code>"</code> and the <code>%command%</code> part.''' <br /><small>Your final path should look something like this: <code>"Your path here" %command%</code></small>
# In the Steam client, right-click on ''Stardew Valley'' and choose ''Properties'':<br />[[File:Modding - installing SMAPI on Windows - Steam 1.png]]
# Click the textbox under ''Launch Options'':<br />[[File:Modding - installing SMAPI on Windows - Steam 2.png]]
# Replace anything in the textbox with the text you copied from the installer.<br /><small>To paste text, click in the box and press {{key|CTRL}} and {{key|V}}.</small>
# Click OK to save your changes.
# From now on, just launch the game through Steam to run SMAPI with the Steam overlay and achievements.
===GOG Galaxy===
You can use SMAPI through the GOG Galaxy client to track your play time. The steps below tell GOG Galaxy to launch a batch script, which in turn launches StardewModdingAPI.exe. This is because telling GOG Galaxy to launch StardewModdingAPI.exe directly causes the SMAPI console to be invisible, which can hide important errors and warning messages.
# Open Notepad and paste in the following: <code>start "" "C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\StardewModdingAPI.exe"</code> If Stardew Valley and SMAPI are not installed at <code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley\</code>, (the default location for most people), replace that location with the location of where you installed Stardew Valley.
# Click on File, then Save As... <br />[[File:Save_batch_script.png|800px]]
# Navigate to your Stardew Valley installation folder and change the file type from Text Documents to All Files as shown below and then click Save. <br />[[File:Choose_batch_extension.png|800px]]
# Then type <code>start.bat</code> for the file name as shown below <br />[[File:Name_batch_script.png|800px]]
# In the GOG Galaxy client, click on Stardew Valle' and then the settings icon on the right-hand side of the 'Play' button, then hover over 'Manage installation' and click 'Configure...' as shown below. <br /> [[File:Gog_galaxy_configure.png|800px]]
# A new menu will appear. Check the "Custom executables / arguments" box. <br />[[File:Gog_galaxy_custom_launch.png|400px]]
# Then click 'Add another executable / arguments' <br /> [[File:Gog_galaxy_add_exectuable.png|400px]]
# Select start.bat in the window that appears and then click Open. <br />[[File:Select_batch_file.png|800px]]
# Finally, click the circle next to 'Default Executable' underneath File 2, then click OK. <br />[[File:Gog_galaxy_select_default_executable.png|400px]]
# From now on, you can launch Stardew Valley through GOG Galaxy and both the SMAPI console and game will load as expected!
==Fehlerbehebung==
==="Oops, couldn't find the game automatically"===
If the installer shows that message, you can help it find the game folder. To do that:
# Exit the installer.
# [[Modding:Spieleranleitung/Erste_Schritte#Finde_deinen_Spielordner|Finde deinen Spielordner]].
# Move the installer '''folder''' into the game folder. (Make sure you move the whole folder, not just the files inside it!)
# Run the installer again and it should auto-detect the game folder now.
You can safely delete the installer folder when it's done.
===Probleme mit SMAPI oder Mods===
See the [[Modding:Spieleranleitung/Problembehebung|troubleshooting page]] for help with issues after installation.
{{Modding Anleitung Fußnote
|prev = [[Modding:Spieleranleitung/Erste Schritte|Erste Schritte]]
|next =
}}
[[en:Modding:Installing SMAPI on Windows]]
[[es:Modding:Instalar SMAPI en Windows]]
[[zh:使用模组:在Windows上安装SMAPI]]