模组:在Steam Deck上安装SMAPI

模组使用指南

此页面解释如何在 Steam Deck 上安装 SMAPI。其中，Steam Deck 是 Steam 制造的掌上主机，SMAPI 是用于运行模组的工具。

其他平台的安装指南：Android • Linux • macOS • Windows。

安装

开始之前

安装 SMAPI 之前，您需要知晓正在运行的游戏是何种版本：“原生”（Linux 版）或 "Proton"（Windows 版）。如果您不确定，请从库中选择 Stardew Valley，然后向下滑动，选择 GAME INFO 选项卡。在 "Steam Deck Compatibility" 下面，会有提示 {compatibility mode} selected by (Valve or you)。其中 {compatibility mode} 为 Steam Linux Runtime（原生）或 Proton {version}（Windows）。

原生模式下的星露谷物语

下载最新的 Linux 版的 SMAPI。
在适当位置解压 .zip 压缩包（但不要在游戏文件夹中解压！）。
运行 install on Linux.sh 文件，然后按屏幕上出现的指引操作。
（如果安装器询问安装路径，参见如何找到你的游戏文件夹。）

如需手动安装，参见安装包中的 README 文档。

Proton中的星露谷物语

警告：如果您正在 Proton 模式下运行星露谷物语，则您加装了模组的存档不能云同步。

添加 SMAPI 文件：
1. 下载最新的 Windows 版本的 SMAPI。
2. 在适当位置解压 .zip 压缩包（但不要在游戏文件夹中解压！）。
3. 打开安装器文件夹中的 README.txt 文件。
4. 根据文件中的说明，手动安装 Windows 版的 SMAPI。
  请勿仅把安装文件复制到游戏文件夹。完整的流程需要数个步骤，见 README.txt 文件中的说明。
配置 Steam：
1. 在 Steam 客户端中，点击 "Games"（顶部菜单）> "Add a Non-Steam Game to My Library"。
2. 在弹出的 "Add a Game" 窗口中，点击 "Browse" 然后选择您的游戏文件夹中的 StardewModdingAPI。
3. 现在，一个新的名为 "StardewModdingAPI" 的游戏会出现在 Steam 库中。
4. 将这个“新游戏”也设为通过 Proton 运行。
（可选）您的星露谷云存档不会被自动迁移到 SMAPI。修复方法：
1. 打开如下文件夹：~/.local/share/Steam/steamapps/compatdata/<STEAM_ID>/pfx/drive_c/users/steamuser/AppData （其中 STEAM_ID 是您的星露谷物语 ID）。
  如果您不确定是哪一个，请在 ~/.local/share/Steam/steamapps/compatdata 文件夹中打开终端，然后运行 find | grep -i Stardew 以找到它。
2. 将存档从 Stardew Valley 文件夹复制到对应的 SMAPI 文件夹。

现在只需通过 Steam 运行 StardewModdingAPI 即可开始游玩。

升级SMAPI

只需安装新版本；安装器会自动清除先前的版本。

卸载

重新运行安装器（参见安装步骤）。
在安装器询问要执行何种操作时，选择 "uninstall"（卸载）选项。

疑难解答

游戏更新后SMAPI不再出现

重新运行 SMAPI 安装器以修复启动器。

安装SMAPI后无法启动游戏

在您的游戏文件夹中打开一个终端。
在终端中运行 ./StardewModdingAPI 以查看具体错误：
- 如果您看到了 "The library 'libhostpolicy.so' required to execute the application was not found"，则您的游戏版本为 Proton，而 SMAPI 版本为 Linux。请参阅上文的针对 Proton 的安装指南。
- 如果您看到了其他错误，请查看“疑难解答”页面是否有相应的小节。如果没有，请查看其中的“寻求帮助”小节。

其他问题

参见“疑难解答”页面以了解排除故障的一般方法。

← 入门

Modding:Installing SMAPI on Steam Deck