8,404
个编辑
更改
tweak styles to match recent changes on English wiki
{{../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>
# 如果遵循以上步骤后您仍然遇到了错误，请查看本页面的[[#常见问题解答|常见问题解答]]部分，或[[#寻求帮助|寻求帮助]]。
# 如果遵循以上步骤后您仍然遇到了错误，请查看本页面的[[#常见问题解答|常见问题解答]]部分，或[[#寻求帮助|寻求帮助]]。
==重置游戏文件==
许多问题都是游戏文件损坏导致的（尤其是在您[[模组:使用 XNB 模组|使用XNB Mod]]时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。
许多问题都是游戏文件损坏导致的（尤其是在您[[模组:使用 XNB 模组|使用XNB Mod]]时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。
}}
}}
<div style="border: 1px solid red; background: #FCC; padding: 1em;">'''注意：'''XNB Mod是直接替换游戏文件的Mod，现在已经[[模组:使用 XNB 模组|不再被推荐使用]]，继续使用XNB Mod可能会导致许多意想不到的问题。重置游戏文件将会移除您所有已安装的XNB Mod。重置完成后，您可以考虑'''[[模组:使用 XNB 模组|使用基于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，它可能会显示“正在启动”。）下面的方法可能会帮您解决这个问题：
# 重启电脑。
# 重启电脑。
## [[#寻求帮助|附上您的SMAPI日志寻求帮助]]。
## [[#寻求帮助|附上您的SMAPI日志寻求帮助]]。
==游戏无响应或崩溃==
在您打开游戏后，还未进入到标题界面游戏便无响应或崩溃了。下面的方法可能会帮您解决这个问题：
在您打开游戏后，还未进入到标题界面游戏便无响应或崩溃了。下面的方法可能会帮您解决这个问题：
# 尝试[[#游戏无法启动|游戏无法启动]]这部分的所有方法。
# 尝试[[#游戏无法启动|游戏无法启动]]这部分的所有方法。
# 如果以上方法均无效，请按照步骤[[#寻求帮助|寻求帮助]]。
# 如果以上方法均无效，请按照步骤[[#寻求帮助|寻求帮助]]。
==Steam显示游戏正在运行，但没有窗口出现（仅限Windows）==
在您从Steam启动游戏后，Steam显示游戏正在运行，但过了很久依然没有游戏窗口出现，且点击Steam的停止按钮没有反应。这似乎是Steam的问题，您可以按照以下步骤来重新启动游戏：
在您从Steam启动游戏后，Steam显示游戏正在运行，但过了很久依然没有游戏窗口出现，且点击Steam的停止按钮没有反应。这似乎是Steam的问题，您可以按照以下步骤来重新启动游戏：
# 右键点击Windows任务栏，打开任务管理器，并点击窗口最左下角的箭头切换到详细信息。
# 右键点击Windows任务栏，打开任务管理器，并点击窗口最左下角的箭头切换到详细信息。
# 在极少部分情况下，您可能需要重复以上步骤2~3次。
# 在极少部分情况下，您可能需要重复以上步骤2~3次。
==更新 Stardew Valley 时发生错误（缺失可执行文件）（仅限Steam）==
* 如果您想使用SMAPI，请确保您[[模组:在Windows上安装SMAPI#Steam|在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]]
* 如果您不想使用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> 这个文件后有一个黑色的控制台窗口打开，然后立刻闪退，这可能是系统环境变量出现了问题。
如果您在安装SMAPI的操作过程中，双击运行 <samp>install on Windows.bat</samp> 这个文件后有一个黑色的控制台窗口打开，然后立刻闪退，这可能是系统环境变量出现了问题。
如果上述方法无法解决问题，请[[#寻求帮助|寻求帮助]]。
如果上述方法无法解决问题，请[[#寻求帮助|寻求帮助]]。
==游戏光标不受控制==
如果您在游戏时鼠标不受控制，并排除设备自身的问题后，可能是因为游戏自动侦测到的手柄模式开关错误，您可以按照以下方法之一解决。
如果您在游戏时鼠标不受控制，并排除设备自身的问题后，可能是因为游戏自动侦测到的手柄模式开关错误，您可以按照以下方法之一解决。
# 重新运行游戏，此时应该一切正常了。
# 重新运行游戏，此时应该一切正常了。
==游戏帧率过低（人物动作缓慢）==
星露谷物语正常情况下应该始终以60帧运行，如果您突然感觉游戏帧率过低，或是人物动作变缓，您可以先按以下步骤打开Steam内的游戏内帧率显示（或使用其他显示帧率的软件），确认游戏当前运行的帧率：
星露谷物语正常情况下应该始终以60帧运行，如果您突然感觉游戏帧率过低，或是人物动作变缓，您可以先按以下步骤打开Steam内的游戏内帧率显示（或使用其他显示帧率的软件），确认游戏当前运行的帧率：
# 打开游戏后，同时按下{{key|Shift}}+{{key|Tab}}。
# 打开游戏后，同时按下{{key|Shift}}+{{key|Tab}}。
如果您发现采用上面的两个方法之一时，游戏帧率回到了60帧，那便说明一切正常了，您可以继续探索星露谷的世界了。如果该问题依然没有解决，请[[#寻求帮助|寻求帮助]]。
如果您发现采用上面的两个方法之一时，游戏帧率回到了60帧，那便说明一切正常了，您可以继续探索星露谷的世界了。如果该问题依然没有解决，请[[#寻求帮助|寻求帮助]]。
==游戏没有声音（仅限Windows）==
您的浏览器或是其他软件均能正常播放声音，但游戏却没有声音。下面的方法可能会帮您解决这个问题：
您的浏览器或是其他软件均能正常播放声音，但游戏却没有声音。下面的方法可能会帮您解决这个问题：
# 重启电脑。
# 重启电脑。
# [[#游戏无法启动|重新安装.NET 5]]。
# [[#游戏无法启动|重新安装.NET 5]]。
==存档丢失或无法加载==
请查看[[存档#疑难解答]]。
请查看[[存档#疑难解答]]。
==合作模式中无法与其他玩家联机==
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
# 确保您的游戏已经更新到了最新版本（WeGame最新版本为{{version|wegame|link=0}}，其他平台最新版本为{{version|link=0}}）。<br /><small>在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。</small>
# 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项，然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏，即使您的存档中有空闲的[[联机小屋]]，其他玩家也不能加入您的游戏，您只能在单人模式下进行游戏。
# 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项，然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏，即使您的存档中有空闲的[[联机小屋]]，其他玩家也不能加入您的游戏，您只能在单人模式下进行游戏。
对于主机玩家，请尽量尝试上述方法中您能实现的部分（尤其是靠前的方法），您也可以尝试重启您的主机。请注意，主机玩家需要购买对应平台的联机服务才能进行联机游戏。
对于主机玩家，请尽量尝试上述方法中您能实现的部分（尤其是靠前的方法），您也可以尝试重启您的主机。请注意，主机玩家需要购买对应平台的联机服务才能进行联机游戏。
==合作模式中频繁掉线==
在客机进行游戏时，经常与主机断开连接，或是各个游戏玩家之间游戏内时间相差较大。这种情况一般是主机或客机玩家的网络不稳定导致的。无论是您家中的网络或是宽带运营商的网络，都可能导致网络不稳定。
在客机进行游戏时，经常与主机断开连接，或是各个游戏玩家之间游戏内时间相差较大。这种情况一般是主机或客机玩家的网络不稳定导致的。无论是您家中的网络或是宽带运营商的网络，都可能导致网络不稳定。
如果尝试以上方法后客机依然会频繁掉线，也可以尝试重新创建一个由其他玩家主持的存档进行游戏，或是寻求宽带运营商服务人员等专业人士帮助。
如果尝试以上方法后客机依然会频繁掉线，也可以尝试重新创建一个由其他玩家主持的存档进行游戏，或是寻求宽带运营商服务人员等专业人士帮助。
==SMAPI文件丢失或报毒==
您正在使用的杀毒软件可能会将SMAPI/Mod的文件删除，或是对这些文件报毒。但它们几乎都是误报，SMAPI本身也是没有木马病毒的。
您正在使用的杀毒软件可能会将SMAPI/Mod的文件删除，或是对这些文件报毒。但它们几乎都是误报，SMAPI本身也是没有木马病毒的。
::*# 将[[模组:使用指南/入门#找到你的游戏文件夹|整个游戏文件夹]]加入杀毒软件的白名单。您可能需要在网上搜索一下如何在您使用的杀毒软件中添加白名单。
::*# 将[[模组:使用指南/入门#找到你的游戏文件夹|整个游戏文件夹]]加入杀毒软件的白名单。您可能需要在网上搜索一下如何在您使用的杀毒软件中添加白名单。
==SMAPI无法识别手柄（仅限Steam）==
常用解决方案：
常用解决方案：
# 通过Steam启动游戏。
# 通过Steam启动游戏。
}}
}}
==更新到最新版本后，启动游戏后仍然显示需要更新SMAPI或游戏本体==
这通常是因为您在电脑上的不同文件夹内同时有两份游戏，其中一份已更新到最新版，但您正在的玩的却是另一份。
这通常是因为您在电脑上的不同文件夹内同时有两份游戏，其中一份已更新到最新版，但您正在的玩的却是另一份。
{{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"==
* 请确保您运行的是在游戏文件夹中的 <code>StardewModdingAPI.exe</code> 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
* 请确保您运行的是在游戏文件夹中的 {{executable name|StardewModdingAPI}} 程序（查看[[模组:使用指南/入门#安装SMAPI|SMAPI安装指南]]）。
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code>。
* 如果您是使用手动方式安装的SMAPI（没有[[模组:使用指南/入门#安装SMAPI|使用SMAPI安装程序]]），请确保您安装时复制了正确文件：在Windows上应该为 <code>internal/Windows</code>。
==Oops You don't have the required .NET version installed（仅限Windows）==
===如果您是64位Windows 10或以上的系统===
# 确保您已经按照[[模组:在Windows上安装SMAPI#安装SMAPI|在Windows上安装SMAPI]]页面中的步骤安装了'''正确的.NET 5版本'''。
# 确保您已经按照[[模组:在Windows上安装SMAPI#安装SMAPI|在Windows上安装SMAPI]]页面中的步骤安装了'''正确的.NET 5版本'''。
# 尝试修改系统环境变量：
# 尝试修改系统环境变量：
# 如果按照以上步骤依然无法解决问题，请[[#寻求帮助|寻求帮助]]。
# 如果按照以上步骤依然无法解决问题，请[[#寻求帮助|寻求帮助]]。
===如果您是64位Windows 7系统===
微软已经停止支持Windows 7系统，建议您将系统升级至Windows 10。如果您因为种种原因无法升级，请参考以下步骤解决问题：
微软已经停止支持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]]
# 按照[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]]
# 如果继续出现该错误，您可能还需要按照上面的方法修改系统环境变量。
# 如果继续出现该错误，您可能还需要按照上面的方法修改系统环境变量。
===如果您是32位系统===
很抱歉，您无法再使用Mod游玩1.5.5和之后版本的《星露谷物语》，建议您将系统升级至64位Windows 10或以上版本。但您可以通过修改游戏至支持32位游戏的“compability版本”，继续游玩游戏本体：
很抱歉，您无法再使用Mod游玩1.5.5和之后版本的《星露谷物语》，建议您将系统升级至64位Windows 10或以上版本。但您可以通过修改游戏至支持32位游戏的“compability版本”，继续游玩游戏本体：
# 打开Steam，在“库”中右键点击“Stardew Valley”，点击属性。
# 打开Steam，在“库”中右键点击“Stardew Valley”，点击属性。
除此以外，如果您使用的是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）游玩。
除此以外，如果您使用的是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）游玩。
==A compatible .NET SDK is not installed（仅限Windows）==
如果您在安装或启动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问题]]的解决方案。
如果您在安装或启动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问题]]的解决方案。
=="Skipped '...' because it doesn't have a manifest.json"==
SMAPI在这个Mod对应的文件夹中无法找到 <code>manifest.json</code> 文件。这通常是因为这不是一款基于SMAPI的Mod。请查看位于该Mod发布页或其他位置的文档来进行安装。
SMAPI在这个Mod对应的文件夹中无法找到 <code>manifest.json</code> 文件。这通常是因为这不是一款基于SMAPI的Mod。请查看位于该Mod发布页或其他位置的文档来进行安装。
==Could not load file or assembly==
如果报错的"file or assembly"（文件或程序集）以 <samp>Microsoft</samp> 或 <samp>System</samp> 开头（例如"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"），这说明游戏依赖的核心框架出了问题。
（星露谷物语现在已经将需要的依赖组件打包在游戏文件中，所以你应该不需要再自己手动安装它们了。）
（星露谷物语现在已经将需要的依赖组件打包在游戏文件中，所以你应该不需要再自己手动安装它们了。）
==启用SMAPI后游戏分辨率发生变化（仅限Windows）==
在您启用SMAPI运行游戏后，游戏内的一切都变得更大或更小了。这通常是Windows DPI设置的问题。
在您启用SMAPI运行游戏后，游戏内的一切都变得更大或更小了。这通常是Windows DPI设置的问题。
常用解决方案：
常用解决方案：
# 右键点击 <samp>StardewModdingAPI.exe</samp> 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
# 右键点击 {{executable name|StardewModdingAPI}} 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
# 右键点击 <samp>Stardew Valley.exe</samp> 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
# 右键点击 {{executable name|Stardew Valley}} 应用程序，打开属性窗格。依次选择'''兼容性''' > '''更改高DPI设置'''。保持弹出的窗口处于打开状态。
# 将 <samp>StardewModdingAPI.exe</samp> 的高DPI设置窗口内的选项调整为 <samp>StardewValley.exe</samp> 内的选项。
# 将 {{executable name|StardewModdingAPI}} 的高DPI设置窗口内的选项调整为 {{executable name|StardewValley}} 内的选项。
此外，您也可以尝试更改游戏内设置，将游戏“窗口模式”更改为“窗口”，然后再更改为“全屏”模式，设置为适合您的分辨率（通常为1920×1080分辨率）。
此外，您也可以尝试更改游戏内设置，将游戏“窗口模式”更改为“窗口”，然后再更改为“全屏”模式，设置为适合您的分辨率（通常为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时发生，请[[#寻求帮助|寻求帮助]]。
=寻求帮助=
查看[[模组:帮助]]页面以寻求帮助。
查看[[模组:帮助]]页面以寻求帮助。