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

来自Stardew Valley Wiki
跳到导航 跳到搜索
模组使用指南 SMAPI mascot.png


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

常用解决方案

基本步骤

  1. 重启电脑。
  2. 确保您的游戏已经更新到了最新版本(WeGame最新版本为1.5.3,其他平台最新版本为1.5.4)。
    在游戏标题界面点击右下角的"?"按钮后,屏幕左下角会显示当前游戏版本。
  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. 安装(或是重新安装)4.5.2版本的 .NET Framework 和4.0版本的XNA Framework。如果您正在使用Steam,也可以在Steam目录下 Steam\steamapps\common\Steamworks Shared\_CommonRedist\XNA\4.0 文件夹中找到XNA Framework的安装包。您可能需要预先卸载 .NET Framework才能进行安装。
    2. 重启电脑。
    3. 运行游戏。
  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次。

游戏没有声音(仅限Windows)

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

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

存档丢失或无法加载

请查看存档#疑难解答

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

  1. 确保您的游戏已经更新到了最新版本(WeGame最新版本为1.5.3,其他平台最新版本为1.5.4)。
    在游戏标题界面点击右下角的"?"按钮后,屏幕左下角会显示当前游戏版本。
  2. 请确保您是在合作模式下进行的游戏。主机需要点击主菜单的“合作”选项,然后选择“主持”农场。如果您在主菜单选择“加载”选项进行游戏,即使您的存档中有空闲的联机小屋,其他玩家也不能加入您的游戏,您只能在单人模式下进行游戏。
  3. 您的存档中有空闲的联机小屋供未加入玩家选择。
  4. 请确保每位玩家都是通过Steam或是GOG Galaxy启动游戏的,而不是直接点击快捷方式。如果您正在使用Mod进行游戏,请按照通过Steam或GOG Galaxy启动SMAPI这个页面的步骤来进行设置。
  5. 作为主机的玩家需要在游戏选项中设置服务器模式为“联机”。
  6. 所有玩家都应尝试关闭Windows防火墙,并关闭所有杀毒软件。同时使用多款杀毒软件很容易导致无法与其他玩家联机。在任何时候您都不应该同时使用多款杀毒软件。
  7. 所有玩家都应尝试重置游戏文件
  8. 所有玩家都应尝试删除游戏的设置文件 startup_preferences ,Windows系统位于 %appdata%/StardewValley 目录下,Linux/Mac系统位于 ~/.config/StardewValley 目录下。
  9. 所有玩家都重启一下电脑。
  10. 所有玩家都重启一下路由器。
  11. 如果您正在Windows上运行游戏,请尝试重新安装.NET Framework 4.5.2,XNA Framework 4.0以及Visual C++ Redistributable Packages for Visual Studio 2013
  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或GOG Galaxy上设置启动项),请不要在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 [email protected]
      

      然后将它更改为:

      ./StardewModdingAPI.bin.osx [email protected] 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"

  • 请确保您运行的是在游戏文件夹中的 StardewModdingAPI.exe 程序(查看SMAPI安装指南)。
  • 如果您是使用手动方式安装的SMAPI(没有使用SMAPI安装程序),请确保您安装时复制了正确文件:在Windows上应该为 internal/Windows ,在Linux/Mac上应该为 internal/Mono

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

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

"missing executable"(仅限Steam)

Steam无法找到游戏启动器,通常是您在Steam上设置的启动选项不正确导致的。 常用解决方案:

  • 如果您想使用SMAPI进行游戏:
    请确保您已经安装了SMAPI且正确设置了启动选项(查看SMAPI安装指南)。
  • 如果您想要卸载SMAPI:
    1. 在Steam客户端中,右键点击Stardew Valley并选择属性
  • 在弹出窗口中,清空启动选项下文本框内的所有文字。

"looks like Mono isn't installed"(仅限Linux/Mac)

只有安装Mono这个框架后,SMAPI及其安装程序才能正常工作。安装Mono并重启您的电脑通常可以修复这个问题。

在Mac上,安装Mono后可能依然无法正常运行。您可以尝试以下步骤:

  • 输入这行命令:
    ln -s /Library/Frameworks/Mono.framework/Versions/Current/bin/mono /usr/local/bin/mono
    
  • 如果运行以上命令后报错或不起作用,您可以安装install Homebrew并在终端中运行这行命令 brew install mono mono-libgdiplus

Could not load file or assembly

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

  1. 常用解决方案:
    平台 需要重新的安装框架
    Windows 重新安装.NET Framework 4.5.2 和 XNA Framework 4.0(必须为该版本的框架)。
    Linux 重新安装 mono-complete
    Mac 重新安装 Mono (任意分支均可)。
  2. 在Windows上,在极少情况下重新安装以上框架并不能解决问题。但由于.NET Framework是Windows底层的一部分,很难修复。在这种情况下您可能需要重置Windows,或是完全重装Windows 10(非常不建议使用Windows 7)。这个方法很麻烦,但应该能解决问题了。

加载存档时游戏无响应(仅限Mac)

仅适用于Mac:在您创建或加载存档时游戏无响应,您可以尝试重新安装Mono(任意分支均可),这通常可以解决该问题。如果不起作用,您可以寻求帮助

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

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

常用解决方案:

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

修复其他问题

运行游戏文件夹内的 Stardew Valley.exe(Windows)或 StardewValley-original(Linux/Mac),以跳过SMAPI直接启动游戏。

寻求帮助

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

入门