Stardew Valley Wiki

更改

模组:使用指南/疑难解答 (查看源代码)

2022年8月26日 (五) 04:53的版本

添加6,710字节 、 2022年8月26日 (五) 04:53
tweak styles to match recent changes on English wiki
第1行： 第1行： −
{{../header}}
+
{{Modding player guide header}}
    
 如果您在进行游戏时遇到了各种错误，那么这个页面就是为您准备的！（此页面不仅仅面向使用Mod的玩家。）
 
 如果您在进行游戏时遇到了各种错误，那么这个页面就是为您准备的！（此页面不仅仅面向使用Mod的玩家。）
   −
==常用解决方案==
+
=常用解决方案=
−
===基本步骤===
+
==基本步骤==
 
# 重启电脑。
 
# 重启电脑。
 
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
 
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
第10行： 第10行：  
# 如果您正在使用SMAPI：[[File:Modding - Player Guide - Troubleshooting - SMAPI Log Parser ZH.png|thumb|SMAPI日志解析器]]
 
# 如果您正在使用SMAPI：[[File:Modding - Player Guide - Troubleshooting - SMAPI Log Parser ZH.png|thumb|SMAPI日志解析器]]
 
## 确保您已经安装了[https://smapi.io/ 最新版本的SMAPI]<br /><small>SMAPI控制台窗口的左上角会显示当前运行的SMAPI版本。</small>
 
## 确保您已经安装了[https://smapi.io/ 最新版本的SMAPI]<br /><small>SMAPI控制台窗口的左上角会显示当前运行的SMAPI版本。</small>
−
## 按照[https://smapi.io/log  网站上 的 说明]，找到SMAPI在您电脑上储存的日志，并将其上传到[https://smapi.io/log 日志解析器]中进行分析。它可以帮助您分析一些常见错误。右侧的图片将告诉您如何读懂SMAPI的日志。
+
## 按照[[模组:使用指南/入门#SMAPI日志|这里的说明]]，或是[https://smapi.io/log  日志解析器 的 介绍]，找到SMAPI在您电脑上储存的日志，并将其上传到[https://smapi.io/log 日志解析器]中进行分析。它可以帮助您分析一些常见错误。右侧的图片将告诉您如何读懂SMAPI的日志。
 
## 日志靠近最上方的位置显示了需要更新的Mod。您也可以使用{{nexus mod|2536|Mod Update Menu}}来在游戏主菜单内检视已安装Mod的更新情况。'''当您在使用Mod进行游戏时遇到了任何问题时，第一件事都应当是更新这个列表里的所有Mod（即便有些Mod未更新时看起来也能正常使用）。'''
 
## 日志靠近最上方的位置显示了需要更新的Mod。您也可以使用{{nexus mod|2536|Mod Update Menu}}来在游戏主菜单内检视已安装Mod的更新情况。'''当您在使用Mod进行游戏时遇到了任何问题时，第一件事都应当是更新这个列表里的所有Mod（即便有些Mod未更新时看起来也能正常使用）。'''
 
## 如果您已将问题定位到了一个或一系列特定的Mod上，请试着卸载并重新安装这些Mod。
 
## 如果您已将问题定位到了一个或一系列特定的Mod上，请试着卸载并重新安装这些Mod。
第17行： 第17行：  
# 如果遵循以上步骤后您仍然遇到了错误，请查看本页面的[[#常见问题解答|常见问题解答]]部分，或[[#寻求帮助|寻求帮助]]。
 
# 如果遵循以上步骤后您仍然遇到了错误，请查看本页面的[[#常见问题解答|常见问题解答]]部分，或[[#寻求帮助|寻求帮助]]。
   −
===重置游戏文件===
+
==重置游戏文件==
−
 许多问题都是游戏文件损坏导致的（尤其是在您[[模组:使 用XNB Mod|使用XNB Mod]]时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。
+
 许多问题都是游戏文件损坏导致的（尤其是在您[[模组:使 用 XNB 模组|使用XNB Mod]]时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。
    
# 查看如何在[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335&l=simplified%20chinese Steam平台]或是[https://support.gog.com/hc/zh-cn/articles/360003930017 GOG平台]验证游戏文件完整性。
 
# 查看如何在[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335&l=simplified%20chinese Steam平台]或是[https://support.gog.com/hc/zh-cn/articles/360003930017 GOG平台]验证游戏文件完整性。
第33行： 第33行：  
: 现在您的游戏文件（ <code>Content</code> 文件夹）仍然是修改过的，但您已经获得了原版游戏文件（ <code>Content-backup</code> 文件夹）。只需要替换对应的损坏文件即可。
 
: 现在您的游戏文件（ <code>Content</code> 文件夹）仍然是修改过的，但您已经获得了原版游戏文件（ <code>Content-backup</code> 文件夹）。只需要替换对应的损坏文件即可。
   −
; 方法3&#58; troubleshoot XNB mods
+
; 方法3&#58; XNB Mod导致的问题
 
: 如果您安装使用了XNB Mod，但并不确定是哪个Mod导致了问题，此外您也不想移除您所有的XNB Mod，可以按照以下方法来确定是哪个Mod导致的问题。
 
: 如果您安装使用了XNB Mod，但并不确定是哪个Mod导致了问题，此外您也不想移除您所有的XNB Mod，可以按照以下方法来确定是哪个Mod导致的问题。
 
:# 备份您想保留的所有XNB Mod。
 
:# 备份您想保留的所有XNB Mod。
第42行： 第42行：  
}}
 
}}
   −
<div style="border: 1px solid red; background: #FCC; padding: 1em;">'''注意：'''XNB Mod是直接替换游戏文件的Mod，现在已经[[模组:使 用XNB Mod|不再被推荐使用]]，继续使用XNB Mod可能会导致许多意想不到的问题。重置游戏文件将会移除您所有已安装的XNB Mod。重置完成后，您可以考虑'''[[模组:使 用XNB Mod|使用基于Content Pacher的Mod]]'''来替代这些XNB Mod。</div>
+
<div class="modding-error-box">'''注意：'''XNB Mod是直接替换游戏文件的Mod，现在已经[[模组:使 用 XNB 模组|不再被推荐使用]]，继续使用XNB Mod可能会导致许多意想不到的问题。重置游戏文件将会移除您所有已安装的XNB Mod。重置完成后，您可以考虑'''[[模组:使 用 XNB 模组|使用基于Content Pacher的Mod]]'''来替代这些XNB Mod。</div>
   −
==常见问题解答==
+
=常见问题解答=
−
===游戏无法启动===
+
==游戏无法启动==
 
 在您试着启动游戏时，游戏无法启动。（如果您正在使用的是Steam，它可能会显示“正在启动”。）下面的方法可能会帮您解决这个问题：
 
 在您试着启动游戏时，游戏无法启动。（如果您正在使用的是Steam，它可能会显示“正在启动”。）下面的方法可能会帮您解决这个问题：
 
# 重启电脑。
 
# 重启电脑。
 
# 确保您已经插入耳机或麦克风。（需要一个可工作的音频设备才能正常运行游戏，您可以将它们设置为静音。）
 
# 确保您已经插入耳机或麦克风。（需要一个可工作的音频设备才能正常运行游戏，您可以将它们设置为静音。）
 
# 如果您正在Windows上运行游戏：
 
# 如果您正在Windows上运行游戏：
−
## 安装（或是重新安装 ）4.5.2版本的 [https://dotnet.microsoft.com/download/dotnet-framework-runtime/net452 .NET Framework] 和4.0 版本的[https://web.archive.org/web/20210124193907/https://www.microsoft.com/en-us/download/details.aspx?id=20914 XNA Framework] 。如果您正在使用Steam，也可以在Steam目录 下<code><nowiki> Steam\steamapps\common\Steamworks Shared\_CommonRedist\XNA\4.0 </nowiki></code>文件夹中找到XNA Framework的 安 装包 。您可能需要预先[https://knowledge.autodesk.com/zh-hans/support/autocad/learn-explore/caas/sfdcarticles/sfdcarticles/CHS/How-to-remove-and-reinstall-the-Microsoft-NET-Framework.html 卸载 .NET Framework]才能进行安装。
+
## 安装（或是重新安装 ）[https://dotnet.microsoft.com/download/dotnet/5.0/runtime .NET 5] （通常情况 下安 装Windows x64版本即可） 。您可能需要预先[https://knowledge.autodesk.com/zh-hans/support/autocad/learn-explore/caas/sfdcarticles/sfdcarticles/CHS/How-to-remove-and-reinstall-the-Microsoft-NET-Framework.html 卸载 .NET Framework]才能进行安装。
 
## 重启电脑。
 
## 重启电脑。
 
## 运行游戏。
 
## 运行游戏。
 +
## 确保您[[模组:在Windows上安装SMAPI#Steam|在Steam上为星露谷物语设置的启动选项]]准确无误（如有必要，您可以先尝试删除所有的启动选项）。
 +
## 安装并运行[https://www.microsoft.com/en-us/download/details.aspx?id=30135 .NET 修复程序]，依照它显示的步骤进行修复。
 
# 如果您正在Linux上运行游戏：
 
# 如果您正在Linux上运行游戏：
 
## 您默认的终端可能与游戏不兼容，请尝试安装XTERM终端。
 
## 您默认的终端可能与游戏不兼容，请尝试安装XTERM终端。
第60行： 第62行：  
## [[#寻求帮助|附上您的SMAPI日志寻求帮助]]。
 
## [[#寻求帮助|附上您的SMAPI日志寻求帮助]]。
   −
===游戏无响应或崩溃===
+
==游戏无响应或崩溃==
 
 在您打开游戏后，还未进入到标题界面游戏便无响应或崩溃了。下面的方法可能会帮您解决这个问题：
 
 在您打开游戏后，还未进入到标题界面游戏便无响应或崩溃了。下面的方法可能会帮您解决这个问题：
 
# 尝试[[#游戏无法启动|游戏无法启动]]这部分的所有方法。
 
# 尝试[[#游戏无法启动|游戏无法启动]]这部分的所有方法。
第68行： 第70行：  
# 如果以上方法均无效，请按照步骤[[#寻求帮助|寻求帮助]]。
 
# 如果以上方法均无效，请按照步骤[[#寻求帮助|寻求帮助]]。
   −
===Steam显示游戏正在运行，但没有窗口出现（仅限Windows）===
+
==Steam显示游戏正在运行，但没有窗口出现（仅限Windows）==
 
 在您从Steam启动游戏后，Steam显示游戏正在运行，但过了很久依然没有游戏窗口出现，且点击Steam的停止按钮没有反应。这似乎是Steam的问题，您可以按照以下步骤来重新启动游戏：
 
 在您从Steam启动游戏后，Steam显示游戏正在运行，但过了很久依然没有游戏窗口出现，且点击Steam的停止按钮没有反应。这似乎是Steam的问题，您可以按照以下步骤来重新启动游戏：
 
# 右键点击Windows任务栏，打开任务管理器，并点击窗口最左下角的箭头切换到详细信息。
 
# 右键点击Windows任务栏，打开任务管理器，并点击窗口最左下角的箭头切换到详细信息。
−
# 尝试找到 <tt>Stardew Valley</tt> 进程，右键点击它，选择结束任务，如下图所示：<br />[[File:Modding - Player Guide - Troubleshooting - Task Manager 01 ZH.png|700px]]<br />
+
# 尝试找到 <samp>Stardew Valley</samp> 进程，右键点击它，选择结束任务，如下图所示：<br />[[File:Modding - Player Guide - Troubleshooting - Task Manager 01 ZH.png|700px]]<br />
−
# 如果您在上一步中没有找到游戏进程，它也可能在Steam的子进程下，需要找到并展开<tt>Steam</tt>的进程，右键点击 <tt>Stardew Valley</tt>  它 ，选择结束任务。<br />[[File:Modding - Player Guide - Troubleshooting - Task Manager 02 ZH.png|700px]]<br />
+
# 如果您在上一步中没有找到游戏进程，它也可能在Steam的子进程下，需要找到并展开<samp>Steam</samp>的进程，右键点击 <samp>Stardew Valley</samp> ，选择结束任务。<br />[[File:Modding - Player Guide - Troubleshooting - Task Manager 02 ZH.png|700px]]<br />
 
# 结束《星露谷物语》的进程后，您便应当能在Steam中重新启动游戏了。
 
# 结束《星露谷物语》的进程后，您便应当能在Steam中重新启动游戏了。
 
# 在极少部分情况下，您可能需要重复以上步骤2~3次。
 
# 在极少部分情况下，您可能需要重复以上步骤2~3次。
   −
===游戏没有声音（仅限Windows）===
+
==更新 Stardew Valley 时发生错误（缺失可执行文件）（仅限Steam）==
 +
* 如果您想使用SMAPI，请确保您[[模组:在Windows上安装SMAPI#Steam|在Steam上为星露谷物语设置的启动选项]]准确无误。
 +
* 如果您不想使用Mod进行游戏，且没有安装SMAPI，请在Steam客户端中，右键点击 <samp>Stardew Valley</samp> 并选择“属性”，然后在“通用”中清空“启动选项”下文本框内的所有内容：<br />[[File:Modding - installing SMAPI on Windows - Steam 1 ZH.png]]<br />[[File:Modding - installing SMAPI on Windows - Steam 2 ZH.png|700px]]
 +
 
 +
==运行SMAPI安装脚本时控制台窗口闪退（仅限Windows）==
 +
如果您在安装SMAPI的操作过程中，双击运行 <samp>install on Windows.bat</samp> 这个文件后有一个黑色的控制台窗口打开，然后立刻闪退，这可能是系统环境变量出现了问题。
 +
 
 +
您可以参照[[#如果您是64位Windows 10或以上的系统|这部分的说明]]编辑环境变量，确保在名为 <samp>Path</samp> 的系统变量中有 <code>C:\Windows\system32</code> 和 <code>C:\Windows</code> 这两个值，如果没有，请点击右侧的“新建”按钮手动添加。
 +
 
 +
[[File:FileModding - Player Guide - Troubleshooting - Environment Variables 03 ZH.png|500px]]
 +
 
 +
如果上述方法无法解决问题，请[[#寻求帮助|寻求帮助]]。
 +
 
 +
==游戏光标不受控制==
 +
如果您在游戏时鼠标不受控制，并排除设备自身的问题后，可能是因为游戏自动侦测到的手柄模式开关错误，您可以按照以下方法之一解决。
 +
 
 +
'''方法一：'''
 +
# 加载存档。
 +
# 按下{{key|ESC}}并切换到设置界面。
 +
# 将“游戏手柄模式”切换为“关闭”（如果您正在使用的是鼠标和键盘）；将“游戏手柄模式”切换为“开启”（如果您正在使用的是手柄）。
 +
 
 +
'''方法二：'''
 +
# 关闭游戏。
 +
# 同时按下Windows+{{key|R}}键，在新弹出的运行窗口中输入 <code>notepad "%appdata%\StardewValley\startup_preferences"</code> 后点击“确定”。
 +
# 此时记事本应该会自动打开一个名为“startup_preferences”的游戏配置文件。在打开的文件内同时按下{{key|Ctrl}}+{{key|F}}打开搜索窗口，输入 <code><nowiki><gamepadMode></nowiki></code> 并点击“查找下一个”，您应当能看到一段形如<code><nowiki><gamepadMode>Auto</gamepadMode></nowiki></code>的代码（如下图所示）。<br />[[File:Modding - Player Guide - Troubleshooting - gamepadMode ZH.png|700px]]<br />
 +
# 如果您正在使用的是键盘和鼠标，将一段内容修改为<code><nowiki><gamepadMode>ForceOff</gamepadMode></nowiki></code>；如果您正在使用的是手柄，将其修改为<code><nowiki><gamepadMode>ForceOn</gamepadMode></nowiki></code>。
 +
# 保存并关闭文件。
 +
# 重新运行游戏，此时应该一切正常了。
 +
 
 +
==游戏帧率过低（人物动作缓慢）==
 +
星露谷物语正常情况下应该始终以60帧运行，如果您突然感觉游戏帧率过低，或是人物动作变缓，您可以先按以下步骤打开Steam内的游戏内帧率显示（或使用其他显示帧率的软件），确认游戏当前运行的帧率：
 +
# 打开游戏后，同时按下{{key|Shift}}+{{key|Tab}}。
 +
# 在弹出的Steam游戏内覆盖窗口中，点击下方中间位置的“设置”按钮。
 +
# 在弹出的设置界面中，切换到游戏中一栏。
 +
# 将“游戏中帧数显示”功能由“关闭”选项更改为“左上角”（或您习惯的其他位置）
 +
# 点击确定。
 +
# 按下{{key|ESC}}键返回游戏。
 +
[[File:Modding - Player Guide - Troubleshooting - Frame ZH.png|700px]]
 +
 
 +
此时您应当能够在游戏内的左上角（或您设置的其他位置）看见游戏实时帧率了。加载存档后，若您发现您的帧率与60帧相差很大（例如30帧），您可以尝试更改游戏内的以下设置选项：
 +
* 取消勾选“垂直同步”选项。
 +
* 尝试切换“窗口模式” 选项，依次试着更改为“窗口”、“窗口无边框”、“全屏”。
 +
 
 +
如果您发现采用上面的两个方法之一时，游戏帧率回到了60帧，那便说明一切正常了，您可以继续探索星露谷的世界了。如果该问题依然没有解决，请[[#寻求帮助|寻求帮助]]。
 +
 
 +
==游戏没有声音（仅限Windows）==
 
 您的浏览器或是其他软件均能正常播放声音，但游戏却没有声音。下面的方法可能会帮您解决这个问题：
 
 您的浏览器或是其他软件均能正常播放声音，但游戏却没有声音。下面的方法可能会帮您解决这个问题：
 
# 重启电脑。
 
# 重启电脑。
第84行： 第131行：  
## 在弹出的窗口中找到Stardew Valley应用程序，调高它的音量。
 
## 在弹出的窗口中找到Stardew Valley应用程序，调高它的音量。
 
# 确保您在游戏内设置选项中打开了声音。
 
# 确保您在游戏内设置选项中打开了声音。
−
# [[#游戏无法启动|重新安装.NET Framework 4.5.2 和 XNA Framework 4.0]]。
+
# [[#游戏无法启动|重新安装.NET 5]]。
   −
===存档丢失或无法加载===
+
==存档丢失或无法加载==
 
 请查看[[存档#疑难解答]]。
 
 请查看[[存档#疑难解答]]。
   −
===合作模式中无法与其他玩家联机===
+
==合作模式中无法与其他玩家联机==
 
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
 
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
 
# 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项，然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏，即使您的存档中有空闲的[[联机小屋]]，其他玩家也不能加入您的游戏，您只能在单人模式下进行游戏。
 
# 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项，然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏，即使您的存档中有空闲的[[联机小屋]]，其他玩家也不能加入您的游戏，您只能在单人模式下进行游戏。
 
# 您的存档中有空闲的[[联机小屋]]供未加入玩家选择。
 
# 您的存档中有空闲的[[联机小屋]]供未加入玩家选择。
−
# 请确保每位玩家都是通过Steam或是GOG Galaxy启动游戏的，而不是直接点击快捷方式。如果您正在使用Mod进行游戏，请按照[[模组:在Windows上安装SMAPI# 通过Steam或GOG Galaxy 启 动SMAPI| 通过Steam或GOG Galaxy 启 动SMAPI]]这个页面的步骤来进行设置。
+
# 请确保每位玩家都是通过Steam或是GOG Galaxy启动游戏的，而不是直接点击快捷方式。如果您正在使用Mod进行游戏，请按照[[模组:在Windows上安装SMAPI# 设置游戏平台 启 动项| 设置游戏平台 启 动项]]这个页面的步骤来进行设置。
 
# 作为主机的玩家需要在游戏选项中设置服务器模式为“联机”。
 
# 作为主机的玩家需要在游戏选项中设置服务器模式为“联机”。
 
# 所有玩家都应尝试关闭Windows防火墙，并关闭所有杀毒软件。同时使用多款杀毒软件很容易导致无法与其他玩家联机。在任何时候您都不应该同时使用多款杀毒软件。
 
# 所有玩家都应尝试关闭Windows防火墙，并关闭所有杀毒软件。同时使用多款杀毒软件很容易导致无法与其他玩家联机。在任何时候您都不应该同时使用多款杀毒软件。
第100行： 第147行：  
# 所有玩家都重启一下电脑。
 
# 所有玩家都重启一下电脑。
 
# 所有玩家都重启一下路由器。
 
# 所有玩家都重启一下路由器。
−
# 如果您正在Windows上运行游戏，请尝试重新[[#游戏无法启动|安装.NET Framework 4.5.2，XNA Framework 4.0]]以及[https://www.microsoft.com/zh-CN/download/details.aspx?id=40784 Visual C++ Redistributable Packages for Visual Studio 2013]。
+
# 如果您正在Windows上运行游戏，请尝试重新[[#游戏无法启动|安装.NET 5]]。
 
# 如果您正在使用Mod进行游戏，并看到了“version mismatch”的错误，请查看控制台输出中是否有像这样的一行日志：<code>[19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1</code>。如果有，请检查您的协议版本是否与其一致。
 
# 如果您正在使用Mod进行游戏，并看到了“version mismatch”的错误，请查看控制台输出中是否有像这样的一行日志：<code>[19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1</code>。如果有，请检查您的协议版本是否与其一致。
    
 对于主机玩家，请尽量尝试上述方法中您能实现的部分（尤其是靠前的方法），您也可以尝试重启您的主机。请注意，主机玩家需要购买对应平台的联机服务才能进行联机游戏。
 
 对于主机玩家，请尽量尝试上述方法中您能实现的部分（尤其是靠前的方法），您也可以尝试重启您的主机。请注意，主机玩家需要购买对应平台的联机服务才能进行联机游戏。
   −
===合作模式中频繁掉线===
+
==合作模式中频繁掉线==
 
 在客机进行游戏时，经常与主机断开连接，或是各个游戏玩家之间游戏内时间相差较大。这种情况一般是主机或客机玩家的网络不稳定导致的。无论是您家中的网络或是宽带运营商的网络，都可能导致网络不稳定。
 
 在客机进行游戏时，经常与主机断开连接，或是各个游戏玩家之间游戏内时间相差较大。这种情况一般是主机或客机玩家的网络不稳定导致的。无论是您家中的网络或是宽带运营商的网络，都可能导致网络不稳定。
   第127行： 第174行：  
 如果尝试以上方法后客机依然会频繁掉线，也可以尝试重新创建一个由其他玩家主持的存档进行游戏，或是寻求宽带运营商服务人员等专业人士帮助。
 
 如果尝试以上方法后客机依然会频繁掉线，也可以尝试重新创建一个由其他玩家主持的存档进行游戏，或是寻求宽带运营商服务人员等专业人士帮助。
   −
===SMAPI文件丢失或报毒===
+
==SMAPI文件丢失或报毒==
 
 您正在使用的杀毒软件可能会将SMAPI/Mod的文件删除，或是对这些文件报毒。但它们几乎都是误报，SMAPI本身也是没有木马病毒的。
 
 您正在使用的杀毒软件可能会将SMAPI/Mod的文件删除，或是对这些文件报毒。但它们几乎都是误报，SMAPI本身也是没有木马病毒的。
   第137行： 第184行：  
:; '''为什么会这样？'''
 
:; '''为什么会这样？'''
 
:: 杀毒软件通常会因为以下原因而报毒：
 
:: 杀毒软件通常会因为以下原因而报毒：
−
::* 因为这是您刚刚下载的文件。事实上，在您刚刚下载Mod到本地后，杀毒软件并不能检测出任何东西，只是因为这些Mod都是未知文件。这种情况下，杀毒软件通常会误报如 <tt>Trojan:Win32/Emali.A!cl</tt> 这样的警告。随着下载这个文件的人越来越多，杀毒软件会修复误报。但每次Mod更新后，便又可能出现这样的误报。
+
::* 因为这是您刚刚下载的文件。事实上，在您刚刚下载Mod到本地后，杀毒软件并不能检测出任何东西，只是因为这些Mod都是未知文件。这种情况下，杀毒软件通常会误报如 <samp>Trojan:Win32/Emali.A!cl</samp> 这样的警告。随着下载这个文件的人越来越多，杀毒软件会修复误报。但每次Mod更新后，便又可能出现这样的误报。
 
::* 杀毒软件可能会检测某些特定的行为，例如访问文件或重写代码。但只有进行这些操作，基于SMAPI的Mod才能实现各自的功能，毕竟需要对游戏本体进行修改。
 
::* 杀毒软件可能会检测某些特定的行为，例如访问文件或重写代码。但只有进行这些操作，基于SMAPI的Mod才能实现各自的功能，毕竟需要对游戏本体进行修改。
   第146行： 第193行：  
::*# 暂时禁用杀毒软件。
 
::*# 暂时禁用杀毒软件。
 
::*# 重新下载并[[模组:使用指南/入门#安装SMAPI|安装SMAPI]]或其他Mod。
 
::*# 重新下载并[[模组:使用指南/入门#安装SMAPI|安装SMAPI]]或其他Mod。
−
::*# 将[[模组:使用指南/入门#游戏文件夹|整个游戏文件夹]]加入杀毒软件的白名单。您可能需要在网上搜索一下如何在您使用的杀毒软件中添加白名单。
+
::*# 将[[模组:使用指南/入门# 找到你的 游戏文件夹|整个游戏文件夹]]加入杀毒软件的白名单。您可能需要在网上搜索一下如何在您使用的杀毒软件中添加白名单。
   −
===SMAPI无法识别手柄（仅限Steam）===
+
==SMAPI无法识别手柄（仅限Steam）==
 
 常用解决方案：
 
 常用解决方案：
 
# 通过Steam启动游戏。
 
# 通过Steam启动游戏。
−
# 对于Windows：请确保您正确设置了启动项（查看[[模组:在Windows上安装SMAPI# 通过Steam或GOG Galaxy 启 动SMAPI| 如何在Steam或GOG Galaxy上 设置启动项]]），请不要在Steam内将SMAPI添加为“非Steam游戏”。
+
# 对于Windows：请确保您正确设置了启动项（查看[[模组:在Windows上安装SMAPI# 设置游戏平台 启 动项|设置 游戏平台 启动项]]），请不要在Steam内将SMAPI添加为“非Steam游戏”。
 
# 对于使用Steam的用户，进入Steam的设置界面，选择控制器选项，然后点击常规控制器设置，勾选您需要使用的手柄。如下图所示：<br />[[File:Modding - Player Guide - Troubleshooting - Steam Controller Support 01 ZH.png|700px]]<br /><br />[[File:Modding - Player Guide - Troubleshooting - Steam Controller Support 02 ZH.png|700px]]<br />
 
# 对于使用Steam的用户，进入Steam的设置界面，选择控制器选项，然后点击常规控制器设置，勾选您需要使用的手柄。如下图所示：<br />[[File:Modding - Player Guide - Troubleshooting - Steam Controller Support 01 ZH.png|700px]]<br /><br />[[File:Modding - Player Guide - Troubleshooting - Steam Controller Support 02 ZH.png|700px]]<br />
 
# 如果以上方法均无效，您可以使用一些第三方软件来添加手柄支持。下面是一些推荐的软件：
 
# 如果以上方法均无效，您可以使用一些第三方软件来添加手柄支持。下面是一些推荐的软件：
第159行： 第206行：     
{{collapse|Linux/Mac上的最后一招|content=&#32;
 
{{collapse|Linux/Mac上的最后一招|content=&#32;
−
 对于Linux或Mac用户，最后一个办法是禁用SMAPI控制台窗口。但禁用后您便只能通过[[#基本步骤|查看SMAPI日志文件]]来查看Mod错误或更新信息，此外每当您的游戏崩溃后，只有手动删除 <tt>smapi-internal/StardewModdingAPI.crash.marker</tt> 文件才能再次打开游戏。您应该定期查看SMAPI日志来确保Mod运行正常。如果您到这里依然想尝试这个办法，请按下面的步骤操作：
+
 对于Linux或Mac用户，最后一个办法是禁用SMAPI控制台窗口。但禁用后您便只能通过[[#基本步骤|查看SMAPI日志文件]]来查看Mod错误或更新信息，此外每当您的游戏崩溃后，只有手动删除 <samp>smapi-internal/StardewModdingAPI.crash.marker</samp> 文件才能再次打开游戏。您应该定期查看SMAPI日志来确保Mod运行正常。如果您到这里依然想尝试这个办法，请按下面的步骤操作：
    
<ul>
 
<ul>
 
<li>Linux:
 
<li>Linux:
 
<ol>
 
<ol>
−
<li>[[模组:使用指南/入门#游戏文件夹|找到您的游戏文件夹]]。</li>
+
<li>[[模组:使用指南/入门# 找到你的 游戏文件夹|找到您的游戏文件夹]]。</li>
−
<li>使用文本编辑器打开名为 <tt>StardewValley</tt> 的文件（没有文件拓展名）。</li>
+
<li>使用文本编辑器打开名为 <samp>StardewValley</samp> 的文件（没有文件拓展名）。</li>
−
<li>删除在 <tt># open SMAPI in terminal</tt> 下面的整个段落（直到内容为 <code>fi</code> 的一行为止）。</li>
+
<li>删除在 <samp># open SMAPI in terminal</samp> 下面的整个段落（直到内容为 <code>fi</code> 的一行为止）。</li>
 
<li>在最底部找到以下文本：
 
<li>在最底部找到以下文本：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
第181行： 第228行：  
<li>Mac：
 
<li>Mac：
 
<ol>
 
<ol>
−
<li>[[模组:使用指南/入门#游戏文件夹|找到您的游戏文件夹]]。</li>
+
<li>[[模组:使用指南/入门# 找到你的 游戏文件夹|找到您的游戏文件夹]]。</li>
−
<li>使用文本编辑器打开名为 <tt>StardewValley</tt> 的文件（没有文件拓展名）。</li>
+
<li>使用文本编辑器打开名为 <samp>StardewValley</samp> 的文件（没有文件拓展名）。</li>
 
<li>找到以下文本：
 
<li>找到以下文本：
 
<syntaxhighlight lang="bash">open -a Terminal ./StardewModdingAPI.bin.osx $@</syntaxhighlight>
 
<syntaxhighlight lang="bash">open -a Terminal ./StardewModdingAPI.bin.osx $@</syntaxhighlight>
第195行： 第242行：  
}}
 
}}
   −
===更新到最新版本后，启动游戏后仍然显示需要更新SMAPI或游戏本体===
+
==更新到最新版本后，启动游戏后仍然显示需要更新SMAPI或游戏本体==
 
 这通常是因为您在电脑上的不同文件夹内同时有两份游戏，其中一份已更新到最新版，但您正在的玩的却是另一份。
 
 这通常是因为您在电脑上的不同文件夹内同时有两份游戏，其中一份已更新到最新版，但您正在的玩的却是另一份。
   第205行： 第252行：  
 此时最好的办法就是卸载不需要的游戏版本，只保留一份。您可以按照以下步骤进行操作：
 
 此时最好的办法就是卸载不需要的游戏版本，只保留一份。您可以按照以下步骤进行操作：
   −
# 将您的 <tt>Mods</tt> 文件夹复制到其他地方。
+
# 将您的 <samp>Mods</samp> 文件夹复制到其他地方。
 
# 卸载游戏。
 
# 卸载游戏。
 
# 将您先前找到的两个游戏文件夹都删掉。
 
# 将您先前找到的两个游戏文件夹都删掉。
 
# 通过Steam或GOG Galaxy重新安装游戏。
 
# 通过Steam或GOG Galaxy重新安装游戏。
 
# 重新安装SMAPI，此时它应当能正确检测出您唯一的游戏路径了。
 
# 重新安装SMAPI，此时它应当能正确检测出您唯一的游戏路径了。
−
# 将您备份的 <tt>Mods</tt> 文件夹复制回刚刚安装的游戏文件夹中。
+
# 将您备份的 <samp>Mods</samp> 文件夹复制回刚刚安装的游戏文件夹中。
    
{{collapse|其他选择|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=如果您确实需要同时安装多份游戏，您可以将SMAPI的安装程序复制到您想要更新SMAPI的游戏版本的子文件夹中。当您运行SMAPI的安装程序时，它会自动检测上一级的文件夹并更新SMAPI。}}
 
{{collapse|其他选择|css=border: 1px solid #666; margin-top: 1em; padding: 0.2em;|content=如果您确实需要同时安装多份游戏，您可以将SMAPI的安装程序复制到您想要更新SMAPI的游戏版本的子文件夹中。当您运行SMAPI的安装程序时，它会自动检测上一级的文件夹并更新SMAPI。}}
   −
==修复特定问题==
+
=修复特定问题=
−
==="SMAPI can't find the game"===
+
=="SMAPI can't find the game"==
−
* 请确保您运行的是在游戏文件夹中的 <code>StardewModdingAPI.exe</code> 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
+
* 请确保您运行的是在游戏文件夹中的 {{executable name|StardewModdingAPI}} 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
−
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code> ，在Linux/Mac上应该为 <code>internal/Mono</code>  。
+
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code>。
   −
==="Skipped '...' because it doesn't have a manifest.json"===
+
==Oops You don't have the required .NET version installed（仅限Windows）==
−
SMAPI 在 这个Mod对应 的 文件夹 中 无法 找到 <code>manifest.json</code>  文件 。 这通 常 是 因为 这不是一款基于SMAPI的Mod。 请 查看 位 于该Mod发布页或其他 位 置的文档来进行 安装。
+
=== 如果您是64位Windows 10或以上的系统===
 +
# 确保您已经按照[[模组:在Windows上安装SMAPI#安装SMAPI|在Windows上安装SMAPI]]页面中的步骤安装了'''正确的.NET 5版本'''。
 +
# 尝试修改系统环境变量：
 +
## 同时在键盘上按下Windows+{{key|R}}键， 在 弹出的运行窗口中输入<code>sysdm.cpl</code>，然后点击“确定”。
 +
## 在弹出的“系统属性”窗口中切换到“高级”一栏，然后点击右下角的“环境变量”按钮。
 +
## 在下半部分 的 系统变量列表 中找到 名为“Path”的变量，点击“编辑”按钮。<br />[[File:Modding - Player Guide - Troubleshooting - Environment Variables 01 ZH.png|thumb|none|600px|编辑环境变量 图1]]
 +
## 在新弹出的“编辑环境变量”窗口中查看是否有<code>C:\Program Files\dotnet\</code> 这一项。如果有这一项，将其选中，多次重复点击右侧的“上移”按钮，将其移动到列表的最顶部；如果没有这一项，您可以点击右侧的“新建”按钮在文本框中手动输入这一项，并同样将它上移至列表最顶部。<br />[[File:Modding - Player Guide - Troubleshooting - Environment Variables 02 ZH.png|thumb|none|600px|编辑环境变量 图2]]
 +
## 依次点击每个窗口的“确定”，直到你关闭前面几个步骤中打开的所有窗口（即最后点击“系统属性”窗口的“确定”按钮） 。
 +
## 重新运行SMAPI安装程序，此时应该一切正 常 了。
 +
# 如果按照以上步骤依然无法解决问题，请[[#寻求帮助|寻求帮助]]。
 +
 
 +
===如果您是64位Windows 7系统===
 +
微软已经停止支持Windows 7系统，建议您将系统升级至Windows 10。如果您 因为 种种原因无法升级， 请 参考以下步骤解决问题：
 +
# 按照[https://docs.microsoft.com/zh-cn/dotnet/core/install/windows?tabs=net50#windows-7--vista--81--server-2008-r2--server-2012-r2 微软官方的.NET 安装指南]在Windows 7上安装依赖组件后，再安装.NET 5 （即安装[https://aka.ms/vs/16/release/vc_redist.x64.exe Microsoft Visual C++ 2015-2019 Redistributable 64 位]和[https://www.microsoft.com/zh-CN/download/details.aspx?id=47442 KB3063858 64 位]）。<br />[[File:Modding - Player Guide - Troubleshooting - Windows 7 Guide ZH.png|thumb|none|600px|在Windows 7上 安装.NET 5]]
 +
# 如果继续出现该错误，您可能还需要按照上面的方法修改系统环境变量 。
   −
==="missing executable"（仅限Steam）===
+
=== 如果您是32位系统===
−
Steam 无法 找 到游戏 启动器 ， 通常 是 您在Steam 上 设置 的 启动选项不正确导致 的。
+
很抱歉，您 无法 再使用Mod游玩1.5.5和之后版本的《星露谷物语》，建议您将系统升级至64位Windows 10或以上版本。但您可以通过修改游戏至支持32位游戏的“compability版本”，继续游玩游戏本体：
−
常用解决方案：
+
# 打开Steam，在“库”中右键点击“Stardew Valley”，点击属性。
 +
# 在弹出的属性窗口中，切换 到 “测试版”一栏，然后在下拉框中选择“compability - For 32-bit systems”版本。
 +
# 等待游戏更新完成后，您便可以开始游戏了！<br />[[File:Modding - Player Guide - Troubleshooting - Compatibility Branch ZH.png|700px]]
 +
# 如果 游戏 无法打开 ， 您可能需要安装（或 是 重新安装）4.5.2或以 上 版本 的 [https://dotnet.microsoft.com/download/dotnet-framework-runtime/net452 .NET Framework] 和4.0版本 的 [https://www.microsoft.com/en-us/download/details.aspx?id=27598 XNA Framework] 。
   −
* 如果您 想 使 用SMAPI进行游戏：<br />请确保您已经安装了SMAPI且正确设置了启动选项 （ 查看[[模组:使用指南/ 入门#安装SMAPI|SMAPI 安装 指南]]） 。
+
  除此以外， 如果您使 用的是Steam平台，您也可以考虑使用[https://github.com/Jack-Myth/SteamDepotDownloader-GUI/releases SteamDepotDownloader-GUI] （[https://tieba.baidu.com/p/7634538501 图文 使用指南]）或[https://github.com/SteamRE/DepotDownloader DepotDownloader]或将游戏回退至1.5.4甚至更早的版本，并 安装 旧版SMAPI（游戏1.5.4版本对应的SMAPI版本为[https://www.nexusmods.com/stardewvalley/mods/2400?tab=files&file_id=46226 3.12.8]） 和旧版Mod（游戏1.5.4版本需 要下 载2021年12月之前 的 旧版Mod）游玩 。
−
* 如果您想 要 卸载SMAPI：
  −
*# 在Steam客户端中，右键点击'''Stardew Valley'''并选择'''属性'''。
  −
* 在弹出窗口中，清空'''启动选项''' 下 文本框内 的 所有文字 。
     −
==="looks like Mono isn't installed" （仅 限Linux/Mac ）===
+
==A compatible .NET SDK is not installed（仅 限Windows ）==
−
  只有 安 装Mono这个框架后 ，SMAPI 及其安装程序才能正常工作。安装[http://mono-project.com/ Mono] 并重启您 的 电脑通常可以修复这个问题 。
+
  如果您在 安 装或启动SMAPI时 ，SMAPI 控制台窗口报错"Could not execute because the application was not found or a compatible .NET SDK is not installed."，请参见[[#Oops You don't have the required .NET version installed（仅限Windows）|Oops You don't have the required .NET version installed问题]]的 解决方案 。
   −
在Mac上，安装Mono后可能依然无法正常运行。您可以尝试以下步骤：
+
=="Skipped '...' because it doesn't have a manifest.json"==
−
* 输入这行命令： <syntaxhighlight lang="bash">ln -s /Library/Frameworks/Mono.framework/Versions/Current/bin/mono /usr/local/bin/mono</syntaxhighlight>
+
SMAPI 在 这个Mod对应的文件夹 中 无法找到 <code>manifest.json</code>  文件。这通常是因为这不是一款基于SMAPI的Mod。请查看位于该Mod发布页或其他位置的文档来进行安装 。
−
* 如果运行以上命令后报错或不起作用，您可以安装[https://brew.sh install Homebrew]并 在 终端 中 运行这行命令 <code>brew install mono mono-libgdiplus</code> 。
     −
===Could not load file or assembly===
+
==Could not load file or assembly==
−
 如果报错的"file or assembly"（文件或程序集）以 <tt>Microsoft</tt> 或 <tt>System</tt> 开头（例如"FileNotFoundException: Could not load file or assembly 'System.[...]' or one of its dependencies"），这说明游戏依赖的核心框架出了问题。
+
 如果报错的"file or assembly"（文件或程序集）以 <samp>Microsoft</samp> 或 <samp>System</samp> 开头（例如"FileNotFoundException: Could not load file or assembly 'System.[...]' or one of its dependencies"），这说明游戏依赖的核心框架出了问题。
   −
<ol>
+
常用解决方案：
−
<li> 常用解决方案：
+
* [[# 重置 游戏 文件|重 置游戏文件]]。
−
{| class="wikitable"
+
* 如果 上 面的方法 不 起作用 ，您可 以尝试卸载星露谷物语 （ 且删除星露谷物语的整个游戏文件夹 ）， 然后重新安装游戏 。
−
|-
  −
! 平台
  −
! 需要重新的安装框架
  −
|-
  −
| Windows
  −
| [[#游戏 无法启动|重 新安装.NET Framework 4.5.2 和 XNA Framework 4.0]] （必须为该版本的框架）。
  −
|-
  −
| Linux
  −
| 重新安装 [https://www.mono-project.com/download/stable/ <tt>mono-complete</tt>]。
  −
|-
  −
| Mac
  −
| 重新安装 [https://www.mono-project.com/download/stable/ Mono] （任意分支均可）。
  −
|}</li>
  −
<li>在Windows 上 ，在极少情况下重新安装以上框架并 不 能解决问题。但由于.NET Framework是Windows底层的一部分 ， 很难修复。在这种情况下 您可 能需要[https://support.microsoft.com/zh-cn/windows/%E9%87%8D%E7%BD%AE%E6%88%96%E9%87%8D%E6%96%B0%E5%AE%89%E8%A3%85-windows-10-cd352bd8-4cb6-411a-f2f5-1814bd8d453c 重置Windows]，或是完全重装Windows 10 （ 非常不建议使用Windows 7 ） 。这个方法很麻烦 ， 但应该能解决问题了 。</li>
  −
</ol>
     −
===加载存档时游戏无响应 （ 仅限Mac）===
+
（ 星露谷物语现在已经将需要的依赖组件打包 在游戏 文件中 ， 所 以 你应该不需要再自己手动 安装 它们了。 ）
−
'''仅适用于Mac'''： 在 您创建或加载存档时 游戏 无响应 ， 您可 以 尝试重新 安装[https://www.mono-project.com/download/stable/ Mono]（任意分支均可 ） ，这通常可以解决该问题。如果不起作用，您可以[[#寻求帮助|寻求帮助]]。
     −
===启用SMAPI后游戏分辨率发生变化（仅限Windows）===
+
==启用SMAPI后游戏分辨率发生变化（仅限Windows）==
 
 在您启用SMAPI运行游戏后，游戏内的一切都变得更大或更小了。这通常是Windows DPI设置的问题。
 
 在您启用SMAPI运行游戏后，游戏内的一切都变得更大或更小了。这通常是Windows DPI设置的问题。
    
 常用解决方案：
 
 常用解决方案：
−
# 右键点击 <tt>StardewModdingAPI.exe</tt> 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
+
# 右键点击 {{executable name|StardewModdingAPI}} 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
−
# 右键点击 <tt>Stardew Valley.exe</tt> 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
+
# 右键点击 {{executable name|Stardew Valley}} 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
−
# 将 <tt>StardewModdingAPI.exe</tt> 的高DPI设置窗口内的选项调整为 <tt>StardewValley.exe</tt> 内的选项。
+
# 将 {{executable name|StardewModdingAPI}} 的高DPI设置窗口内的选项调整为 {{executable name|StardewValley}} 内的选项 。
 +
 
 +
此外，您也可以尝试更改游戏内设置，将游戏“窗口模式”更改为“窗口”，然后再更改为“全屏”模式，设置为适合您的分辨率（通常为1920×1080分辨率） 。
   −
==修复其他问题==
+
=修复其他问题=
−
 运行[[模组:使用指南/入门#游戏文件夹|游戏文件夹]]内的 <code>Stardew Valley.exe</code> （Windows）或 <code>StardewValley-original</code>（Linux/Mac），以跳过SMAPI直接启动游戏。
+
 运行[[模组:使用指南/入门# 找到你的 游戏文件夹|游戏文件夹]]内的 {{executable name|Stardew Valley}} （Windows）或 <code>StardewValley-original</code>（Linux/Mac），以跳过SMAPI直接启动游戏。
    
* 如果这些问题在未启用SMAPI时依旧发生：查看[https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ 这篇来自Steam的指南]来修复您的游戏。如果您仍然需要帮助，请[[#寻求帮助|寻求帮助]]。
 
* 如果这些问题在未启用SMAPI时依旧发生：查看[https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ 这篇来自Steam的指南]来修复您的游戏。如果您仍然需要帮助，请[[#寻求帮助|寻求帮助]]。
 
* 如果这些问题仅在启用SMAPI时发生，请[[#寻求帮助|寻求帮助]]。
 
* 如果这些问题仅在启用SMAPI时发生，请[[#寻求帮助|寻求帮助]]。
   −
==寻求帮助==
+
=寻求帮助=
 
 查看[[模组:帮助]]页面以寻求帮助。
 
 查看[[模组:帮助]]页面以寻求帮助。
  
Pathoschild
8,404

个编辑

取自“https://zh.stardewvalleywiki.com/Special:移动版差异/19003...25792”