更改

跳到导航 跳到搜索

模组:使用指南/入门 (查看源代码)

2022年8月26日 (五) 04:47的版本

删除4,813字节 、 2022年8月26日 (五) 04:47
use new {{executable name}}
第1行： 第1行： −
{{Construction|time=1天|user=[[User:Horizon98|Horizon98]]（[[User talk:Horizon98|讨论]]） 2021年4月15日 (四) 15:25 (UTC)}}
+
{{Modding player guide header}}
−
{{../header}}
     −
  你 想在星露谷物语里使用Mod吗？那就看看这个页面吧！
+
 想在星露谷物语里使用Mod吗？那就看看这个页面吧！
    
==介绍==
 
==介绍==
第10行： 第9行：  
 其实使用Mod很简单！简单地说，你只需要完成下面两个步骤：
 
 其实使用Mod很简单！简单地说，你只需要完成下面两个步骤：
 
# [[#安装SMAPI|安装SMAPI]]。你可以将SMAPI视作Mod和游戏本身之间的桥梁，只有通过它才能让Mod修改游戏运行时的代码。别担心，它很安全，与你的游戏完全兼容。当然，你可以很轻松地随时将它[[模组:在Windows上安装SMAPI#卸载SMAPI|卸载]]。
 
# [[#安装SMAPI|安装SMAPI]]。你可以将SMAPI视作Mod和游戏本身之间的桥梁，只有通过它才能让Mod修改游戏运行时的代码。别担心，它很安全，与你的游戏完全兼容。当然，你可以很轻松地随时将它[[模组:在Windows上安装SMAPI#卸载SMAPI|卸载]]。
−
# 将Mod的压缩包解压到[[#游戏文件夹|游戏目录]]下的<tt> Mods </tt>文件夹。
+
# 将Mod的压缩包解压到[[#游戏文件夹|游戏目录]]下的<samp> Mods </samp>文件夹。
    
 请继续阅读接下来的详细内容。如果你在使用过程中遇到了任何问题，可以查看[[#常见问题|常见问题]]一节以获得解答。
 
 请继续阅读接下来的详细内容。如果你在使用过程中遇到了任何问题，可以查看[[#常见问题|常见问题]]一节以获得解答。
第29行： 第28行：     
 你可以去下面几个地方找到Mod：
 
 你可以去下面几个地方找到Mod：
−
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
 
! 网站
 
! 网站
第56行： 第55行：     
===找到你的游戏文件夹===
 
===找到你的游戏文件夹===
−
 下一步，你需要打开你的游戏文件夹，就是包含<tt> Stardew Valley.exe </tt>(Windows)或<tt> StardewValley.exe </tt>(Linux/Mac)的文件夹。你可以按下面的方法在默认路径找到它：
+
 下一步，你需要打开你的游戏文件夹，就是包含 {{executable name|Stardew Valley}} (Windows)或 {{executable name|StardewValley}} (Linux/Mac)的文件夹。你可以按下面的方法在默认路径找到它：
   −
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
 
! 平台
 
! 平台
−
! 路径
+
!  默认 路径
 
|-
 
|-
 
| Windows
 
| Windows
−
| GOG：<code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</code><br /> 或 <code>C:\GOG Games\Stardew Valley</code><br />Steam：<code>C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</code>
+
| GOG：<code>C:\Program Files (x86)\GOG Galaxy\Games\Stardew Valley</code><br /> 或 <code>C:\GOG Games\Stardew Valley</code><br />Steam：<code>C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</code><br />Xbox App：<code>C:\Program Files\ModifiableWindowsApps\Stardew Valley</code>
 
|-
 
|-
 
| Android
 
| Android
−
| <code>/storage/emulated/0/StardewValley/Mods</code><br />（在文件管理器中通常位于根目录的<code> StardewValley </code>文件夹里。）
+
| <code>/storage/emulated/0/StardewValley/Mods</code><br />（在文件管理器中通常位于根目录的<code>StardewValley</code>文件夹里。）
 
|-
 
|-
 
| Linux
 
| Linux
第99行： 第98行：     
===安装Mod===
 
===安装Mod===
−
 只需将Mod压缩包解压到[[#找到你的游戏文件夹|安装目录]]下的子文件夹<tt> Mods </tt>中，即可安装Mod。同时，你需要确保每个Mod都放在单独的子文件夹里，且没有数字后缀。例如，如果你装了一个叫做<tt> PineapplesEverywhere </tt>的Mod，你的文件结构应该是这样的：
+
 只需将Mod压缩包解压到[[#找到你的游戏文件夹|安装目录]]下的子文件夹<samp> Mods </samp>中，即可安装Mod。同时，你需要确保每个Mod都放在单独的子文件夹里，且没有数字后缀。例如，如果你装了一个叫做<samp> PineapplesEverywhere </samp>的Mod，你的文件结构应该是这样的：
 
<pre>
 
<pre>
 
Stardew Valley/
 
Stardew Valley/
第110行： 第109行：  
 提示：
 
 提示：
 
<ul>
 
<ul>
−
<li>如果你安装了很多Mod，可以将它们放进不同的<tt> Mods </tt>子文件夹中方便管理，SMAPI会自动搜索其中的所有文件夹。例如你可以按下面的方式将两个Mod文件夹<tt> PineapplesEverywhere </tt>和<tt> ApplesNowhere </tt>放进同一个子文件夹中：
+
<li>如果你安装了很多Mod，可以将它们放进不同的<samp> Mods </samp>子文件夹中方便管理，SMAPI会自动搜索其中的所有文件夹。例如你可以按下面的方式将两个Mod文件夹<samp> PineapplesEverywhere </samp>和<samp> ApplesNowhere </samp>放进同一个子文件夹中：
 
<pre>
 
<pre>
 
Stardew Valley/
 
Stardew Valley/
第122行： 第121行：  
        manifest.json
 
        manifest.json
 
</pre></li>
 
</pre></li>
−
<li>如果你想要禁用某些Mod，只需要在文件夹最前面加上<code> . </code>即可，例如<code> .PineapplesEverywhere </code>。如果你没法儿在Windows上这样命名，在文件夹的开头和结尾同时加上<code> . </code>就行，这是一样的，例如<code> .PineapplesEverywhere. </code>。</li>
+
<li>如果你想要禁用某些Mod，只需要在文件夹最前面加上<code>.</code>即可，例如<code>.PineapplesEverywhere</code>。如果你没法儿在Windows上这样命名，在文件夹的开头和结尾同时加上<code>.</code>就行，这是一样的，例如<code>.PineapplesEverywhere.</code>。</li>
−
<li>在解压Mod的压缩包时，建议你将它们先解压到<code> Mods </code>以外的文件夹，然后再将其中的文件复制过去。这样有助于避免多余文件导致的错误。</li>
+
<li>在解压Mod的压缩包时，建议你将它们先解压到<code>Mods</code>以外的文件夹，然后再将其中的文件复制过去。这样有助于避免多余文件导致的错误。</li>
−
<li>如果你有一个文件夹名字像这样：<code> PineapplesEverywhere-1234567890 </code>，真正的Mod文件可能在更深一层的文件夹里，点开这种名字的文件夹仔细检查一下。这种名称的文件夹内通常还有另外几个文件夹，可能还会有使用说明。</li>
+
<li>如果你有一个文件夹名字像这样：<code>PineapplesEverywhere-1234567890</code>，真正的Mod文件可能在更深一层的文件夹里，点开这种名字的文件夹仔细检查一下。这种名称的文件夹内通常还有另外几个文件夹，可能还会有使用说明。</li>
 
</ul>
 
</ul>
    
===配置Mod===
 
===配置Mod===
−
 有些Mod在文件夹里有个<tt> config.json </tt>文件，可以让你自定义Mod的设置。这个文件会在第一次使用该Mod启动游戏时创建。
+
 有些Mod在文件夹里有个<samp> config.json </samp>文件，可以让你自定义Mod的设置。这个文件会在第一次使用该Mod启动游戏时创建。
   −
 要编辑<tt>config.json</tt>文件，不要在游戏运行时编辑文件，否则更改的设置会无法生效。你可以使用各种文本编辑器中打开这个文件，参阅[https://www.w3school.com.cn/js/js_json_syntax.asp JSON语法]进行编辑。请务必确保“值”包含在英文双引号中（例如：<tt>"value"</tt>）。你可使用[https://jsonformatter.curiousconcept.com/ 在线JSON验证器]来确保格式正确。
+
 要编辑<samp>config.json</samp>文件，不要在游戏运行时编辑文件，否则更改的设置会无法生效。你可以使用各种文本编辑器中打开这个文件，参阅[https://www.w3school.com.cn/js/js_json_syntax.asp JSON语法]进行编辑。请务必确保“值”包含在英文双引号中（例如：<samp>"value"</samp>）。你可使用[https://jsonformatter.curiousconcept.com/ 在线JSON验证器]来确保格式正确。
    
===更新Mod===
 
===更新Mod===
−
 需要更新Mod时，直接替换对应Mod的新版本文件即可（如果有类似于<code> config.json </code>的配置文件，记得把它留着）。
+
 需要更新Mod时，直接替换对应Mod的新版本文件即可（如果有类似于<code>config.json</code>的配置文件，记得把它留着）。
    
 详细步骤：
 
 详细步骤：
 
# 下载新版本的Mod文件。
 
# 下载新版本的Mod文件。
 
# 查看Mod的发布页，看看是否更新了重要的安装说明。
 
# 查看Mod的发布页，看看是否更新了重要的安装说明。
−
# 将Mod压缩包解压到除<code> Mods </code>文件夹以外其他位置。
+
# 将Mod压缩包解压到除<code>Mods</code>文件夹以外其他位置。
−
# 同时打开对应Mod的旧版本和新版本文件夹，你应该能分别看到其中的<code> manifest.json </code>文件。
+
# 同时打开对应Mod的旧版本和新版本文件夹，你应该能分别看到其中的<code>manifest.json</code>文件。
 
# 将新版本文件夹中的所有文件或子文件夹复制到旧版本文件夹中（替换目标中的所有文件）。
 
# 将新版本文件夹中的所有文件或子文件夹复制到旧版本文件夹中（替换目标中的所有文件）。
    
===移除Mod===
 
===移除Mod===
−
 要移除Mod，只需将其从<code> Mods </code>文件夹中删除即可。务必检查下相应Mod的发布页面，看看移除Mod时是否有注意事项。
+
 要移除Mod，只需将其从<code>Mods</code>文件夹中删除即可。务必检查下相应Mod的发布页面，看看移除Mod时是否有注意事项。
    
==XNB Mod==
 
==XNB Mod==
−
XNB Mod通过替换游戏<code> Content </code>文件夹中的数据文件(<tt> .xnb </tt>扩展名结尾)来生效。如果某个Mod文件夹中只有<code> .xnb </code>结尾文件，而没有<code> manifest.json </code>文件，那么它便是一个XNB Mod。XNB Mod是一种过时的Mod，我们不再推荐你使用它。但如果你对它感兴趣的话，可以去看看[[模组:使用 XNB 模组]]。
+
XNB Mod通过替换游戏<code>Content</code>文件夹中的数据文件(<samp> .xnb </samp>扩展名结尾)来生效。如果某个Mod文件夹中只有<code>.xnb</code>结尾文件，而没有<code>manifest.json</code>文件，那么它便是一个XNB Mod。XNB Mod是一种过时的Mod，我们不再推荐你使用它。但如果你对它感兴趣的话，可以去看看[[模组:使用 XNB 模组]]。
    
==常见问题==
 
==常见问题==
 
===哪些平台上可以使用Mod？===
 
===哪些平台上可以使用Mod？===
 
 各个平台的Mod支持情况：
 
 各个平台的Mod支持情况：
−
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
 
!colspan="2"| 平台
 
!colspan="2"| 平台
第189行： 第188行：  
 有可能，但是非常罕见。只有几个Mod会影响你的存档。如果你不安装这些Mod，你的存档被损坏的可能性很低。在大多数情况下，你可以[[存档#回档到前一天|回档到前一天]]。
 
 有可能，但是非常罕见。只有几个Mod会影响你的存档。如果你不安装这些Mod，你的存档被损坏的可能性很低。在大多数情况下，你可以[[存档#回档到前一天|回档到前一天]]。
   −
 如果你很担心的话，可以定时备份[[存档|你的存档]]。即使不使用Mod，我们也强烈建议你这么做，因为通常存档损坏是由游戏本身造成的。SMAPI也会每天自动保存一次存档（如果你在当天运行过游戏）。你可以在<tt> Mods/SaveBackup </tt>文件夹内找到它们。
+
 如果你很担心的话，可以定时备份[[存档|你的存档]]。即使不使用Mod，我们也强烈建议你这么做，因为通常存档损坏是由游戏本身造成的。SMAPI也会每天自动保存一次存档（如果你在当天运行过游戏）。你可以在<samp> Mods/SaveBackup </samp>文件夹内找到它们。
    
===我以后可以不用Mod吗？===
 
===我以后可以不用Mod吗？===
第202行： 第201行：  
 下面是部分类型的Mod对多人游戏的支持情况（不完全准确）：
 
 下面是部分类型的Mod对多人游戏的支持情况（不完全准确）：
   −
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
 
! Mod类型
 
! Mod类型
第220行： 第219行：  
|-
 
|-
 
! 数据类
 
! 数据类
−
| 只会直接影响安装Mod的玩家，但会间接影响到其他玩家。举个例子，如果某个[[模组:内容包|内容包]]修改了<code> Data/ObjectInformation </code>内的数据，然后你获得了一个修改过数据的物品；即使其他玩家<code> Data/ObjectInformation </code>内的数据未被修改，他们看到的也会是这项物品修改后的数值。
+
| 只会直接影响安装Mod的玩家，但会间接影响到其他玩家。举个例子，如果某个[[模组:内容包|内容包]]修改了<code>Data/ObjectInformation</code>内的数据，然后你获得了一个修改过数据的物品；即使其他玩家<code>Data/ObjectInformation</code>内的数据未被修改，他们看到的也会是这项物品修改后的数值。
 
|}
 
|}
 
|-
 
|-
第285行： 第284行：  
<li>在这里查找日志文件：
 
<li>在这里查找日志文件：
   −
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
 
! 平台
 
! 平台
第294行： 第293行：  
# 同时在键盘上按下Windows和R。
 
# 同时在键盘上按下Windows和R。
 
# 在弹出的“运行”窗口中输入这行内容：<code>%appdata%\StardewValley\ErrorLogs</code>，然后按下回车键会自动打开文件夹。
 
# 在弹出的“运行”窗口中输入这行内容：<code>%appdata%\StardewValley\ErrorLogs</code>，然后按下回车键会自动打开文件夹。
−
# 日志文件的名称应该是<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>。
+
# 日志文件的名称应该是<samp> SMAPI-crash.txt </samp>或者<samp> SMAPI-latest.txt </samp>。
 
|-
 
|-
 
| Mac
 
| Mac
第301行： 第300行：  
# 点按菜单栏中的“前往”菜单，然后选择“[https://support.apple.com/zh-cn/guide/mac-help/mchlp1236/mac 前往文件夹]”。
 
# 点按菜单栏中的“前往”菜单，然后选择“[https://support.apple.com/zh-cn/guide/mac-help/mchlp1236/mac 前往文件夹]”。
 
# 输入文件夹的路径名称：<code>~/.config/StardewValley/ErrorLogs</code>，然后点按“前往”。
 
# 输入文件夹的路径名称：<code>~/.config/StardewValley/ErrorLogs</code>，然后点按“前往”。
−
# 日志文件的名称应该是<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>。
+
# 日志文件的名称应该是<samp> SMAPI-crash.txt </samp>或者<samp> SMAPI-latest.txt </samp>。
 
|-
 
|-
 
| Linux
 
| Linux
第308行： 第307行：  
# 点击“选项”菜单（也可能是“Go”或者“:”按钮）。
 
# 点击“选项”菜单（也可能是“Go”或者“:”按钮）。
 
# 点击“输入路径”，输入这行内容：<code>~/.config/StardewValley/ErrorLogs</code>，然后按下回车键会自动打开文件夹。
 
# 点击“输入路径”，输入这行内容：<code>~/.config/StardewValley/ErrorLogs</code>，然后按下回车键会自动打开文件夹。
−
# 日志文件的名称应该为<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>。
+
# 日志文件的名称应该为<samp> SMAPI-crash.txt </samp>或者<samp> SMAPI-latest.txt </samp>。
 
|-
 
|-
 
| Android
 
| Android
 
| 
 
| 
 
# 打开文件管理器（或是打开[https://www.coolapk.com/apk/bin.mt.plus MT管理器]）。
 
# 打开文件管理器（或是打开[https://www.coolapk.com/apk/bin.mt.plus MT管理器]）。
−
# 在你的手机存储中并打开找到<tt> StardewValley </tt>文件夹。
+
# 在你的手机存储中并打开找到<samp> StardewValley </samp>文件夹。
−
# 继续打开里面的 <tt> ErrorLogs </tt>子文件夹。
+
# 继续打开里面的 <samp> ErrorLogs </samp>子文件夹。
−
# 日志文件的名称应该为<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>。
+
# 日志文件的名称应该为<samp> SMAPI-crash.txt </samp>或者<samp> SMAPI-latest.txt </samp>。
 
|}
 
|}
 
</li>
 
</li>
第324行： 第323行：  
{{Collapse|下方的图片会告诉你如何读懂SMAPI的日志（点击展开）：|content=[[File:Modding - Player Guide - Troubleshooting - SMAPI Log Parser ZH.png|1000px|SMAPI日志解析器]]}}
 
{{Collapse|下方的图片会告诉你如何读懂SMAPI的日志（点击展开）：|content=[[File:Modding - Player Guide - Troubleshooting - SMAPI Log Parser ZH.png|1000px|SMAPI日志解析器]]}}
   −
<li>复制当前网址的链接，它应该像这样：<tt> https://smapi.io/log/一串字母和数字 </tt>。
+
<li>复制当前网址的链接，它应该像这样：<samp> https://smapi.io/log/一串字母和数字 </samp>。
    
<li>查看[[模组:帮助]]页面，前往其他社区提问并附上你刚刚复制的网址。
 
<li>查看[[模组:帮助]]页面，前往其他社区提问并附上你刚刚复制的网址。
第334行： 第333行：     
===我可以在几组Mod之间切换吗？===
 
===我可以在几组Mod之间切换吗？===
−
 当然，SMAPI 对 不同 的Mod组别提供支持 。接下来的说明可能看起来有点复杂，但是只要你按步骤操作，其实非常简单：
+
 当然，SMAPI 可以让你在 不同 的几组Mod之间切换 。接下来的说明可能看起来有点复杂，但是只要你按步骤操作，其实非常简单：
   −
{| class="wikitable"
+
{|class="wikitable"
 
|-
 
|-
−
! Platform
+
! 平台
−
! Instructions
+
! 实现步骤
 
|-
 
|-
 
| Windows
 
| Windows
 
| &#32;
 
| &#32;
−
# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.
+
# 在你的[[# 找到你的游戏文件夹| 游戏文件夹]] 内为每一组Mod都新建一个文件夹，例如<code>Mods</code> 和 <code>Mods (multiplayer)</code> 。
−
# Create a shortcut to the <tt>StardewModdingAPI.exe</tt> file.
+
# 右键点击 {{executable name|StardewModdingAPI}}，选择<samp> 创建快捷方式 </samp> ，然后将创建好的快捷方式移动到你喜欢的地方。
−
# Right-click the shortcut, choose <tt>Properties</tt>, and add this to the end of the <tt>Target</tt> field: <code> --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\SteamLibrary\steamapps\common\Stardew Valley\StardewModdingAPI.exe" --mods-path "Mods (multiplayer)"</code>.
+
# 右键点击这个快捷方式，选择<samp> 属性 </samp> ，在弹出的新窗口的<samp> 目标 </samp> 文本框的最后输入这部分参数：<code> --mods-path "Mods (multiplayer)"</code> 。你可以按照自己的实际情况更改<samp> Mods (multiplayer) </samp>这个文件夹的名字。''' 注意！千万不要删除“目标”这个文本框里本来的内容！直接把这部分参数加在它的最后就行。''' 如果你在这一步做得没问题，现在<samp> 目标 </samp>文本框里应该像这样：<code>" 你的Steam程序目录\steamapps\common\Stardew Valley\StardewModdingAPI.exe" --mods-path "Mods (multiplayer)"</code> 。
−
# Double-click that shortcut to launch SMAPI with the specified mod folder.
+
# 现在双击这个快捷方式运行程序，就可以直接使用你指定的一组Mod运行游戏了。
 +
# 你可以根据自己的实际需要，按照前面几步创建加载另外一组Mod的快捷方式。
 
|-
 
|-
 
|-
 
|-
 
| Windows (Steam)
 
| Windows (Steam)
 
| &#32;
 
| &#32;
−
# Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.
+
# 在你的[[# 找到你的游戏文件夹| 游戏文件夹]] 内为每一组Mod都新建一个文件夹，例如<code>Mods</code> 和 <code>Mods (multiplayer)</code> 。
−
# Create a shortcut to your <tt>steam.exe</tt> file.
+
# 打开你Steam程序的安装目录，右键点击 {{executable name|Steam}} ，选择<samp> 创建快捷方式 </samp> ，然后将创建好的快捷方式移动到你喜欢的地方。
−
# Right-click the shortcut, choose <tt>Properties</tt>, and add this to the end of the <tt>Target</tt> field: <code>-applaunch 413150 --mods-path "Mods (multiplayer)"</code> (changing folder name as needed). '''Don't delete any of the existing text in that field! This should be added to the end of what's already there.''' Done correctly, it should look something like <code>"your-path-here\Steam\steam.exe" -applaunch 413150 --mods-path "Mods (multiplayer)"</code>.
+
# 右键点击这个快捷方式，选择<samp> 属性 </samp> ，在弹出的新窗口的<samp> 目标 </samp> 文本框的最后输入这部分参数：<code> -applaunch 413150 --mods-path "Mods (multiplayer)"</code> 。你可以按照自己的实际情况更改<samp> Mods (multiplayer) </samp>这个文件夹的名字。''' 注意！千万不要删除“目标”这个文本框里本来的内容！直接把这部分参数加在它的最后就行。''' 如果你在这一步做得没问题，现在<samp> 目标 </samp>文本框里应该像这样：<code>" 你的Steam程序目录\Steam\steam.exe" -applaunch 413150 --mods-path "Mods (multiplayer)"</code> 。
−
# Optionally you can click the <tt>"Change Icon..."</tt> button and browse to your Stardew Valley folder to change the icon of the shortcut from the Steam icon to the Stardew Valley Icon.
+
# （可选）你可以右键点击这个快捷方式，选择<samp> 属性 </samp>，然后在弹出的新窗口中点击<samp> 更改图标… </samp>按钮。随后会弹出的“更改图标”的窗口，点击<samp> 浏览 </samp>，定位到你的[[#找到你的游戏文件夹|游戏文件夹]]，选中星露谷物语的图标，然后选择<samp> 打开 </samp> ，你便成功将这个快捷方式的图标修改为游戏图标了。
−
# Double-click that shortcut to make Steam launch SMAPI with the specified mod folder and all steam features.
+
# 现在双击这个快捷方式运行程序，就可以直接使用你指定的一组Mod，启动SMAPI运行游戏并同时使用Steam的功能了。
 +
# 你可以根据自己的实际需要，按照前面几步创建加载另外一组Mod的快捷方式。
 
|-
 
|-
 
| Linux
 
| Linux
 
| <ol>
 
| <ol>
−
<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>
+
<li> 在你的[[# 找到你的游戏文件夹| 游戏文件夹]] 内为每一组Mod都新建一个文件夹，例如<code>Mods</code> 和 <code>Mods (multiplayer)</code> 。</li>
−
<li>Create a file like <tt>SMAPI_multiplayer.sh</tt> on your desktop.</li>
+
<li> 在你的桌面上创建一个名字类似于<samp> SMAPI_multiplayer.sh </samp> 的文件。</li>
−
<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/StardewValley</tt> with the full path to the <tt>StardewValley</tt> file in [[#Find your game folder|your game folder]]):
+
<li> 编辑这个文件，在里面输入下面的内容（按照自己的实际情况更改<samp> Mods (multiplayer) </samp>这个文件夹的名字，并将<samp>/path/to/StardewValley</samp> 这部分内容替换成你电脑上的<samp> StardewValley </samp> 文件及其所在的[[# 找到你的游戏文件夹| 游戏文件夹]] ）：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
#!/bin/bash
 
#!/bin/bash
 
SMAPI_MODS_PATH="Mods (multiplayer)" /path/to/StardewValley
 
SMAPI_MODS_PATH="Mods (multiplayer)" /path/to/StardewValley
 
</syntaxhighlight></li>
 
</syntaxhighlight></li>
−
<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>
+
<li> 查看[https://support.apple.com/zh-cn/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac 这篇适用于Linux或Mac上的教程] ，将该文件设置为“可执行文件”。</li>
−
<li>Double-click the script to launch SMAPI with the specified mod folder.</li>
+
<li>现在双击运行这个脚本，就可以直接使用你指定的一组Mod运行游戏了。</li>
 +
<li> 你可以根据自己的实际需要，按照前面几步创建加载另外一组Mod的脚本。</li>
 
</ol>
 
</ol>
 
|-
 
|-
 
| Mac
 
| Mac
 
| <ol>
 
| <ol>
−
<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods (multiplayer)</code>.</li>
+
<li> 在你的[[# 找到你的游戏文件夹| 游戏文件夹]] 内为每一组Mod都新建一个文件夹，例如<code>Mods</code> 和 <code>Mods (multiplayer)</code> 。</li>
−
<li>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</li>
+
<li> 在你的桌面上创建一个名字类似于<samp> SMAPI_multiplayer.command </samp> 的文件。</li>
−
<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/StardewValley/StardewModdingAPI.bin.osx</tt> with the full path to the <tt>StardewModdingAPI.bin.osx</tt> file in [[#Find your game folder|your game folder]]):
+
<li> 编辑这个文件，在里面输入下面的内容（按照自己的实际情况更改<samp> Mods (multiplayer) </samp>这个文件夹的名字，并将<samp>/path/to/StardewValley/StardewModdingAPI.bin.osx</samp> 这部分内容替换成你电脑上的<samp> StardewModdingAPI.bin.osx </samp> 文件及其所在的[[# 找到你的游戏文件夹| 游戏文件夹]] ）：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
/path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"
 
/path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"
 
</syntaxhighlight></li>
 
</syntaxhighlight></li>
−
<li>Example: <code>~/Library/Application\ Support/Steam/steamapps/common/Stardew\ Valley/Contents/MacOS/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"</code></li>
+
<li> 例如：<code>~/Library/Application\ Support/Steam/steamapps/common/Stardew\ Valley/Contents/MacOS/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"</code></li>
−
<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>
+
<li> 查看[https://support.apple.com/zh-cn/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac 这篇适用于Linux或Mac上的教程] ，将该文件设置为“可执行文件”。</li>
−
<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <tt>chmod u+x /path/to/SMAPI multiplayer.command</tt> to give yourself these access privileges.</li>
+
<li> 如果你看到了报错："The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." 你可以在“访达”中选择文件，点击“详细信息”来查看或修改这个文件的权限。然后你还可以在终端中输入这行代码（按实际情况更改目录）：<code>chmod u+x /path/to/SMAPI multiplayer.command</code>，手动给这个文件提权。</li>
−
<li>Double-click the script to launch SMAPI with the specified mod folder.</li>
+
<li> 现在双击运行这个脚本，就可以直接使用你指定的一组Mod运行游戏了。</li>
 +
<li> 你可以根据自己的实际需要，按照前面几步创建加载另外一组Mod的脚本。</li>
 
</ol>
 
</ol>
 
|-
 
|-
 
| Mac (Steam)
 
| Mac (Steam)
 
| <ol>
 
| <ol>
−
<li>Create a separate folder for each mod group in [[#Find your game folder|your game folder]], like <code>Mods</code> and <code>Mods(multiplayer)</code>. Note there shouldnt be a space between "Mods" and "(multiplayer)".</li>
+
<li> 在你的[[# 找到你的游戏文件夹| 游戏文件夹]] 内为每一组Mod都新建一个文件夹，例如<code>Mods</code> and <code>Mods(multiplayer)</code> 。注意：文件夹名字中不能带有空格。</li>
−
<li>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</li>
+
<li> 在你的桌面上创建一个名字类似于<samp> SMAPI_multiplayer.command </samp> 的文件。</li>
−
<li>Edit the file and set the text to this (change the folder name as needed, and replace <tt>/path/to/steam_osx</tt> with the full path to the <tt>steam_osx</tt> file (you can find the path for <tt>steam_osx</tt> by using <tt>sudo find / -name steam_osx</tt>):
+
<li> 编辑这个文件，在里面输入下面的内容（按照自己的实际情况更改<samp> Mods(multiplayer) </samp>这个文件夹的名字（文件夹名字中不能带有空格），并将<samp>/path/to/steam_osx</samp> 这部分内容替换成你电脑上的<samp> steam_osx </samp> 文件及其所在的路径，你可以使用<code>sudo find / -name steam_osx</code> 这条命令来找到<samp> steam_osx </samp> 所在的文件夹））：
 
<syntaxhighlight lang="bash">
 
<syntaxhighlight lang="bash">
 
/path/to/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"
 
/path/to/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"
 
</syntaxhighlight></li>
 
</syntaxhighlight></li>
−
<li>Example: <code>/Applications/Steam.app/Contents/MacOS/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"</code></li>
+
<li> 例如：<code>/Applications/Steam.app/Contents/MacOS/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"</code></li>
−
<li>Mark the file executable (see [https://support.apple.com/en-ca/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac instructions for Linux or Mac]).</li>
+
<li> 查看[https://support.apple.com/zh-cn/guide/terminal/apdd100908f-06b3-4e63-8a87-32e71241bab4/mac 这篇适用于Linux或Mac上的教程] ，将该文件设置为“可执行文件”。</li>
−
<li>If you get the error: "The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." Then use the following code in the terminal: <tt>chmod u+x /path/to/SMAPI multiplayer.command</tt> to give yourself these access privileges.</li>
+
<li> 如果你看到了报错："The file “SMAPI multiplayer.command” could not be executed because you do not have appropriate access privileges. To view or change access privileges, select the file in the Finder and choose File > Get Info." 可以在“访达”中选择文件，点击“详细信息”来查看或修改这个文件的权限。然后你还可以在终端中输入这行代码（按实际情况更改目录）：<code>chmod u+x /path/to/SMAPI multiplayer.command</code>，手动给这个文件提权。</li>
−
<li>Double-click the script to make Steam launch SMAPI with the specified mod folder and all steam features.</li>
+
<li>现在双击运行这个脚本，就可以直接使用你指定的一组Mod，启动SMAPI运行游戏并同时使用Steam的功能了。</li>
 +
<li> 你可以根据自己的实际需要，按照前面几步创建加载另外一组Mod的脚本。</li>
 
</ol>
 
</ol>
 
|-
 
|-
 
|}
 
|}
   −
 在Windows上，[https://moddrop.com ModDrop]这款Mod管理器 也支持你设置3 组Mod ，以便在它们 之间切换 。
+
 在Windows上， 你也可以使用[https://moddrop.com ModDrop]这款Mod管理器 来在几 组Mod之间切换， 它 最多 支持 你 设置3 组不 同 的Mod。
−
 
  −
<!--
  −
 
  −
 
  −
 
  −
 
  −
 
  −
 
  −
 
  −
===修复常见的错误消息===
  −
* ''"哎呀！SMAPI找不到游戏了。"''
  −
** 请确定你运>行的是游戏文件夹里的<tt>StardewModdingAPI.exe</tt>(请看[[#安装SMAPI|安装说明]])
  −
** 你是否手动安装了SMAPI（不使用<tt>install.exe</tt>）？请确保你已复制了正确的文件：Windows上是<tt>internal/Windows</tt> ，Linux/Mac上是<tt>internal/Mono</tt>
  −
 
  −
* ''"哎呀！SMAPI似乎与游戏不兼容。"''
  −
** 确保你的游戏是1.2.30或更高版本。
  −
 
  −
* ''"跳过 '...' 因为找不到manifest.json"''
  −
** SMAPI找不到该Mod文件夹​​中的<tt>manifest.json</tt>文件。一般来说这表示安装的不是一个SMAPI Mod ， 所以放在<tt>Mods</tt>文件夹里无法生效。请参阅该Mod文档的安装说明。
  −
 
  −
===SMAPI文件消失或杀毒软件报错===
  −
你的杀毒软件可能会删除或报错某些SMAPI文件。这是因为''启发式检测'' -  SMAPI改写Mod使其在你的计算机上工作，恶意软件也会改写文件，所以杀毒软件才会报错。 SMAPI没有木马程序 - 这点你可以通过[https://github.com/Pathoschild/SMAPI 阅读代码]，[https://www.jetbrains.com/decompiler/ 反编译下载]或将其上传到[https://www.virustotal.com/ VirusTotal]进行检查。你只需要告诉你的杀毒软件“SMAPI是安全的”就可以了;可以搜索杀毒名称+“添加白名单”来查找教程。
  −
 
  −
===检查版本===
  −
# 确保你安装了[https://github.com/Pathoschild/SMAPI/releases  最 新版本的SMAPI]。<br /><small>SMAPI版本显示在SMAPI控制台窗口的顶部。</small>
  −
# 确保你的游戏是1.2.30或更高版本。<br /><small>点击游戏标题画面的问号按钮，版本会显示在左下方。</small>
  −
 
  −
===重置Content文件夹===
  −
许 多 问题是由<tt>Content</tt>文件夹中的文件损坏引起的（尤其是使用了XNB模组）。可以重置游戏文件来解决这个问题。
  −
 
  −
; 选项 1&#58; 重置所有文件（推荐）
  −
 
  −
:# 参见说明：[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 Steam版]或[https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy版]。所有的XNB Mod将被删除，SMAPI Mod不受到影响。
  −
:# 如果 你 是在Linux / Mac上使用SMAPI，请重新安装SMAPI来修复启动器。
  −
 
  −
; 选项 2&#58; 重置一个文件
  −
: 如果你安装了XNB模组并且想要重置一个已知会引起错误的文件，你可以恢复备份的原始游戏文件。如果你之前忘记做备份了，以下是恢复原始文件，且不会丢失修改的文件的方法：
  −
:# 复制一个游戏安装目录下的<tt>Content</tt>文件夹，重命名为<tt>Content-modded</tt>。
  −
:# 重置游戏文件夹(参见说明：[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 Steam版]或[https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy版])。
  −
:# 复制一个（重置过的）<tt>Content</tt>文件夹，重命名为<tt>Content-backup</tt>。
  −
:# 把<tt>Content-modded</tt>里的内容复制到<tt>Content</tt>。
  −
: 这样你的content文件夹仍然是打了Mod的，但是你有了原始文件的备份。
  −
 
  −
; 选项 3&#58; 排查XNB模组
  −
: 如果你安装了很多XNB模组，不确定导致该出错的Mod是哪一个，并且不想删除所有XNB模组，以下是找到出错Mod的方法。
  −
:# 备份所有想保留的XNB模组。
  −
:# 重置游戏文件(参见说明：[https://support.steampowered.com/kb_article.php?ref=2037-QEUH-3335 Steam版]或[https://support.gog.com/hc/en-us/articles/212807405 GOG Galaxy版])。所有的XNB Mod将被删除，SMAPI Mod不受到影响。
  −
:# 如果你是在Linux / Mac上使用SMAPI，请重新安装SMAPI来修复启动器。
  −
# 启动游戏，看看问题是否解决。
  −
# 一个一个的安装备份的Mod，每安装一个就打开游戏测试，以确保Mod不会出问题。
  −
 
  −
===SEHException: 外部 组 件发生异常===
  −
你可能会在错误提示中看到类似<tt>SEHException</tt>的文字：
  −
 
  −
<pre>
  −
System.Runtime.InteropServices.SEHException (0x80004005): External component has thrown an exception.
  −
  at new[](UInt32 )
  −
  at Microsoft.Xna.Framework.Audio.UnsafeNativeMethods.AllocateArrayAndReadFile(String filename, Void** ppData, UInt32* pdwBufferSize)
  −
  at Microsoft.Xna.Framework.Audio.UnsafeNativeMethods.WaveBank.CreateHandle(UInt32 hEngine, String string, Int32 length, IntPtr& pCleanup)
  −
  at Microsoft.Xna.Framework.Audio.WaveBank..ctor(AudioEngine audioEngine, String nonStreamingWaveBankFilename)
  −
  at StardewValley.Game1.Initialize()
  −
  at StardewModdingAPI.Inheritance.SGame.Initialize() in D:\source\_Stardew\SMAPI\src\StardewModdingAPI\Inheritance\SGame.cs:line 302
  −
  at Microsoft.Xna.Framework.Game.RunGame(Boolean useBlockingRun)
  −
  at Microsoft.Xna.Framework.Game.Run()
  −
  at StardewModdingAPI.Program.StartGame() in D:\source\_Stardew\SMAPI\src\StardewModdingAPI\Program.cs:line 274
  −
</pre>
  −
 
  −
这个错误发生在游戏的音频启动代码中，它对音频准备就绪之前使用的资源非常敏感。这 不 是由SMAPI直接引起的，尽管SMAPI在启动过程中使用了一些额外的资源。
  −
 
  −
通常解决方案
  −
* 重启你的电脑。
  −
* 在打开游戏前关闭浏览器和其他程序。（可以在游戏开始后重新打开它们）
  −
* 删除任何更改游戏音频的Mod（例如添加更多音乐 的Mod ）。
  −
 
  −
===其他问题===
  −
不通过SMAPI运行游戏，方法是打开[[#游戏文件夹|游戏文件夹]]中的<tt>Stardew Valley.exe</tt>（Windows）或<tt>StardewValley-original</tt>（Linux / Mac）。
  −
 
  −
* 如果'''不通过'''SMAPI运行游戏依然出错：请参阅[https://steamcommunity.com/app/413150/discussions/0/142261352650065356/ 本指南来修复游戏]。如果你仍然需要帮助，请[[#寻找帮助|查询帮助]]。
  −
* 如果只有在'''通过'''SMAPI运行游戏才出错：请看[[#寻找帮助|查询帮助]]。
  −
 
  −
==寻求帮助==
  −
===寻找帮助===
  −
关于Mod的问题，直接问Mod作者是最好的方式。以下是与他们取得联系的最佳方式：
  −
 
  −
# 在Mod页面上的讨论贴链接（如果有的话）;
  −
# Nexus Mod页面上的“BUG”页面（如果有的话）;
  −
# 也可以直接与作者联系（例如使用Nexus Mod页面上的“Contact”按钮）。
  −
 
  −
如果是关于SMAPI的问题，或者你无法联系上Mod的作者，[http://community.playstarbound.com/threads/dos-and-donts-of-reporting-issues-with-smapi-mods.125211/ 请到这里跟帖]或[https://discord.gg/kH55QXP 在Discord上询问。]
  −
 
  −
===在上报错误时需要包含的内容===
  −
<span id="bug-report"></span>
  −
 
  −
让其他人弄清楚你的游戏因为什么出现错误是很困难的一件事，所以如果你尽可能的多地提供一些信息可以帮助别人解答你的问题。以下是你可以提供的最有用信息 。
     −
# 描述你的问题：
  −
#* 哪个mod有问题？
  −
#* 问题是什么？尽可能详细描述。（游戏是否卡住或闪退？是否变黑屏？还是什么都没发生？）
  −
#* 当游戏出错时你在做什么？你有发现什么固定规律吗？例如，当你做某件事情时总是会发生崩溃。
  −
# 描述你的使用环境：
  −
#* 你是否使用Mod管理软件？如果有，写出软件名字。
  −
#* 你在Linux，Mac还是Windows上玩？
  −
# 重现这个游戏错误（这样在日志中会记载详细信息），然后把最新日志文件的复制粘贴上去（请看上一部分）。
  −
-->
   
{{Modding guide footer
 
{{Modding guide footer
 
   |prev =
 
   |prev =
Pathoschild
8,411

个编辑

取自“https://zh.stardewvalleywiki.com/Special:移动版差异/19420...25790”

导航菜单