77
Bearbeitungen
Änderungen
Zur Navigation springen
Zur Suche springen
Modding:Spieleranleitung/Problembehebung (Quelltext anzeigen)
Version vom 8. Dezember 2018, 20:21 Uhr
, 20:21, 8. Dez. 2018Die Seite wurde neu angelegt: „{{../Überschrift}} Funktioniert mit deinen Mod irgendwas nicht? Dann ist diese Seite für dich! ==Häufige Lösungen== ===Die Grundlagen=== # Probiere deine…“
{{../Überschrift}}
Funktioniert mit deinen Mod irgendwas nicht? Dann ist diese Seite für dich!
==Häufige Lösungen==
===Die Grundlagen===
# Probiere deinen Computer neu zu starten.
# Stelle sicher du hast die [https://smapi.io/ neuste Version von SMAPI].<br /><small>Deine SMAPI Version wird oben am Fenster angezeigt.</small>
# Stelle sicher dass du Stardew Valley {{version|link=0}} oder später hast.<br /><small>Klicke den "?" Knopf auf dem Titelbildschirm, damit die Verionsnummer links unten erscheint.</small>
===Setze deine Datein zurück===
Viele Probleme entstehen durch kaputte Spieldatein, vor allem wenn du[[Modding:XNB Mods verwenden|XNB Mods]] verwendest). Du kannst deine Spieldateien zurücksetzen, um dies zu beheben. XNB Mods werden dabei entfernt, aber alle SMAPI Mods bleiben erhalten
# Siehe Anleitungen [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 für Steam] oder [https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy].
# Wenn du SMAPI auf Linux oder Mac verwendest, installiere SMAPI danach neu um den Launcher zu beheben.
{{Übersetzen}}
{{collapse|Klappe aus für mehr Optionen|content=Wenn du nicht ''alle'' Dateien zurücksetzen willst, sind hier ein paar andere Möglichkeiten.
; Option 2: Erstelle rückwirkende Backups um jede Datei zurückzusetzen
: Wenn du XNB Mods installiert hast und eine Datei, bei der du weißt, dass sie kaputt ist zurücksetzen willst, kannst du ursprüngliche Datei wiederherstellen. Wenn du vergessen hast, diese zu Backupen, kannst du sie so wiederherstellen ohne die modifizierten zu verlieren:
:# Kopiere den <code>Content</code> Ordner in einen neuen, den du zum Beispiel <code>Content-Mods</code> nennen kannst.
:# Siehe Anleitungen [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 für Steam] oder [https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy].
:# Benenne den (mittlerweile zurückgesetzten) <code>Content</code> Ordner um zu zum Beispiel <code>Content-Backup</code>.
:# Nenne den <code>Content-Mods</code> Ordner wieder <code>Content</code>.
: Jetzt sind deine Datein wieder modifiziert, du hast aber ein Backup der originalen.
; Option 3: Fehlerfindung bei XNB Mods
: If you installed XNB mods, you're not sure which caused the problem, and you don't want to remove all your XNB mods, here's how to figure out which one is causing the problem.
:# Back up any XNB mods you want to keep.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/212807405 for GOG Galaxy]). Any XNB mods will be removed, but SMAPI mods won't be affected.
:# If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
:# Launch the game to see if the problem is fixed.
:# Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn't cause problems.
}}
==Fix common error messages==
==="SMAPI can't find the game"===
* Make sure you're running <code>StardewModdingAPI.exe</code> in your game folder (see the [[Modding:Player Guide/Getting Started#Getting started|install instructions]]).
* Did you install SMAPI manually (not [[Modding:Player Guide/Getting Started#Install SMAPI|using the installer]])? Make sure you copied the right files: <code>internal/Windows</code> for Windows, or <code>internal/Mono</code> for Linux/Mac.
==="Skipped '...' because it doesn't have a manifest.json"===
SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.
===Steam: "missing executable"===
Steam can't find the game launcher, usually because your Steam launch options are incorrect. Common fixes:
* If you want to use SMAPI:<br />make sure it's installed and your launch options are correct (see [[Modding:Player Guide/Getting Started#Getting started|install guide]]).
* If you're uninstalling SMAPI:<br />
*# In Steam, right-click ''Stardew Valley'' and choose ''Properties''.
*# Click the ''Set Launch Options'' button.
*# Make sure the textbox is completely empty.
===Linux/Mac: "looks like Mono isn't installed"===
Mono is a framework needed by the installer and SMAPI to work correctly.
# Make sure you download and install [http://mono-project.com/ Mono].
# Restart your computer and try again.
# On Mac, you can also [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
==Fix other issues==
===Save disappeared or doesn't load===
See [[Saves#Troubleshooting]].
===SMAPI files disappear or your antivirus complains===
Your antivirus might remove or complain about some SMAPI files. This is based on ''heuristic detection'' — SMAPI rewrites mods so they work on your computer, and rewriting files is something malware also does, so your antivirus got suspicious. Antiviruses learn to allow SMAPI after enough users download it, but this resets for each release. SMAPI doesn't have a trojan — you can check by [https://github.com/Pathoschild/SMAPI reading the code], [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal].
If this happens, here's how to fix it:
# Temporarily disable your antivirus.
# [[Modding:Player Guide/Getting Started#Getting started|Install SMAPI]].
# Add an exception to your antivirus for the [[Modding:Player Guide/Getting Started#Find your game_folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions).
===Steam: nothing happens when you launch game (Windows only)===
Symptom: you launch the game, Steam shows 'running' for a few seconds, but the game doesn't open. You can usually fix that by doing this:
# If you've already installed SMAPI, blank the Steam launch options so it runs the game without SMAPI.
# [[Modding:Player Guide/Getting Started#Find your game folder|Open your game folder]].
# Open the <code>_CommonRedist</code> folder, then <code>XNA</code> inside that, then <code>4.0</code>.
# Run the <code>xnafx40_redist.msi</code> file.
# Restart your computer.
# Launch the game.
If that works, you're done! (If you removed SMAPI in step one, you can reinstall it now.)
If it still doesn't work:
# [[Modding:Installing SMAPI on Windows|Install SMAPI]] (if you don't already have it).
# Launch the game.
# [[#Ask for help|Ask for help and attach your SMAPI log]].
===Steam: controller not working properly===
Common fixes:
* Launch the game through Steam.
* On Windows, make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Install|part 2 in the Windows install guide]]), don't add SMAPI as a non-Steam game.
* As a last resort, you can use [https://inputmapper.com/ InputMapper] (Windows) or SC Controller (Linux) to bypass Steam's controller features.
===Other problems===
Run the game without SMAPI by launching <code>Stardew Valley.exe</code> (on Windows) or <code>StardewValley-original</code> (on Linux/Mac) in your [[Modding:Player Guide/Getting Started#Find your game folder|game folder]].
* If it still happens '''without''' SMAPI: see [https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ this guide to fixing your game]. If you still need help, [[#Ask for help|ask for help]].
* If it only happens '''with''' SMAPI, [[#Ask for help|ask for help]].
==Ask for help==
===Find your SMAPI log===
The SMAPI log has useful info for troubleshooting problems (like your versions, mods, game path, errors, etc).
Here's how to share it:
<ol>
<li>Find the log file here:
{| class="wikitable"
|-
! Platform
! Path
|-
| Windows
| <code>%appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt</code><br /><small>(Paste "<code>%appdata%</code>" into the address bar, Windows knows where it is.)</small>
|-
| Linux
| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Files, click ''Go » Enter Location'' and enter "~/.config".)</small>
|-
| Mac
| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Finder, click ''Go » Go to Folder'' and enter "~/.config".)</small>
|}
</li>
<li>Upload the file to [https://log.smapi.io log.smapi.io] and share the link.</li>
</ol>
===Find help===
For help with a mod, the mod author is the best person to ask. These are the best ways to contact them:
# the discussion thread linked to on the mod page (if any);
# the 'bugs' section on the Nexus mod page (if any);
# otherwise contact the author directly (e.g. use the 'Contact' button on the Nexus mod page).
For help with SMAPI, or if you can't ask the mod author, [http://community.playstarbound.com/threads/dos-and-donts-of-reporting-issues-with-smapi-mods.125211/ post in this thread] or [[Modding:Community|ask the community]].
===What to include in a bug report===
<span id="bug-report"></span>
Figuring out why something went wrong for someone else can be tough, so it helps if you include as much information as possible. Here's the most useful information you can give.
# Describe your problem:
#* Which mod has an issue?
#* What is the problem? Be as descriptive as possible. (Does the game freeze or close? Does the screen go black? Does nothing at all happen?)
#* What were you doing when it broke? Did you notice a pattern? For example, maybe it always breaks when you do a certain thing.
# Describe your context:
#* Do you use a mod manager? If so, which one?
#* Do you play on Linux, Mac, or Windows?
# Upload your SMAPI log to [https://log.smapi.io/ log.smapi.io] (see instructions on that page), and add a link to your message.
{{Modding Anleitung Fußnote
|prev = [[../Erste Schritte|Erste Schritte]]
|next = [[Modding:SMAPI Kompatibilität|SMAPI Kompatibilität]]
}}
Funktioniert mit deinen Mod irgendwas nicht? Dann ist diese Seite für dich!
==Häufige Lösungen==
===Die Grundlagen===
# Probiere deinen Computer neu zu starten.
# Stelle sicher du hast die [https://smapi.io/ neuste Version von SMAPI].<br /><small>Deine SMAPI Version wird oben am Fenster angezeigt.</small>
# Stelle sicher dass du Stardew Valley {{version|link=0}} oder später hast.<br /><small>Klicke den "?" Knopf auf dem Titelbildschirm, damit die Verionsnummer links unten erscheint.</small>
===Setze deine Datein zurück===
Viele Probleme entstehen durch kaputte Spieldatein, vor allem wenn du[[Modding:XNB Mods verwenden|XNB Mods]] verwendest). Du kannst deine Spieldateien zurücksetzen, um dies zu beheben. XNB Mods werden dabei entfernt, aber alle SMAPI Mods bleiben erhalten
# Siehe Anleitungen [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 für Steam] oder [https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy].
# Wenn du SMAPI auf Linux oder Mac verwendest, installiere SMAPI danach neu um den Launcher zu beheben.
{{Übersetzen}}
{{collapse|Klappe aus für mehr Optionen|content=Wenn du nicht ''alle'' Dateien zurücksetzen willst, sind hier ein paar andere Möglichkeiten.
; Option 2: Erstelle rückwirkende Backups um jede Datei zurückzusetzen
: Wenn du XNB Mods installiert hast und eine Datei, bei der du weißt, dass sie kaputt ist zurücksetzen willst, kannst du ursprüngliche Datei wiederherstellen. Wenn du vergessen hast, diese zu Backupen, kannst du sie so wiederherstellen ohne die modifizierten zu verlieren:
:# Kopiere den <code>Content</code> Ordner in einen neuen, den du zum Beispiel <code>Content-Mods</code> nennen kannst.
:# Siehe Anleitungen [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 für Steam] oder [https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy].
:# Benenne den (mittlerweile zurückgesetzten) <code>Content</code> Ordner um zu zum Beispiel <code>Content-Backup</code>.
:# Nenne den <code>Content-Mods</code> Ordner wieder <code>Content</code>.
: Jetzt sind deine Datein wieder modifiziert, du hast aber ein Backup der originalen.
; Option 3: Fehlerfindung bei XNB Mods
: If you installed XNB mods, you're not sure which caused the problem, and you don't want to remove all your XNB mods, here's how to figure out which one is causing the problem.
:# Back up any XNB mods you want to keep.
:# Reset your game files (see instructions [https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 for Steam] or [https://support.gog.com/hc/en-us/articles/212807405 for GOG Galaxy]). Any XNB mods will be removed, but SMAPI mods won't be affected.
:# If you use SMAPI on Linux/Mac, reinstall SMAPI to fix the launcher.
:# Launch the game to see if the problem is fixed.
:# Reinstall your XNB mods one at a time. After each install, test the game to make sure the mod doesn't cause problems.
}}
==Fix common error messages==
==="SMAPI can't find the game"===
* Make sure you're running <code>StardewModdingAPI.exe</code> in your game folder (see the [[Modding:Player Guide/Getting Started#Getting started|install instructions]]).
* Did you install SMAPI manually (not [[Modding:Player Guide/Getting Started#Install SMAPI|using the installer]])? Make sure you copied the right files: <code>internal/Windows</code> for Windows, or <code>internal/Mono</code> for Linux/Mac.
==="Skipped '...' because it doesn't have a manifest.json"===
SMAPI couldn't find the <code>manifest.json</code> file for the mod in that folder. That usually means it's not a SMAPI mod, so it won't work from the <code>Mods</code> folder. See that mod's documentation for install instructions.
===Steam: "missing executable"===
Steam can't find the game launcher, usually because your Steam launch options are incorrect. Common fixes:
* If you want to use SMAPI:<br />make sure it's installed and your launch options are correct (see [[Modding:Player Guide/Getting Started#Getting started|install guide]]).
* If you're uninstalling SMAPI:<br />
*# In Steam, right-click ''Stardew Valley'' and choose ''Properties''.
*# Click the ''Set Launch Options'' button.
*# Make sure the textbox is completely empty.
===Linux/Mac: "looks like Mono isn't installed"===
Mono is a framework needed by the installer and SMAPI to work correctly.
# Make sure you download and install [http://mono-project.com/ Mono].
# Restart your computer and try again.
# On Mac, you can also [https://brew.sh install Homebrew] and run <code>brew install mono mono-libgdiplus</code> in the Terminal app.
==Fix other issues==
===Save disappeared or doesn't load===
See [[Saves#Troubleshooting]].
===SMAPI files disappear or your antivirus complains===
Your antivirus might remove or complain about some SMAPI files. This is based on ''heuristic detection'' — SMAPI rewrites mods so they work on your computer, and rewriting files is something malware also does, so your antivirus got suspicious. Antiviruses learn to allow SMAPI after enough users download it, but this resets for each release. SMAPI doesn't have a trojan — you can check by [https://github.com/Pathoschild/SMAPI reading the code], [https://www.jetbrains.com/decompiler/ decompiling the download], or [https://www.virustotal.com/ uploading it to VirusTotal].
If this happens, here's how to fix it:
# Temporarily disable your antivirus.
# [[Modding:Player Guide/Getting Started#Getting started|Install SMAPI]].
# Add an exception to your antivirus for the [[Modding:Player Guide/Getting Started#Find your game_folder|Stardew Valley folder]] (search online for your antivirus name with the words ''add folder exception'' for instructions).
===Steam: nothing happens when you launch game (Windows only)===
Symptom: you launch the game, Steam shows 'running' for a few seconds, but the game doesn't open. You can usually fix that by doing this:
# If you've already installed SMAPI, blank the Steam launch options so it runs the game without SMAPI.
# [[Modding:Player Guide/Getting Started#Find your game folder|Open your game folder]].
# Open the <code>_CommonRedist</code> folder, then <code>XNA</code> inside that, then <code>4.0</code>.
# Run the <code>xnafx40_redist.msi</code> file.
# Restart your computer.
# Launch the game.
If that works, you're done! (If you removed SMAPI in step one, you can reinstall it now.)
If it still doesn't work:
# [[Modding:Installing SMAPI on Windows|Install SMAPI]] (if you don't already have it).
# Launch the game.
# [[#Ask for help|Ask for help and attach your SMAPI log]].
===Steam: controller not working properly===
Common fixes:
* Launch the game through Steam.
* On Windows, make sure you set the launch options (see [[Modding:Installing SMAPI on Windows#Install|part 2 in the Windows install guide]]), don't add SMAPI as a non-Steam game.
* As a last resort, you can use [https://inputmapper.com/ InputMapper] (Windows) or SC Controller (Linux) to bypass Steam's controller features.
===Other problems===
Run the game without SMAPI by launching <code>Stardew Valley.exe</code> (on Windows) or <code>StardewValley-original</code> (on Linux/Mac) in your [[Modding:Player Guide/Getting Started#Find your game folder|game folder]].
* If it still happens '''without''' SMAPI: see [https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ this guide to fixing your game]. If you still need help, [[#Ask for help|ask for help]].
* If it only happens '''with''' SMAPI, [[#Ask for help|ask for help]].
==Ask for help==
===Find your SMAPI log===
The SMAPI log has useful info for troubleshooting problems (like your versions, mods, game path, errors, etc).
Here's how to share it:
<ol>
<li>Find the log file here:
{| class="wikitable"
|-
! Platform
! Path
|-
| Windows
| <code>%appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt</code><br /><small>(Paste "<code>%appdata%</code>" into the address bar, Windows knows where it is.)</small>
|-
| Linux
| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Files, click ''Go » Enter Location'' and enter "~/.config".)</small>
|-
| Mac
| <code>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</code><br /><small>(The folder is hidden by default. From Finder, click ''Go » Go to Folder'' and enter "~/.config".)</small>
|}
</li>
<li>Upload the file to [https://log.smapi.io log.smapi.io] and share the link.</li>
</ol>
===Find help===
For help with a mod, the mod author is the best person to ask. These are the best ways to contact them:
# the discussion thread linked to on the mod page (if any);
# the 'bugs' section on the Nexus mod page (if any);
# otherwise contact the author directly (e.g. use the 'Contact' button on the Nexus mod page).
For help with SMAPI, or if you can't ask the mod author, [http://community.playstarbound.com/threads/dos-and-donts-of-reporting-issues-with-smapi-mods.125211/ post in this thread] or [[Modding:Community|ask the community]].
===What to include in a bug report===
<span id="bug-report"></span>
Figuring out why something went wrong for someone else can be tough, so it helps if you include as much information as possible. Here's the most useful information you can give.
# Describe your problem:
#* Which mod has an issue?
#* What is the problem? Be as descriptive as possible. (Does the game freeze or close? Does the screen go black? Does nothing at all happen?)
#* What were you doing when it broke? Did you notice a pattern? For example, maybe it always breaks when you do a certain thing.
# Describe your context:
#* Do you use a mod manager? If so, which one?
#* Do you play on Linux, Mac, or Windows?
# Upload your SMAPI log to [https://log.smapi.io/ log.smapi.io] (see instructions on that page), and add a link to your message.
{{Modding Anleitung Fußnote
|prev = [[../Erste Schritte|Erste Schritte]]
|next = [[Modding:SMAPI Kompatibilität|SMAPI Kompatibilität]]
}}