模组:使用指南/疑难解答
← 模组:目录
模组使用指南
入门
疑难解答
按键绑定
兼容性（站外）
如果您在进行游戏时遇到了各种错误，那么这个页面就是为您准备的！（此页面不仅仅面向使用Mod的玩家。）
目录
1 基本知识
1.1 常用解决方案
1.2 基本步骤
1.3 重置游戏文件
1.4 在独立显卡上运行游戏（仅 Windows）
1.5 关于星露谷物语1.6的问答
1.6 游戏无法启动
2 特定错误信息
2.1 "Could not load 'Stardew Valley' or one of its dependencies"
2.2 "The game failed to launch: Microsoft.Xna.Framework.Graphics.NoSuitableGraphicsDeviceException: Failed to create graphics device"
2.3 "Skipped '...' because it doesn't have a manifest.json"
2.4 "missing executable"（仅适用于Steam）
2.5 "Could not load file or assembly"
2.6 OutOfMemoryException报错
2.7 SMAPI卡在加载界面
2.8 NoAudioHardwareException: Audio has failed to initialize
2.9 Mac: Contents/MacOS/StardewValley Already Exists
3 其他问题
3.1 游戏时延迟或卡顿
3.2 游戏音频无法播放或走调（仅Windows）
3.3 使用SMAPI启动游戏时分辨率改变（仅Windows）
3.4 存档消失或无法加载
3.5 多人游戏中无法联机
3.6 SMAPI或模组文件消失了，或被杀毒软件/浏览器拦截
3.7 SMAPI无法识别手柄（仅Steam）
3.8 光标卡在博物馆或建筑界面中
3.9 安装新版后，启动游戏时仍显示旧版的SMAPI或游戏
3.10 SMAPI安装器打开后闪退
3.11 两个存档副本
3.12 宠物事件无限播放
3.13 使用SteamLink或其他Steam RemotePlay启动时游戏画面卡住
4 已知问题
4.1 无法在兼容性分支上运行SMAPI
5 寻求帮助
5.1 报告漏洞
5.2 寻求帮助
基本知识
常用解决方案
基本步骤
重启电脑。
确保您的游戏已经更新到了 1.6.15 或更高版本。
在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。
在 Steam 中右击游戏名称，然后点击“属性”，查看“测试版”选项卡。如果您希望使用 SMAPI，则不能选择 32-bit 版本。更多信息详见 SMAPI 不能在兼容性分支上运行。
重置游戏文件。
如果您正在使用SMAPI： SMAPI日志解析器
确保您已经安装了最新版本的SMAPISMAPI控制台窗口的左上角会显示当前运行的SMAPI版本。
按照这里的说明，或是日志解析器的介绍，找到SMAPI在您电脑上储存的日志，并将其上传到日志解析器中进行分析。它可以帮助您分析一些常见错误。右侧的图片将告诉您如何读懂SMAPI的日志。
如果该网页显示日志文件过大或解析时间过长，请用任意文本编辑器打开该日志，截取日志最顶端到第一个报错结束之间的内容，再上传此内容。
日志靠近最上方的位置显示了需要更新的Mod。您也可以使用Mod Update Menu来在游戏主菜单内检视已安装Mod的更新情况。当您在使用Mod进行游戏时遇到了任何问题时，第一件事都应当是更新这个列表里的所有Mod（即便有些Mod未更新时看起来也能正常使用）。
如果您已将问题定位到了一个或一系列特定的Mod上，请试着卸载并重新安装这些Mod。
删除导致问题的Mod的所有相关文件夹，同时确保您已经核查了Mod发布页中提到的所有文件夹。（如果您是从Nexus下载的Mod，您可以点击“Preview File Contents”来查看Mod所包含的文件。在ModDrop上，您可以在侧边栏的“Files”中找到相关信息。）
重新下载这些Mod，并按照Mod发布页的使用说明重新安装Mod。如果您习惯于使用Mod管理器，重新安装时也请使用手动安装方式，从而排除是Mod管理器没有将文件放到正确位置而造成问题的可能性。
如果遵循以上步骤后您仍然遇到了错误，请查看本页面的常见问题解答部分，或寻求帮助。
重置游戏文件
许多问题都是游戏文件损坏导致的（尤其是在您使用 XNB 模组时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。
查看针对您的平台的指南：
Steam
GOG Galaxy
Xbox（参见“更新和修复游戏”一栏）
更多方法
如果您不想重置所有游戏文件，您可以使用下面提及的其他方法。
方法2：获得并备份原版游戏文件，以替换任何损坏的文件
如果您安装了 XNB 模组并造成了游戏损坏，您可以仅重置损坏的文件。如果您在安装模组之前没有备份原版游戏文件，可以按照以下方法获取它们，且保留您已经修改过的游戏文件。
在游戏目录下新建名为 Content-modded 的文件夹，并将 Content 文件夹内的所有文件复制到 Content-modded 内。
按照Steam 平台的说明或是GOG 平台的说明重置游戏文件。
在游戏目录下新建名为 Content-backup 的文件夹，并将刚刚已恢复原版文件的 Content 文件夹内的所有文件移动到 Content-backup 内。
将 Content-modded 文件夹中的内容复制回 Content 文件夹。
现在您的游戏文件（ Content 文件夹）仍然是修改过的，但您已经获得了原版游戏文件（ Content-backup 文件夹）。只需要替换对应的损坏文件即可。
方法3：XNB 模组导致的问题
如果您安装使用了XNB 模组，但并不确定是哪个模组导致了问题，此外您也不想移除您所有的 XNB 模组，可以按照以下方法来确定是哪个模组导致的问题。
备份您想保留的所有 XNB 模组。
按照Steam 平台的说明或是 GOG 平台的说明重置游戏文件。
如果您正在 Linux/Mac 上使用SMAPI，需要重新安装 SMAPI 来修复启动器。
启动游戏来看看先前遇到的问题是否已被修复。如果问题依然出现，请查看帮助页面以寻求帮助。
如果已经修复，请每次只添加一个 XNB 模组，然后打开游戏看看是否出现问题。逐个尝试这些XNB 模组，直到找到有问题的为止（可能并不止一个）。然后将它移除，便可以继续正常游戏了。
注意：XNB Mod是直接替换游戏文件的Mod，现在已经不再被推荐使用，继续使用XNB Mod可能会导致许多意想不到的问题。重置游戏文件将会移除您所有已安装的XNB Mod。重置完成后，您可以考虑使用基于Content Pacher的Mod来替代这些XNB Mod。
在独立显卡上运行游戏（仅 Windows）
左侧步骤中提到的'high performance'选项
许多电脑允许用户使用两种不同方式运行游戏：集成显卡（CPU的一部分）和 独立显卡（NVIDIA 或 AMD 生产的独立显卡）。应当使用独立显卡运行星露谷物语，但是这不一定是您电脑的默认选项（尤其是笔记本）。如果您不确定您的游戏是否运行在独立显卡上，可以尝试下述步骤。这是安全的，即使这些步骤不起作用也不会造成任何问题。
使游戏运行在独显上：
在开始菜单中，搜索 Graphics Settings 并打开。
在打开的窗口中，点击靠近顶部的“浏览”然后选中游戏文件夹下面的 StardewModdingAPI.exe 文件。如果您没有安装SMAPI，则应当选择 Stardew Valley.exe。
在应用列表中，点击 StardewModdingAPI 下面的“选项”。如果您没有安装SMAPI，则应当点击 Stardew Valley。
将图形首选项设为“高性能”。
保存。
检查是否成功。
关于星露谷物语1.6的问答
模组也会更新到 1.6 版本吗？
星露谷物语 1.6 是一次重大更新，因此许多模组需要升级到 1.6 版本。
最新版的 SMAPI 和 Content Patcher 完全支持星露谷 1.6 版本。确认您将 SMAPI 和所有模组升级到了最新版。
发布的第一天就有 44% 的 SMAPI 准备就绪，此数量随着模组更新正在稳步增长。您可以查阅模组兼容性列表以了解您的模组是否更新，或在 SMAPI 控制台窗口查阅紫色的更新提示。
大多数内容包应当仍能正常工作，如果加载它们的模组已经更新。
大多数XNB 模组不兼容 1.6 版本。这种模组已经被淘汰许多年了，且其可能会引发贴图损坏或丢失、游戏内容丢失和游戏崩溃等问题。您可以重置游戏文件以移除已安装的 XNB 模组。
星露谷 1.6 对模组有何变化？
星露谷物语 1.6 有很多用于帮助模组开发者的改进，参见对应英文文档。对于玩家，该版本有许多玩家更改，在未来也会使得模组能做更多事情。
我可以回退到星露谷 1.5.6 直到模组更新好吗？
当然。如果您正在使用 Steam：
点击客户端中的 "Stardew Valley"。
点击右上角的齿轮图标，并选择“属性”。
前往“测试版”选项卡。
在“参与测试”下拉框中选择 "legacy_1.5.6"。
如果您正在使用 GOG：
启动 GOG Galaxy。
点击 Stardew Valley。
在上方的菜单中，点击 "Extras" 以参见早期版本的下载项。
游戏无法启动
在您试着启动游戏时，游戏无法启动。（如果您正在使用的是Steam，它可能会显示“正在启动”。）下面的方法可能会帮您解决这个问题：
重启电脑。
确保您已经插入耳机或麦克风。（需要一个可工作的音频设备才能正常运行游戏，您可以将它们设置为静音。）
如果您正在Windows上运行游戏：
安装（或是重新安装）.NET 5（通常情况下安装Windows x64版本即可）。您可能需要预先卸载 .NET Framework才能进行安装。
重启电脑。
运行游戏。
确保您在Steam上为星露谷物语设置的启动选项准确无误（如有必要，您可以先尝试删除所有的启动选项）。
安装并运行.NET 修复程序，依照它显示的步骤进行修复。
如果您正在Linux上运行游戏：
您默认的终端可能与游戏不兼容，请尝试安装XTERM终端。
如果以上方法均无效，您可以：
安装SMAPI（如果您还未安装）。
尝试运行游戏。
附上您的SMAPI日志寻求帮助。
1. 尝试常见解决方案：
重启电脑。
重置游戏文件或重装游戏。
删除 startup_preferences 文件（先打开存档文件夹，该文件在存档文件夹的上一级文件夹里）。
安装显卡软件（NVIDIA App 或 AMD Software），用它来升级显卡驱动。
禁用那些可能拦截游戏的程序。
针对不同平台的解决方案：
系统
常见解决方案
Windows
如果您正在使用 Steam，请再次检查您的启动选项。
Linux
如果您正在使用 Steam，请确保您的 Steam 启动选项为空。
您的默认终端可能不兼容。可以尝试安装 XTerm 终端）。
macOS
如果您正在使用 Steam，请确保您的 Steam 启动选项为空。
2.（仅适用于 Windows）使用独立显卡启动游戏。
参见在独立显卡上运行游戏（仅 Windows）。不要跳过这步！它往往能解决问题。
3. 检查是否存在报错信息。
打开游戏文件夹。
右击文件夹空白处。在 Windows，您需要先按住 Shift 再右击。
选择 "Open in Command Prompt"，"Open in PowerShell"，"Open in Windows Terminal"，"Open In Terminal" 或类似的选项（取决于您的系统类型/配置）。
输入如下命令：
游戏模式
命令
Windows 有模组
.\StardewModdingAPI.exe
Windows 无模组
.\"Stardew Valley.exe"
Mac/Linux 有模组
./StardewModdingAPI
Max/Linux 无模组
./"StardewValley"
按回车键运行命令。
如果报错，请参阅下文“特定错误信息”一节。
（注意：如果您不喜欢默认终端，也可以使用其他终端，包括 WSL 的终端。）
寻求帮助
如果您还是没能解决问题，欢迎来寻求帮助！
特定错误信息
"Could not load 'Stardew Valley' or one of its dependencies"
SMAPI 无法加载游戏的可执行文件。您可以尝试如下方法：
重置游戏文件。
确保您的星露谷物语为 1.6.15 或更高版本（按步骤 4 关闭 SMAPI、启动游戏，然后点击标题界面的 "?" 按钮，版本号就在左下角）。
使用最新版 SMAPI。
确保您在无 SMAPI 情况下也能启动游戏：
打开您的游戏文件夹。
双击 Stardew Valley.exe（Windows）或 StardewValley-original（Linux/macOS）。
如果不能启动游戏，参见“游戏无法启动”一节。
确保您在 Steam 或 GOG Galaxy 中没有启用 "compatibility branch"（模组无法在兼容性分支上运行）。
请确保您在游戏文件夹中运行 StardewModdingAPI.exe（参见安装指南）。
您是否没有使用SMAPI 安装器，而是手动安装了它？请确保您的操作遵循了 README.txt 文件中的步骤。
极少数情况下，可能需要彻底卸载并重装游戏。
"The game failed to launch: Microsoft.Xna.Framework.Graphics.NoSuitableGraphicsDeviceException: Failed to create graphics device"
这意味这游戏的底层框架不支持您的显驱。
常见解决方案：
1. 更新显驱：
安装显卡软件（NVIDIA App 或 AMD Software）。
打开显卡软件。
找到显示显卡驱动信息的那一栏。请确保显驱为最新版本，否则请更新。
2.（仅适用于 Windows）在独立显卡上运行游戏。
参见在独立显卡上运行游戏（仅 Windows）。不要跳过这步！它往往能解决问题。
3.（仅适用于 Linux）不要强制使用 Wayland 运行 SDL：
您可能设置了 SDL_VIDEODRIVER=wayland 以强制使用 Wayland 运行 SDL 应用（包括星露谷物语）。移除此设置可能有用。此设置可能在 .bashrc、.bash_profile 或类似的位置。
4. 使用兼容性分支或较旧版本：
这是不得已的手段。您可以：
使用兼容性分支（但目前您不能在其上使用模组）；
或者回退到星露谷物语 1.5.4 或更低版本（这使得您可以使用旧版 SMAPI 和模组）。
"Skipped '...' because it doesn't have a manifest.json"
SMAPI 无法在模组文件夹中找到相应的 manifest.json 文件。这一般表明此模组并非 SMAPI 模组，所以它在 Mods 文件夹中无法运行。请参见此模组的文档，以了解如何正确安装此模组。
"missing executable"（仅适用于Steam）
Steam 无法找到游戏启动器，通常是因为您的 Steam 启动选项错误。常见解决方案：
如果您希望使用 SMAPI：请确保您已经安装了 SMAPI 且启动选项正确（参见安装指南）。
如果您希望卸载 SMAPI：
在 Steam 中，右击 "Stardew Valley" 并选择 “属性”。
查看 “通用 > 启动选项” 一栏。
确保“启动选项”为空。
"Could not load file or assembly"
如果提示的 'file or assembly' 以 Microsoft 或 System 开头（例如 "FileNotFoundException: Could not load file or assembly 'System.[...]' or one of its dependencies"），或者您看到了 "The library '[...].dll' required to execute the application is not found in 'C:\Program Files\dotnet`" 这样的信息（一般为 hostpolicy.dll），则游戏依赖的核心框架出错了。
常见解决方案：
重置游戏文件。
如果无效，卸载星露谷物语（并彻底删除游戏文件夹），然后重装。
确保您只有一个游戏副本，而不是有多个游戏副本。
（现在星露谷物语封装了其所需的依赖，因此您应该无需自行安装它们。）
当您手动安装 SMAPI（即，把 .bat 改为 .zip 并手动移植文件）时，您也可能遇到此问题。此时您也可以尝试使用安装器重装 SMAPI。
OutOfMemoryException报错
您的控制台中出现 OutOfMemoryException 报错信息，且游戏严重卡顿或崩溃。这意味着您的游戏耗尽了内存。
此问题也可能表现为 Unable to allocate pixels for the bitmap 报错。
一些常见修复方法：
确保您拥有最新版的星露谷物语 1.6.15。新版的星露谷是 64 位的，它解决了 32 位内存限制的问题。
如果您仍能看到此错误，则可能需要移除您不需要的模组（尤其是 Custom Music、SAAT 或 TMXL Map Toolkit 的内容包，它们可能占用很多内存）。
SMAPI卡在加载界面
一些常见的原因：
（仅适用于 Windows）请确保 SMAPI 窗口未处于“选取模式”（选取模式下，SMAPI 窗口会在左上角的 "SMAPI" 前面显示 "Select" 字样）。选取模式下，SMAPI 会暂停加载，以便用户查看控制台内容或选取控制台中的文本。您可以点击控制台然后按几次 Enter 键来退出选取模式。 “选取模式”的特征
杀毒软件阻止 SMAPI 加载游戏。 这种情况下，控制台中的日志往往加载非常缓慢（非常简单的任务也需耗费数秒）。您可以尝试暂时关闭杀毒软件以检查是否为此问题。如果关闭杀毒软件能解决此问题，请将 SMAPI 、Stardew Valley 和游戏文件夹都加入杀毒软件白名单。最后重启杀毒软件。
提示：如果您不确定是否有杀毒软件，Windows 内置了一款称为 Winddows Defender 的杀毒软件。
（仅适用于 Windows）如果您有独立显卡，请使用独立显卡运行游戏，而不要使用集成显卡。参见“在独立显卡上运行游戏（仅 Windows）”。
如果您安装了许多模组，则加载可能耗费数分钟。 加载时间很大程度上取决于您所安装的模组和您的电脑配置。如果您安装了一些非常大型的模组（例如一个以上的扩展型模组），则您可能需要等待几分钟，再观察是否确有问题。如果您安装了 PyTK 但不再使用它，请尝试移除它，这可能有助于缩短加载时间。
NoAudioHardwareException: Audio has failed to initialize
此异常代表游戏本体或 SMAPI 由于某些原因无法使用电脑音频。对于 Windows，安装 OpenAl 也许能解决此问题。您也可以试着连接耳机。
Mac: Contents/MacOS/StardewValley Already Exists
此报错往往如下所示：
"An error occurred in the base update loop: IOException: The file '/Users/USERNAME/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS/StardewValley' already exists."
如果您遇到了此问题，可以尝试这些方法：
在“访达”中按下 Command+Shift+. 键来显示隐藏文件，然后前往主目录（它在访达的左边栏中，以您的用户名命名，有一个小房子图标）。其中可能会出现许多隐藏文件夹。
确保 ~/.config/StardewValley/ErrorLogs 文件夹存在。若不存在，请创建此文件夹。
确保您的截屏按钮工作正常。如果它无法工作，请确保 ~/.local/share/StardewValley/Screenshots 文件夹存在。若不存在，请创建此文件夹。
如果以上方法均无效，您可能需要自行寻找解决方案。
其他问题
游戏时延迟或卡顿
您可以尝试如下方法：
如果您正在使用模组：
将 SMAPI 和您的模组更新到最新版。
确保 SMAPI 控制台中没有循环报错（若有，请参见“寻求帮助”）。
暂时移除 SMAPI 和 Error Handler（SMAPI 自带）以外的全部模组。如果这能解决问题，则可能是您的某个模组导致了延迟。（您也可以继续尝试下面的方法，以观察是否能解决问题。）
仅适用于 Windows：
在独立显卡上运行游戏。
安装您的显卡对应的软件（NVIDIA 显卡为 GeForce Experience，AMD 显卡为 AMD Software），然后使用显卡软件升级显卡驱动至最新版。
如果您正在使用 GeForce Experience，请确保已禁用 WhisperMode。
对于 Linux/SteamDeck 玩家：
打开游戏文件夹中的 smapi-internal/config.json 并将其中 ListenForConsoleInput 设为 false。（请参阅此文件顶部的教程以了解如何创建 config.user.json 文件。）
将游戏文件夹添加到杀毒软件白名单中。对 Windows 玩家的提示：如果您没有安装额外的杀毒软件，也会有默认的 Windows Defender 软件，后者可能会导致延迟。这种情况下，请尝试将游戏文件夹加入排除项。
设置处理器相关性（processor affinity，Windows 中一般通过任务管理器设置），一般设为 CPU2 或更高。如果您使用模组，则需设置 StardewModdingAPI.exe 的相关性；如不使用，则需设置 Stardew Valley.exe 的相关性。
设置处理器优先级为“高”。如果您使用模组，则需设置 StardewModdingAPI.exe；如不使用，则需设置 Stardew Valley.exe。
如果您使用 Steam 版本，尝试使用 Steam 客户端启动游戏。
如果进行了上述操作仍不能解决问题，请参见“寻求帮助”。
游戏音频无法播放或走调（仅Windows）
浏览器或其他应用程序都能正常播放音频，但游戏无法播放音频。以下是一些常见的修复方法：
重启电脑。
确保 Windows 音量合成器没有将游戏静音。
确保游戏内的音量滑块选项没有被设为静音。
查看“游戏无法启动”一节下的调试方法。
检查是否出现了 NoAudioHardwareException 报错信息，并尝试按相应指南操作。
使用SMAPI启动游戏时分辨率改变（仅Windows）
使用 SMAPI 启动游戏时，图像变大/变小。
将 SMAPI 升级到 3.16.0 或更高版本应当能修复此问题。如果不能修复，请寻求帮助。
存档消失或无法加载
参见存档#疑难解答。
多人游戏中无法联机
检查游戏配置：
确保您正在使用最新版的星露谷物语（PC 1.6.15）。
确保房主处于合作模式中。也就是说，房主需要点击标题界面的“合作”按钮，然后点击“主持（农场名字）农场”来开始游戏。如果您通过“加载”菜单加载了联机存档，即使存档内有联机小屋，也只会使用单人模式。
确保联机小屋数不低于农场帮手人数。
确保在游戏的“选项”菜单中，“服务器模式”不是“离线”。
重置所有玩家的游戏文件。
删除 startup_preferences 文件（Windows 位于 %appdata%/StardewValley，Linux/Mac 位于 ~/.config/StardewValley）。
确保所有玩家都通过 Steam 或 GOG Galaxy 运行游戏（而不是通过其他快捷方式）。对于 Windows 版 SMAPI，参见“设置游戏平台启动项”。
关闭所有玩家的防火墙或杀毒软件。如果您有一个以上的杀毒软件，则很可能引发此问题。不要同时使用多于一款杀毒软件。
重启所有玩家的电脑。
重启所有玩家的路由器，并尝试升级您的路由器固件。
如果您没有看见“输入邀请码”选项，则您的 Steam 用户名可能被识别为包含敏感词。尝试改一个名字，然后重启游戏。
（仅适用于 Windows）检查“游戏无法启动”一节下面的内容。
如果您正在使用模组，且收到了“版本错配”报错，请检查您的日志文件，其中某一行可能类似于 [19:49:26 TRACE game] Starting server. Protocol version: 1.6.15，检查协议版本是否匹配。
对于主机玩家，请尝试所有合适的步骤（包括“检查游戏设置”一节下面的前 4 个），以及尝试电源重启主机（关闭主机，拔掉插头，等待半分钟以上，重新开机）。请主机，所有主机都需要付费在线服务才能通过互联网进行游戏。
SMAPI或模组文件消失了，或被杀毒软件/浏览器拦截
您的杀毒软件可能删除、拦截或报告 SMAPI 或模组文件。虽然文件本身可能并不包含病毒，但杀毒软件可能出现误报。
怎样才能知道文件是否安全？
来自互联网的内容，其安全性无法得到绝对保证。但是，您可以通过下面的方法来确认一个文件是否大概率是安全的：直接阅读并检查软件的源代码（例如，您可以阅读 SMAPI 的源代码，[反编译]下载的模组文件再检查反编译得到的源代码（请确保反编译是被允许的），或将文件上传到 VirusTotal。VirusTotal 会使用六十种以上的杀毒软件扫描上传的文件；如果其中仅有一两个软件检测出问题，则有可能是误报。而 Nexus Mods 上的文件在被下载之前会自动经过 VirusTotal 检测。
为什么出现此问题？
杀毒软件和浏览器经常误报，因为：
下载的文件较新。这种情况下，杀毒软件或浏览器可能并没有检测出任何问题，可能只是单纯担心它是一个未知的文件。这种情况杀毒软件常常会显示一个假的病毒名称，例如 Trojan:Win32/Emali.A!cl。当有足够多的用户下载了这个文件，杀毒软件可能就不会误报了。但模组每次发布新版，该问题仍会出现。
杀毒软件可能会检查软件某些特定的行为模式，例如访问文件或重写代码，但 SMAPI 模组在正常情况下往往需要访问文件或重写代码（因为模组的存在就是为了改变游戏功能）。
我怎样才能下载浏览器认为“可疑”的文件？
这取决于您所使用的浏览器。请您在确保文件安全的前提下，自行搜索解决方案或参阅英语页面。
如果杀毒软件报毒我该怎么安装SMAPI或其他Mod？
这取决于您所使用的杀毒软件。请您在确保文件安全的前提下，自行搜索解决方案或参阅英语页面。
SMAPI无法识别手柄（仅Steam）
常见解决方案：
通过 Steam 启动游戏。
仅适用于 Windows：确保您已经设置了启动项（参见“设置游戏平台启动项”）。
如果其他方法均无效，您可以尝试使用第三方软件来支持手柄，例如：
Linux：SC Controller
Mac：Mac: 360Controller。当使用非 Xbox 的手柄时，您应当在 360Controller 中启用 "pretend to be an Xbox 360 controller"。（某些情况下，对于 Xbox 手柄也需启用该选项。）
Windows：reWASD（试用期后收费）或InputMapper（免费，更复杂），可以将您的手柄映射为 Xbox 手柄。
Linux/Mac 最终手段
作为 Linux 或 Mac 上的最终手段，您可以禁用 SMAPI 控制台窗口来修复此问题。您将不再收到更新/错误提醒，除非您查看日志。而且在游戏崩溃后，您必须手动删除 smapi-internal/StardewModdingAPI.crash.marker 文件才能再次启动游戏。您必须定期检查日志以保证一切正常。如果您确实希望使用此等下策：
Linux 或 macOS：
找到你的游戏文件夹。
使用文本编辑器打开 StardewValley 文件（没有扩展名）。
将文件顶部的 SKIP_TERMINAL=false 改为 SKIP_TERMINAL=true。
在 Windows 上无法关闭控制台窗口。
每次升级 SMAPI 后，您都需要重复这套流程。
光标卡在博物馆或建筑界面中
当把物品放在博物馆或把建筑放在农场上时，光标卡在某处；当您尝试移动它时，它会立即跳回原处。
这是因为游戏没有正确地检测到手柄。修复方法：
加载您的存档。
打开游戏内的菜单，点击“选项”（游戏手柄图标）。
在选项菜单中，切换“游戏手柄模式”。如果您使用手柄，应当设为“开启”；如果您使用键盘和鼠标，应当设为“关闭。”
安装新版后，启动游戏时仍显示旧版的SMAPI或游戏
这通常意味着您安装了两个副本：其中一个为您更新的版本，另一个为您实际在玩的版本。
可以按如下步骤检验是否为此问题：
重新运行 SMAPI 安装器，并留意第一个界面出现的 "Game path"：
使用 SMAPI 启动游戏，并留意输出顶部的 "Mods go here" 路径：
通过 Steam，GOG Galaxy 或 Xbox 打开游戏文件夹。如果您不知道怎么做，请参阅“找到你的游戏文件夹”一节下面的“更多方法”（方法3 ~ 方法5）。
上面 1~3 步提到的 3 条路径应当大致相同，最多相差一个 /Mods 部分。
如果您有多个游戏文件夹，最好只保留其中一个。为此，您可以这样做：
将 Mods 复制一份，备份到别处。
卸载游戏。
删除游戏文件夹。
通过 Steam 或 GOG Galaxy 重装游戏。
重装 SMAPI，此时 SMAPI 安装器应当只能检测到一个游戏路径。
将备份的模组放回游戏文件夹。
更多方法
如果您出于某些原因必须有多个游戏副本，且您只希望为其中一个副本安装 SMAPI，您可以将 SMAPI 安装器放在那个副本的子文件夹。当您运行此安装器时，它会自动检测到父文件夹，然后仅安装到此副本。
SMAPI安装器打开后闪退
问：安装器打开一秒后闪退。
答：请确保您正在安装的是 SMAPI 3.13.1 或更高版本，新版本的 SMAPI 修复了一个关于路径名称的问题。如果您确认正在安装的较新版本，尝试将 SMAPI 添加到杀毒软件白名单中，然后重新下载 SMAPI，因为您的 SMAPI 安装器可能被杀毒软件损坏了。如果仍不起作用，可以尝试如下方法：
打开安装器文件夹。
按住 Shift 键，然后在文件夹空白处右击一下。
在弹出的菜单中点击 Open in command prompt / PowerShell / Windows Terminal （取决于您的 Windows 设置）。
如果此时安装器再崩溃，您将能看到报错信息。
截一张完整的、包含报错信息的屏幕截图，然后在星露谷物语 Discord 上的 #using-mods 频道寻求帮助。
两个存档副本
如果您安装了 Get Glam 模组，请尝试卸载它。
宠物事件无限播放
您的宠物可能与游戏中的 NPC 重名（尤其是模组 NPC 。已知的两个问题都是因为与 SVE 的 NPC 重名）。编辑存档来移除宠物可能会起作用，但这很几首。您也可以尝试将宠物改名以避免与 NPC 重名，或直接拒绝收下宠物，并观察是否有效。但您有可能获得多只宠物。
使用SteamLink或其他Steam RemotePlay启动时游戏画面卡住
解决方案 - PC
使用 SMAPI 的 StardewModdingAPI 运行星露谷物语。
这会弹出一个控制台窗口，以显示加载信息。加载完成后会启动星露谷物语。
一旦星露谷物语启动，您需要按下 Alt + Tab 来切换窗口。一般会回到上一步的控制台窗口。如果没回到，只需选择控制台窗口/
点击控制台的最小化按钮 [-] 以将其最小化。
现在控制台窗口已被最小火，您可以通过点击窗口上的星露谷物语使其重获焦点，然后就应该能解冻了!
解决方案 - 连接到 SteamLink 上的手柄。
使用 SMAPI 的 StardewModdingAPI 运行星露谷物语。
这会弹出一个控制台窗口，以显示加载信息。加载完成后会启动星露谷物语。
星露谷启动后，界面会显得卡住。按住手柄左边的类似于选项的按钮，以打开 SteamLink 快捷目录。
在 Xbox 手柄上，您应当按“后”（Back）按钮。
在 Playstation 手柄上，您应当按 "Share" 按钮。
在 Steam 手柄上，您应当按左箭头
在此菜单中，选择“虚拟键盘”，以显示一个悬浮在屏幕上的键盘。
按下 Alt 键，然后按下 Tab 键。这会将您移出卡住的界面并自动设置焦点在控制台窗口上。
在控制台窗口仍然可见且有焦点的情况下，在“虚拟键盘”上按下 Windows 键，然后按下“下箭头”键。这应当能最小化控制台窗口。
"Windows" 键处于键盘的左下角。现在窗口应当能自动取回焦点，且解冻了。
已知问题
无法在兼容性分支上运行SMAPI
什么是兼容性分支（compatibility branch）？
星露谷物语 1.6.15 有两个版本：默认安装的是较新的、64 位的“主分支”，旧版系统安装的则是遗留的、 32 位的“兼容性分支”。对于玩家而言，其内容相同，但框架并不相同。
为什么它无法运行模组？
很遗憾，目前 SMAPI 仅支持主分支。使所有模组都能支持全部版本太过困难，而统计数据显示 ≈99.69% 的玩家使用 64 位版。
创建多个版本的 SMAPI（例如，当前 SMAPI 有 Linux/macOS/Windows 三个版本）并不能解决问题。即使这样做了，每个 C# 模组作者在每次更新模组使都必须手动迁移，这样做过于繁琐，因而不可行。在未来，SMAPI 也许能自动重构模组代码，使之应用于兼容性分支；某些模组作者也可以尝试将 SMAPI 或个人模组迁移到兼容性分支上。
如果我无法更新，是否仍能游玩？
有几种方法：
首先，确保您确实无法更新。超过 99% 的系统应当能兼容主分支；只有那些仅支持 32 位的老旧系统或使用不受支持的显卡才无法兼容。
或者，您也可以不使用模组。尽管目前模组不能在兼容性分支上运行，但仍会接收那些针对旧版系统玩家的、向后移植到旧版框架的内容更新。
或者，您也可以回退到先前的星露谷物语 1.5.4 版本，这样您就可以像之前一样继续使用模组。尽管您将无法使用最新版模组，您仍然可以安装 2021 年 11 月 29 日之前的模组。如果在未来我们找到了使模组适用于兼容性分支的方法，您就可以切换到相应的兼容性分支了。
寻求帮助
报告漏洞
如果您没有使用模组：
参见此指南以尝试修复游戏。如果仍需帮助，尽管寻求帮助。
如果您正在使用模组：
首先，检查无模组是否仍会出错：
打开游戏文件夹。
双击 Stardew Valley.exe（Windows）或 StardewValley-original（Linux/macOS）以启动游戏。
如果仅在启用模组时才会出错，请寻求帮助。 否则参见上文“如果您没有使用模组”一部分。
寻求帮助
参见模组:帮助以了解如何寻求帮助！
← 入门
兼容性 →