模组:使用指南/疑难解答

来自Stardew Valley Wiki
（重定向自模组:玩家常见问题）
跳到导航 跳到搜索
← 模组:目录
模组使用指南 SMAPI mascot.png

如果您在进行游戏时遇到了各种错误，那么这个页面就是为您准备的！（此页面不仅仅面向使用Mod的玩家。）

常用解决方案

基本步骤

  1. 重启电脑。
  2. 确保您的游戏已经更新到了最新版本（WeGame最新版本为1.5.4，其他平台最新版本为1.6）。
    在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。
  3. 重置游戏文件。
  4. 如果您正在使用SMAPI：
    SMAPI日志解析器
    1. 确保您已经安装了最新版本的SMAPI
      SMAPI控制台窗口的左上角会显示当前运行的SMAPI版本。
    2. 按照这里的说明，或是日志解析器的介绍，找到SMAPI在您电脑上储存的日志，并将其上传到日志解析器中进行分析。它可以帮助您分析一些常见错误。右侧的图片将告诉您如何读懂SMAPI的日志。
    3. 日志靠近最上方的位置显示了需要更新的Mod。您也可以使用Mod Update Menu来在游戏主菜单内检视已安装Mod的更新情况。当您在使用Mod进行游戏时遇到了任何问题时，第一件事都应当是更新这个列表里的所有Mod（即便有些Mod未更新时看起来也能正常使用）。
    4. 如果您已将问题定位到了一个或一系列特定的Mod上，请试着卸载并重新安装这些Mod。
      1. 删除导致问题的Mod的所有相关文件夹，同时确保您已经核查了Mod发布页中提到的所有文件夹。（如果您是从Nexus下载的Mod，您可以点击“Preview File Contents”来查看Mod所包含的文件。在ModDrop上，您可以在侧边栏的“Files”中找到相关信息。）
      2. 重新下载这些Mod，并按照Mod发布页的使用说明重新安装Mod。如果您习惯于使用Mod管理器，重新安装时也请使用手动安装方式，从而排除是Mod管理器没有将文件放到正确位置而造成问题的可能性。
  5. 如果遵循以上步骤后您仍然遇到了错误，请查看本页面的常见问题解答部分，或寻求帮助。

重置游戏文件

许多问题都是游戏文件损坏导致的（尤其是在您使用XNB Mod时）。您可以通过验证游戏文件完整性来修复该问题。基于SMAPI的Mod不会在该过程中被影响。

  1. 查看如何在Steam平台或是GOG平台验证游戏文件完整性。
  2. 如果您正在Linux/Mac上使用SMAPI，需要重新安装SMAPI来修复启动器。
更多方法 
如果您不想重置所有游戏文件，您可以使用下面提及的其他方法。
方法2: 获得并备份原版游戏文件，以替换任何损坏的文件
如果您安装使用了XNB Mod，同时只想重置您已知晓的损坏游戏文件，您可以直接将这个文件还原为默认状态。如果您在安装Mod之前没有备份原版游戏文件，可以按照以下方法获取它们且保留您已经修改过的游戏文件。
  1. 在游戏目录下新建名为 Content-modded 的文件夹，并将 Content 文件夹内的所有文件复制到 Content-modded 内。
  2. 按照Steam平台的说明或是GOG平台的说明重置游戏文件。
  3. 在游戏目录下新建名为 Content-backup 的文件夹，并将刚刚已恢复原版文件的 Content 文件夹内的所有文件移动到 Content-backup 内。
  4. 将 Content-modded 文件夹中的内容复制回 Content 文件夹。
现在您的游戏文件（ Content 文件夹）仍然是修改过的，但您已经获得了原版游戏文件（ Content-backup 文件夹）。只需要替换对应的损坏文件即可。
方法3: XNB Mod导致的问题
如果您安装使用了XNB Mod，但并不确定是哪个Mod导致了问题，此外您也不想移除您所有的XNB Mod，可以按照以下方法来确定是哪个Mod导致的问题。
  1. 备份您想保留的所有XNB Mod。
  2. 按照Steam平台的说明或是GOG平台的说明重置游戏文件。
  3. 如果您正在Linux/Mac上使用SMAPI，需要重新安装SMAPI来修复启动器。
  4. 启动游戏来看看先前遇到的问题是否已被修复。如果问题依然出现，请查看模组:帮助页面以寻求帮助。
  5. 如果已经修复，请每次只添加一个XNB Mod，然后打开游戏看看是否出现问题。逐个尝试这些XNB Mod，直到找到有问题的为止（可能并不止一个）。然后将它移除，便可以继续正常游戏了。
注意：XNB Mod是直接替换游戏文件的Mod，现在已经不再被推荐使用，继续使用XNB Mod可能会导致许多意想不到的问题。重置游戏文件将会移除您所有已安装的XNB Mod。重置完成后，您可以考虑使用基于Content Pacher的Mod来替代这些XNB Mod。

常见问题解答

游戏无法启动

在您试着启动游戏时，游戏无法启动。（如果您正在使用的是Steam，它可能会显示“正在启动”。）下面的方法可能会帮您解决这个问题：

  1. 重启电脑。
  2. 确保您已经插入耳机或麦克风。（需要一个可工作的音频设备才能正常运行游戏，您可以将它们设置为静音。）
  3. 如果您正在Windows上运行游戏：
    1. 安装（或是重新安装）.NET 5（通常情况下安装Windows x64版本即可）。您可能需要预先卸载 .NET Framework才能进行安装。
    2. 重启电脑。
    3. 运行游戏。
    4. 确保您在Steam上为星露谷物语设置的启动选项准确无误（如有必要，您可以先尝试删除所有的启动选项）。
    5. 安装并运行.NET 修复程序，依照它显示的步骤进行修复。
  4. 如果您正在Linux上运行游戏：
    1. 您默认的终端可能与游戏不兼容，请尝试安装XTERM终端。
  5. 如果以上方法均无效，您可以：
    1. 安装SMAPI（如果您还未安装）。
    2. 尝试运行游戏。
    3. 附上您的SMAPI日志寻求帮助。

游戏无响应或崩溃

在您打开游戏后，还未进入到标题界面游戏便无响应或崩溃了。下面的方法可能会帮您解决这个问题：

  1. 尝试游戏无法启动这部分的所有方法。
  2. 删除游戏的设置文件 startup_preferences ，Windows系统位于 %appdata%/StardewValley 目录下，Linux/Mac系统位于 ~/.config/StardewValley 目录下。
  3. 如果您正在使用SMAPI，请暂时禁用杀毒软件。
  4. 禁用监控游戏程序的软件，例如微星的AfterBurner超频软件或是RivaTuner。
  5. 如果以上方法均无效，请按照步骤寻求帮助。

Steam显示游戏正在运行，但没有窗口出现（仅限Windows）

在您从Steam启动游戏后，Steam显示游戏正在运行，但过了很久依然没有游戏窗口出现，且点击Steam的停止按钮没有反应。这似乎是Steam的问题，您可以按照以下步骤来重新启动游戏：

  1. 右键点击Windows任务栏，打开任务管理器，并点击窗口最左下角的箭头切换到详细信息。
  2. 尝试找到 Stardew Valley 进程，右键点击它，选择结束任务，如下图所示：
    Modding - Player Guide - Troubleshooting - Task Manager 01 ZH.png
  3. 如果您在上一步中没有找到游戏进程，它也可能在Steam的子进程下，需要找到并展开Steam的进程，右键点击 Stardew Valley ，选择结束任务。
    Modding - Player Guide - Troubleshooting - Task Manager 02 ZH.png
  4. 结束《星露谷物语》的进程后，您便应当能在Steam中重新启动游戏了。
  5. 在极少部分情况下，您可能需要重复以上步骤2~3次。

更新 Stardew Valley 时发生错误（缺失可执行文件）（仅限Steam）

  • 如果您想使用SMAPI，请确保您在Steam上为星露谷物语设置的启动选项准确无误。
  • 如果您不想使用Mod进行游戏，且没有安装SMAPI，请在Steam客户端中，右键点击 Stardew Valley 并选择“属性”，然后在“通用”中清空“启动选项”下文本框内的所有内容：
    Modding - installing SMAPI on Windows - Steam 1 ZH.png
    Modding - installing SMAPI on Windows - Steam 2 ZH.png

运行SMAPI安装脚本时控制台窗口闪退（仅限Windows）

如果您在安装SMAPI的操作过程中，双击运行 install on Windows.bat 这个文件后有一个黑色的控制台窗口打开，然后立刻闪退，这可能是系统环境变量出现了问题。

您可以参照这部分的说明编辑环境变量，确保在名为 Path 的系统变量中有 C:\Windows\system32 和 C:\Windows 这两个值，如果没有，请点击右侧的“新建”按钮手动添加。

FileModding - Player Guide - Troubleshooting - Environment Variables 03 ZH.png

如果上述方法无法解决问题，请寻求帮助。

游戏光标不受控制

如果您在游戏时鼠标不受控制，并排除设备自身的问题后，可能是因为游戏自动侦测到的手柄模式开关错误，您可以按照以下方法之一解决。

方法一：

  1. 加载存档。
  2. 按下ESC并切换到设置界面。
  3. 将“游戏手柄模式”切换为“关闭”（如果您正在使用的是鼠标和键盘）；将“游戏手柄模式”切换为“开启”（如果您正在使用的是手柄）。

方法二：

  1. 关闭游戏。
  2. 同时按下Windows+R键，在新弹出的运行窗口中输入 notepad "%appdata%\StardewValley\startup_preferences" 后点击“确定”。
  3. 此时记事本应该会自动打开一个名为“startup_preferences”的游戏配置文件。在打开的文件内同时按下Ctrl+F打开搜索窗口，输入 <gamepadMode> 并点击“查找下一个”，您应当能看到一段形如<gamepadMode>Auto</gamepadMode>的代码（如下图所示）。
    Modding - Player Guide - Troubleshooting - gamepadMode ZH.png
  4. 如果您正在使用的是键盘和鼠标，将一段内容修改为<gamepadMode>ForceOff</gamepadMode>；如果您正在使用的是手柄，将其修改为<gamepadMode>ForceOn</gamepadMode>。
  5. 保存并关闭文件。
  6. 重新运行游戏，此时应该一切正常了。

游戏帧率过低（人物动作缓慢）

星露谷物语正常情况下应该始终以60帧运行，如果您突然感觉游戏帧率过低，或是人物动作变缓，您可以先按以下步骤打开Steam内的游戏内帧率显示（或使用其他显示帧率的软件），确认游戏当前运行的帧率：

  1. 打开游戏后，同时按下Shift+Tab。
  2. 在弹出的Steam游戏内覆盖窗口中，点击下方中间位置的“设置”按钮。
  3. 在弹出的设置界面中，切换到游戏中一栏。
  4. 将“游戏中帧数显示”功能由“关闭”选项更改为“左上角”（或您习惯的其他位置）
  5. 点击确定。
  6. 按下ESC键返回游戏。

Modding - Player Guide - Troubleshooting - Frame ZH.png

此时您应当能够在游戏内的左上角（或您设置的其他位置）看见游戏实时帧率了。加载存档后，若您发现您的帧率与60帧相差很大（例如30帧），您可以尝试更改游戏内的以下设置选项：

  • 取消勾选“垂直同步”选项。
  • 尝试切换“窗口模式” 选项，依次试着更改为“窗口”、“窗口无边框”、“全屏”。

如果您发现采用上面的两个方法之一时，游戏帧率回到了60帧，那便说明一切正常了，您可以继续探索星露谷的世界了。如果该问题依然没有解决，请寻求帮助。

游戏没有声音（仅限Windows）

您的浏览器或是其他软件均能正常播放声音，但游戏却没有声音。下面的方法可能会帮您解决这个问题：

  1. 重启电脑。
  2. 确保您没有在系统声音设置中将游戏静音：
    1. 打开游戏并将其最小化。
    2. 在任务栏右下角找到喇叭状图标，右键点击它并选择“音量合成器”。
    3. 在弹出的窗口中找到Stardew Valley应用程序，调高它的音量。
  3. 确保您在游戏内设置选项中打开了声音。
  4. 重新安装.NET 5。

存档丢失或无法加载

请查看存档#疑难解答。

合作模式中无法与其他玩家联机

  1. 确保您的游戏已经更新到了最新版本（WeGame最新版本为1.5.4，其他平台最新版本为1.6）。
    在游戏标题界面点击右下角的"?"按钮后，屏幕左下角会显示当前游戏版本。
  2. 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项，然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏，即使您的存档中有空闲的联机小屋，其他玩家也不能加入您的游戏，您只能在单人模式下进行游戏。
  3. 您的存档中有空闲的联机小屋供未加入玩家选择。
  4. 请确保每位玩家都是通过Steam或是GOG Galaxy启动游戏的，而不是直接点击快捷方式。如果您正在使用Mod进行游戏，请按照设置游戏平台启动项这个页面的步骤来进行设置。
  5. 作为主机的玩家需要在游戏选项中设置服务器模式为“联机”。
  6. 所有玩家都应尝试关闭Windows防火墙，并关闭所有杀毒软件。同时使用多款杀毒软件很容易导致无法与其他玩家联机。在任何时候您都不应该同时使用多款杀毒软件。
  7. 所有玩家都应尝试重置游戏文件。
  8. 所有玩家都应尝试删除游戏的设置文件 startup_preferences ，Windows系统位于 %appdata%/StardewValley 目录下，Linux/Mac系统位于 ~/.config/StardewValley 目录下。
  9. 所有玩家都重启一下电脑。
  10. 所有玩家都重启一下路由器。
  11. 如果您正在Windows上运行游戏，请尝试重新安装.NET 5。
  12. 如果您正在使用Mod进行游戏，并看到了“version mismatch”的错误，请查看控制台输出中是否有像这样的一行日志：[19:49:26 TRACE game] Starting server. Protocol version: 1.4.0.1。如果有，请检查您的协议版本是否与其一致。

对于主机玩家，请尽量尝试上述方法中您能实现的部分（尤其是靠前的方法），您也可以尝试重启您的主机。请注意，主机玩家需要购买对应平台的联机服务才能进行联机游戏。

合作模式中频繁掉线

在客机进行游戏时，经常与主机断开连接，或是各个游戏玩家之间游戏内时间相差较大。这种情况一般是主机或客机玩家的网络不稳定导致的。无论是您家中的网络或是宽带运营商的网络，都可能导致网络不稳定。

客机玩家在游戏内按T键打开聊天框，输入 /ping 便可以显示您与主机之间的延迟，正常情况应该为几十毫秒（ms）。

如果您确认是因为网络不稳定造成的掉线，无论是主机还是客机玩家都可以从两方面着手。一种是优化从您的电脑到家里的宽带接入点之间的延迟；另一种是通过第三方软件优化宽带运营商提供网络的稳定性。

您可以按照以下方法判断您家中的本地网络情况如何（仅限Windows）：

  1. 同时按下 Windows+R 键，在左下角弹出的窗口中输入 cmd 后点击确定，会打开一个控制台窗口。
  2. 在打开的控制台窗口中输入 ipconfig 并按下回车，您应当会在输出的日志中找到“以太网适配器”和“无线局域网适配器”两项内容。其中之一（取决于您使用的是有线网络还是无线网络）会有“默认网关”这一项，后面会有形如 192.168.xx.1 这样的IP地址，如下图所示，请记下它。
    Modding - Player Guide - Troubleshooting - ipconfig ZH.png
  3. 继续在控制台中输入 ping 192.168.xx.1 并按下回车，其中的一串数字应当替换为您上一步中记下的IP地址。等待几秒后，最后应该有形如下图的一些日志输出。您应当注意您电脑上对应图片上红框标识的位置，基本上便是您的电脑到本地宽带接入点的延迟。正常情况下不应超过10毫秒（ms）。
    Modding - Player Guide - Troubleshooting - ping ZH.png
  4. 如果您在上一步显示的延迟在10毫秒（ms）以内，那么恭喜您，您家中的本地网络情况尚可。如果显示的延迟较高，那么您应当考虑调整路由器/光猫设置或是对它们进行更换等方法来优化本地网络。

您可以按照采用以下方法之一来优化宽带运营商提供网络的稳定性：

  1. 使用各类游戏加速器对游戏进行加速。
  2. 使用其他软件构建虚拟局域网（VLAN），通过IP直接加入游戏：

如果尝试以上方法后客机依然会频繁掉线，也可以尝试重新创建一个由其他玩家主持的存档进行游戏，或是寻求宽带运营商服务人员等专业人士帮助。

SMAPI文件丢失或报毒

您正在使用的杀毒软件可能会将SMAPI/Mod的文件删除，或是对这些文件报毒。但它们几乎都是误报，SMAPI本身也是没有木马病毒的。

我怎么知道它们没病毒？
互联网上的任何东西都不能保证绝对安全。但您可以直接检查它的源代码，对它进行反编译，或是将它上传至VirusTotal检测，足以证明SMAPI本身是安全的。
对于Mod，您可以对它们进行反编译，或是将它们上传至VirusTotal检测。此外，您从Nexus Mods上下载的Mod已经预先通过了病毒扫描。
为什么会这样？
杀毒软件通常会因为以下原因而报毒：
  • 因为这是您刚刚下载的文件。事实上，在您刚刚下载Mod到本地后，杀毒软件并不能检测出任何东西，只是因为这些Mod都是未知文件。这种情况下，杀毒软件通常会误报如 Trojan:Win32/Emali.A!cl 这样的警告。随着下载这个文件的人越来越多，杀毒软件会修复误报。但每次Mod更新后，便又可能出现这样的误报。
  • 杀毒软件可能会检测某些特定的行为，例如访问文件或重写代码。但只有进行这些操作，基于SMAPI的Mod才能实现各自的功能，毕竟需要对游戏本体进行修改。
如果杀毒软件报毒我该怎么安装SMAPI或其他Mod？
  • 第一种方法是过几天再下载或更新这些Mod，如果是比较冷门的Mod可能需要等待几个星期。因为到那时已经有足够的用户下载了这些文件，杀毒软件会减少误报。
  • 如果您已经按照上面提到的方法检测了Mod的安全性，您可以使用下面说的第二种方法：
    1. 暂时禁用杀毒软件。
    2. 重新下载并安装SMAPI或其他Mod。
    3. 将整个游戏文件夹加入杀毒软件的白名单。您可能需要在网上搜索一下如何在您使用的杀毒软件中添加白名单。

SMAPI无法识别手柄（仅限Steam）

常用解决方案：

  1. 通过Steam启动游戏。
  2. 对于Windows：请确保您正确设置了启动项（查看设置游戏平台启动项），请不要在Steam内将SMAPI添加为“非Steam游戏”。
  3. 对于使用Steam的用户，进入Steam的设置界面，选择控制器选项，然后点击常规控制器设置，勾选您需要使用的手柄。如下图所示：
    Modding - Player Guide - Troubleshooting - Steam Controller Support 01 ZH.png

    Modding - Player Guide - Troubleshooting - Steam Controller Support 02 ZH.png
  4. 如果以上方法均无效，您可以使用一些第三方软件来添加手柄支持。下面是一些推荐的软件：
Linux/Mac上的最后一招 

对于Linux或Mac用户，最后一个办法是禁用SMAPI控制台窗口。但禁用后您便只能通过查看SMAPI日志文件来查看Mod错误或更新信息，此外每当您的游戏崩溃后，只有手动删除 smapi-internal/StardewModdingAPI.crash.marker 文件才能再次打开游戏。您应该定期查看SMAPI日志来确保Mod运行正常。如果您到这里依然想尝试这个办法，请按下面的步骤操作：

  • Linux:
    1. 找到您的游戏文件夹。
    2. 使用文本编辑器打开名为 StardewValley 的文件（没有文件拓展名）。
    3. 删除在 # open SMAPI in terminal 下面的整个段落（直到内容为 fi 的一行为止）。
    4. 在最底部找到以下文本： 
      if [ $? -eq 127 ]; then
   $LAUNCHER --no-terminal
fi

      然后将它更改为： 

      $LAUNCHER --no-terminal
  • Mac：
    1. 找到您的游戏文件夹。
    2. 使用文本编辑器打开名为 StardewValley 的文件（没有文件拓展名）。
    3. 找到以下文本： 
      open -a Terminal ./StardewModdingAPI.bin.osx $@

      然后将它更改为： 

      ./StardewModdingAPI.bin.osx $@ 2>&1 > /dev/null
  • Windows：无法禁用SMAPI控制台窗口。

在更新SMAPI后，您需要重复上述步骤。

更新到最新版本后，启动游戏后仍然显示需要更新SMAPI或游戏本体

这通常是因为您在电脑上的不同文件夹内同时有两份游戏，其中一份已更新到最新版，但您正在的玩的却是另一份。

按照以下方法来检查是否由于该原因导致的问题：

  1. 重新运行SMAPI安装程序，然后注意控制台窗口顶部附近显示的游戏路径：
    SMAPI installer path.png
  2. 直接启动运行SMAPI的游戏，然后注意控制台窗口输出最上面的“Mods go here”这一行，便是您正在运行的游戏版本存放Mod的路径：
    SMAPI mods path.png
  3. 如果上面的两个路径不一致（除了 /Mods 这一部分），那就证明您在电脑上的不同文件夹内同时有两份游戏。

此时最好的办法就是卸载不需要的游戏版本，只保留一份。您可以按照以下步骤进行操作：

  1. 将您的 Mods 文件夹复制到其他地方。
  2. 卸载游戏。
  3. 将您先前找到的两个游戏文件夹都删掉。
  4. 通过Steam或GOG Galaxy重新安装游戏。
  5. 重新安装SMAPI，此时它应当能正确检测出您唯一的游戏路径了。
  6. 将您备份的 Mods 文件夹复制回刚刚安装的游戏文件夹中。
其他选择 
如果您确实需要同时安装多份游戏，您可以将SMAPI的安装程序复制到您想要更新SMAPI的游戏版本的子文件夹中。当您运行SMAPI的安装程序时，它会自动检测上一级的文件夹并更新SMAPI。

修复特定问题

"SMAPI can't find the game"

  • 请确保您运行的是在游戏文件夹中的 SMAPI mascot.png StardewModdingAPI.exe 程序（查看SMAPI安装指南）。
  • 如果您是使用手动方式安装的SMAPI（没有使用SMAPI安装程序），请确保您安装时复制了正确文件：在Windows上应该为 internal/Windows。

Oops You don't have the required .NET version installed（仅限Windows）

如果您是64位Windows 10或以上的系统

  1. 确保您已经按照在Windows上安装SMAPI页面中的步骤安装了正确的.NET 5版本。
  2. 尝试修改系统环境变量：
    1. 同时在键盘上按下Windows+R键，在弹出的运行窗口中输入sysdm.cpl，然后点击“确定”。
    2. 在弹出的“系统属性”窗口中切换到“高级”一栏，然后点击右下角的“环境变量”按钮。
    3. 在下半部分的系统变量列表中找到名为“Path”的变量，点击“编辑”按钮。
      编辑环境变量 图1
    4. 在新弹出的“编辑环境变量”窗口中查看是否有C:\Program Files\dotnet\这一项。如果有这一项，将其选中，多次重复点击右侧的“上移”按钮，将其移动到列表的最顶部；如果没有这一项，您可以点击右侧的“新建”按钮在文本框中手动输入这一项，并同样将它上移至列表最顶部。
      编辑环境变量 图2
    5. 依次点击每个窗口的“确定”，直到你关闭前面几个步骤中打开的所有窗口（即最后点击“系统属性”窗口的“确定”按钮）。
    6. 重新运行SMAPI安装程序，此时应该一切正常了。
  3. 如果按照以上步骤依然无法解决问题，请寻求帮助。

如果您是64位Windows 7系统

微软已经停止支持Windows 7系统，建议您将系统升级至Windows 10。如果您因为种种原因无法升级，请参考以下步骤解决问题：

  1. 按照微软官方的.NET 安装指南在Windows 7上安装依赖组件后，再安装.NET 5 （即安装Microsoft Visual C++ 2015-2019 Redistributable 64位和KB3063858 64位）。
    在Windows 7上安装.NET 5
  2. 如果继续出现该错误，您可能还需要按照上面的方法修改系统环境变量。

如果您是32位系统

很抱歉，您无法再使用Mod游玩1.5.5和之后版本的《星露谷物语》，建议您将系统升级至64位Windows 10或以上版本。但您可以通过修改游戏至支持32位游戏的“compability版本”，继续游玩游戏本体：

  1. 打开Steam，在“库”中右键点击“Stardew Valley”，点击属性。
  2. 在弹出的属性窗口中，切换到“测试版”一栏，然后在下拉框中选择“compability - For 32-bit systems”版本。
  3. 等待游戏更新完成后，您便可以开始游戏了！
    Modding - Player Guide - Troubleshooting - Compatibility Branch ZH.png
  4. 如果游戏无法打开，您可能需要安装（或是重新安装）4.5.2或以上版本的 .NET Framework 和4.0版本的 XNA Framework。

除此以外，如果您使用的是Steam平台，您也可以考虑使用SteamDepotDownloader-GUI（图文使用指南）或DepotDownloader或将游戏回退至1.5.4甚至更早的版本，并安装旧版SMAPI（游戏1.5.4版本对应的SMAPI版本为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问题的解决方案。

"Skipped '...' because it doesn't have a manifest.json"

SMAPI在这个Mod对应的文件夹中无法找到 manifest.json 文件。这通常是因为这不是一款基于SMAPI的Mod。请查看位于该Mod发布页或其他位置的文档来进行安装。

Could not load file or assembly

如果报错的"file or assembly"（文件或程序集）以 Microsoft 或 System 开头（例如"FileNotFoundException: Could not load file or assembly 'System.[...]' or one of its dependencies"），这说明游戏依赖的核心框架出了问题。

常用解决方案：

  • 重置游戏文件。
  • 如果上面的方法不起作用，您可以尝试卸载星露谷物语（且删除星露谷物语的整个游戏文件夹），然后重新安装游戏。

（星露谷物语现在已经将需要的依赖组件打包在游戏文件中，所以你应该不需要再自己手动安装它们了。）

启用SMAPI后游戏分辨率发生变化（仅限Windows）

在您启用SMAPI运行游戏后，游戏内的一切都变得更大或更小了。这通常是Windows DPI设置的问题。

常用解决方案：

  1. 右键点击 SMAPI mascot.png StardewModdingAPI.exe 应用程序，打开属性窗格。依次选择兼容性 > 更改高DPI设置。保持弹出的窗口处于打开状态。
  2. 右键点击 Stardew Valley executable icon.png Stardew Valley.exe 应用程序，打开属性窗格。依次选择兼容性 > 更改高DPI设置。保持弹出的窗口处于打开状态。
  3. 将 SMAPI mascot.png StardewModdingAPI.exe 的高DPI设置窗口内的选项调整为 Stardew Valley executable icon.png StardewValley.exe 内的选项。

此外，您也可以尝试更改游戏内设置，将游戏“窗口模式”更改为“窗口”，然后再更改为“全屏”模式，设置为适合您的分辨率（通常为1920×1080分辨率）。

修复其他问题

运行游戏文件夹内的 Stardew Valley executable icon.png Stardew Valley.exe（Windows）或 StardewValley-original（Linux/Mac），以跳过SMAPI直接启动游戏。

寻求帮助

查看模组:帮助页面以寻求帮助。

← 入门
取自“https://zh.stardewvalleywiki.com/mediawiki/index.php?title=模组:使用指南/疑难解答&oldid=25792”