更改

添加16,918字节 、 2021年4月15日 (四) 15:26
更新部分页面
第1行: 第1行: −
{{Construction|time=1天|user=[[User:Horizon98|Horizon98]]([[User talk:Horizon98|讨论]]) 2021年4 月14 日 ( ) 16:13 (UTC)}}
+
{{Construction|time=1天|user=[[User:Horizon98|Horizon98]]([[User talk:Horizon98|讨论]]) 2021年4 月15 日 ( ) 15:25 (UTC)}}
 
{{../header}}
 
{{../header}}
    +
你想在星露谷物语里使用Mod吗?那就看看这个页面吧!
   −
你想在 星露谷物语 使 用mod吗?
+
==介绍==
 +
===什么是模组/Mod?===
 +
'''模组'''即Mod,一种以某种方式修改了《 星露谷物语 》本体的文件。模组可以添加功能(如在地图上显示NPC),改变游戏机制(比如让围栏坏得更慢),改变贴图(让你的房子看起来像霍比特人的家),以及更多功能。
 +
 
 +
其实 使 用Mod很简单!简单地说,你只需要完成下面两个步骤:
 +
# [[#安装SMAPI|安装SMAPI]]。你可以将SMAPI视作Mod和游戏本身之间的桥梁,只有通过它才能让Mod修改游戏运行时的代码。别担心,它很安全,与你的游戏完全兼容。当然,你可以很轻松地随时将它[[模组:在Windows上安装SMAPI#卸载SMAPI|卸载]]。
 +
# 将Mod的压缩包解压到[[#游戏文件夹|游戏目录]]下的<tt> Mods </tt>文件夹。
 +
 
 +
请继续阅读接下来的详细内容。如果你在使用过程中遇到了任何问题,可以查 [[#常见问题|常见问题]]一节以获得解答。
 +
 
 +
==快速上手==
 +
===安装SMAPI===
 +
在使用大多数Mod之前,您需要先安装Mod加载器,即SMAPI。关于在各 平台安装、更新或删除SMAPI的详细说明,请点击下面相应的链接查看:
 +
* [[模组:在Windows上安装SMAPI|在Windows上安装SMAPI]]
 +
* [[模组:在Mac上安装SMAPI|在Mac上安装SMAPI]]
 +
* [[模组:在Linux上安装SMAPI|在Linux上安装SMAPI]]
 +
* [[模组:在Android上安装SMAPI|在Android上安装SMAPI]]
 +
 
 +
===寻找模组===
 +
接下来你就可以去下载你需要的Mod了,下 是一些建议:
 +
* [http://www.nexusmods.com/stardewvalley/mods/topalltime/ Nexus上最热门的Mod];
 +
* [https://gist.github.com/Pathoschild/b608892d3e60bd25d0eea71ca7584649 一些推荐的Mod];
 +
* 如果你是第一次游玩《星露谷物语》,原版的游戏也非常有魅力
   −
==介绍==
+
你可以去下面几个地方找到Mod:
===什么是模组\MOD?===
+
{| class="wikitable"
''' 模组''' 即MOD 一种 某种方式改变了Stardew Valley 文件 模组 可以 添加功能 地图 显示NPC) 改变游戏机制(比如让围栏坏 更慢) 改变贴图(让你的房子看起来像霍比特人的家) 以及更多功 能。
+
|-
 +
! 网站
 +
! 描述
 +
|-
 +
| '''[http://nexusmods.com/stardewvalley/ Nexus Mods]'''
 +
| 大多数Mod都是在这里发布的。<br /><small>需要注册一个免费账号才能下载Mod,注册后不需要购买会员 直接点击跳过即可。你可以直接下载,也可 使用该网站 [https://www.nexusmods.com/site/mods/1?tab=files Vortex客户端](仅适用于Windows)来安装或管理Mod。</small>
 +
|-
 +
| [https://www.moddrop.com ModDrop]
 +
| 许多Mod也会在这儿发布 <br /><small>你 可以 使用该网站的ModDrop客户端 仅适用于Windows)来安装/管理/自动更新你下载的Mod。当然你也可以直接从网站上直接下载Mod,无需注册。</small>
 +
|-
 +
|class="no-wrap"|[http://community.playstarbound.com/resources/categories/stardew-valley.22/ 呵呵鱼论坛Mod版块]
 +
| 以前的一些Mod会 这里发布,但它们大多数也会同时发布在Nexus或ModDrop
 +
|-
 +
| [https://forums.stardewvalley.net/index.php?resources/ 星露谷物语官方论坛]
 +
| 有些Mod会在这里发布 但它们大多数也会同时发布在Nexus或ModDrop上。
 +
|-
 +
| [http://community.playstarbound.com/forums/mods.215/ 呵呵鱼论坛]
 +
| 以前 一些Mod会直接发布在呵呵鱼论坛里 有些很棒的Mod只能在这里找到 但找到它们可 有点困难
 +
|}
   −
  常见的MOD有 以下 两种类型
+
  在你下载Mod之前,请注意 以下 事项
* '''SMAPI模组'''使用SMAPI(一个改装API)在 游戏 中运行代码 。这 模组 功能强 而方便 。安 装SMAPI后 您可以通过将MOD放入文件夹中进行 安装 删除文件夹来卸载它们。您可以使用多个SMAPI模组,它们很少会发生冲突。理想情况下,你可以只使用SMAPI,但也有一些事情是SMAPI做不到的
+
* 检查它是否适用于最新{{version}}版本的 游戏。 如果是基于SMAPI的Mod,可以去 里查阅[[模组: 模组 兼容性|Mod兼容性]]。
* '''XNB模组''' 替换游戏的数据文件(<tt>.xnb</tt>扩展)。 比较难以管理(您需要跟踪覆盖哪些文件,并保持备份),而且您不能使用两个更改相同文件的mods。这些通常用于在游戏中改变图像,而现在SMAPI更加困难。
+
* SMAPI会自动禁用 多数不兼容的SMAPI Mod 但如果你是自己 装的XNB Mod 请在 安装 之前检查Mod的描述 注释
如果你刚开始,你应该避免使用XNB模组。这样做更容易出错,而且很难修复。但 是, 以同时使用XNB模组和SMAPI模组
+
不要从stardewvalleymods.net下载Mod( 里的Mod基本 都是 过时的 因为网站为了获得广告收入未经许 转载了这些Mod)
   −
=== 什么是SMAPI?===
+
=== 找到你的游戏文件夹===
[https://github.com/Pathoschild/SMAPI SMAPI]是一个模组API — 使用它 可以 在启动游戏 时候加载MOD,并允许MOD直接作用于游戏代码。SMAPI可以安全地与普通游戏安装 一起,并且可以随时卸载
+
下一步,你需要打开你的游戏文件夹,就是包含<tt> Stardew Valley.exe </tt>(Windows)或<tt> StardewValley.exe </tt>(Linux/Mac)的文件夹。你 可以 按下面 方法 默认路径找到
   −
===我可以在Linux、Mac、Windows、主机上使用模组吗?===
  −
以下平台支持使用MOD:
   
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
 
! 平台
 
! 平台
 +
! 路径
 +
|-
 +
| 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>
 +
|-
 +
| Android
 +
| <code>/storage/emulated/0/StardewValley/Mods</code><br />(在文件管理器中通常位于根目录的<code> StardewValley </code>文件夹里。)
 +
|-
 +
| Linux
 +
| GOG:<code>~/GOGGames/StardewValley/game</code><br />Steam:<code>~/.local/share/Steam/steamapps/common/Stardew Valley</code>
 +
|-
 +
| Mac
 +
| GOG:<code>/Applications/Stardew Valley.app/Contents/MacOS</code><br />Steam:<code>~/Library/Application Support/Steam/SteamApps/common/Stardew Valley/Contents/MacOS</code>
 +
|}
 +
 +
如果在上面的位置没有找到你的游戏,那么再试试下面的方法:
 +
{{collapse|更多方法|content=&#32;
 +
; 方法2:通过SMAPI找到它
 +
 +
:# 启动SMAPI。
 +
:# 在SMAPI的控制台中(与游戏同时打开的另一个窗口)输入这条命令:<pre>show_game_files</pre>
 +
 +
; 方法3:通过Steam找到它
 +
 +
*# 打开Steam客户端。
 +
*# 在游戏库中右键单击“Stardew Valley”。
 +
*# 点击“属性”。
 +
*# 在弹出的窗口中,点击“本地文件”的标签页。
 +
*# 点击“浏览本地文件...”按钮即可打开游戏文件夹。
 +
 +
; 方法4:通过GOG Galaxy找到它
 +
 +
:# 打开GOG Galaxy客户端。
 +
*# 在游戏侧栏中,右键单击“Stardew Valley”。
 +
*# 依次选择“Manage Installation > Show Folder”打开游戏文件夹。
 +
}}
 +
 +
===安装Mod===
 +
只需将Mod压缩包解压到[[#找到你的游戏文件夹|安装目录]]下的子文件夹<tt> Mods </tt>中,即可安装Mod。同时,你需要确保每个Mod都放在单独的子文件夹里,且没有数字后缀。例如,如果你装了一个叫做<tt> PineapplesEverywhere </tt>的Mod,你的文件结构应该是这样的:
 +
<pre>
 +
Stardew Valley/
 +
  Mods/
 +
    PineapplesEverywhere/
 +
     PineapplesEverywhere.dll
 +
     manifest.json
 +
</pre>
 +
 +
提示:
 +
<ul>
 +
<li>如果你安装了很多Mod,可以将它们放进不同的<tt> Mods </tt>子文件夹中方便管理,SMAPI会自动搜索其中的所有文件夹。例如你可以按下面的方式将两个Mod文件夹<tt> PineapplesEverywhere </tt>和<tt> ApplesNowhere </tt>放进同一个子文件夹中:
 +
<pre>
 +
Stardew Valley/
 +
  Mods/
 +
    Fruit mods/
 +
     PineapplesEverywhere/
 +
       PineapplesEverywhere.dll
 +
       manifest.json
 +
     ApplesNowhere/
 +
       ApplesNowhere.dll
 +
       manifest.json
 +
</pre></li>
 +
<li>如果你想要禁用某些Mod,只需要在文件夹最前面加上<code> . </code>即可,例如<code> .PineapplesEverywhere </code>。如果你没法儿在Windows上这样命名,在文件夹的开头和结尾同时加上<code> . </code>就行,这是一样的,例如<code> .PineapplesEverywhere. </code>。</li>
 +
<li>在解压Mod的压缩包时,建议你将它们先解压到<code> Mods </code>以外的文件夹,然后再将其中的文件复制过去。这样有助于避免多余文件导致的错误。</li>
 +
<li>如果你有一个文件夹名字像这样:<code> PineapplesEverywhere-1234567890 </code>,真正的Mod文件可能在更深一层的文件夹里,点开这种名字的文件夹仔细检查一下。这种名称的文件夹内通常还有另外几个文件夹,可能还会有使用说明。</li>
 +
</ul>
 +
 +
===配置Mod===
 +
有些Mod在文件夹里有个<tt> config.json </tt>文件,可以让你自定义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验证器]来确保格式正确。
 +
 +
===更新Mod===
 +
需要更新Mod时,直接替换对应Mod的新版本文件即可(如果有类似于<code> config.json </code>的配置文件,记得把它留着)。
 +
 +
详细步骤:
 +
# 下载新版本的Mod文件。
 +
# 查看Mod的发布页,看看是否更新了重要的安装说明。
 +
# 将Mod压缩包解压到除<code> Mods </code>文件夹以外其他位置。
 +
# 同时打开对应Mod的旧版本和新版本文件夹,你应该能分别看到其中的<code> manifest.json </code>文件。
 +
# 将新版本文件夹中的所有文件或子文件夹复制到旧版本文件夹中(替换目标中的所有文件)。
 +
 +
===移除Mod===
 +
要移除Mod,只需将其从<code> Mods </code>文件夹中删除即可。务必检查下相应Mod的发布页面,看看移除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 模组]]。
 +
 +
==常见问题==
 +
===哪些平台上可以使用Mod?===
 +
各个平台的Mod支持情况:
 +
{| class="wikitable"
 +
|-
 +
!colspan="2"| 平台
 
! Mod支持
 
! Mod支持
 
|-
 
|-
 +
|rowspan="3"| PC
 
| Linux
 
| Linux
 
| ✓ 完全支持
 
| ✓ 完全支持
第33行: 第166行:  
| ✓ 完全支持
 
| ✓ 完全支持
 
|-
 
|-
 +
|rowspan="3"| 主机
 
| Nintendo Switch
 
| Nintendo Switch
| ✖ 不支 持MOD
+
| ✖ 不支 持Mod
 
|-
 
|-
 
| PS4
 
| PS4
| ✖ 不支 持MOD
+
| ✖ 不支 持Mod
 
|-
 
|-
 
| XBox One
 
| XBox One
| ✖ 不支 持MOD
+
| ✖ 不支 持Mod
 +
|-
 +
|rowspan="2"| 手机
 +
| Android
 +
| ✓ 支持大部分Mod
 +
|-
 +
| iOS
 +
| ✖ 不支持Mod
 
|}
 
|}
   −
 自从SMAPI的兼容性的修改后,几乎所有的mod都可以在任何支 持MOD 的平台上使用。
+
 自从SMAPI的兼容性的修改后,几乎所有的mod都可以在任何支 持Mod 的平台上使用。
   −
=== 模组 会损坏我的存档吗?===
+
===Mod 会损坏我的存档吗?===
 有可能,但是非常罕见。只有几 个MOD 会影响你的存档(包括GetDressed、Makeshift多人游戏、随时存档) 。如果你不安装这 些MOD ,你的存档被损坏的可能性很低。 如果还是担心的话 只需要定时备份[[# 档| 你的存 档]]。 即使不使用MOD也强烈建议你这么做,因为通常存档损坏是由游戏本身造成的。
+
 有可能,但是非常罕见。只有几 个Mod 会影响你的存档。如果你不安装这 些Mod ,你的存档被损坏的可能性很低。 在大多数情况下 你可以[[ 存档# 到前一天| 到前一天]]。
'''注意:切勿在节日活动或MOD场景内进行保存存档后退出再进入存档,这会导致存档损坏。'''
     −
===以后 可以不 用模组吗?===
+
如果你很担心的话, 可以 定时备份[[存档|你的存档]]。即使 使用Mod 我们也强烈建议 这么做,因为通常存档损坏是由游戏本身造成 。SMAPI也会每天自动保存一次 存档 (如果你在当天运行过游戏)。 你可以 在<tt> Mods/SaveBackup </tt>文件夹内找到 它们。
当然。除了一些例外(见上一个问题) 大多MOD不直接影响 你的存档 你可以 随时停止使用 它们。
     −
=== 使用模组会影响Steam成就 吗?===
+
=== 我以后可以不用Mod 吗?===
  只要你通过Steam启动SMAPI,就可以正常取得成就 确保你已经按照[[# 安装SMAPI| 安装说明]] 来在设置Windows上的Steam(在Linux或Mac上 需要更改Steam设置)。如果能够 使 用Steam overlay,就也应该能获得成就
+
  当然 除了一些例外(见[[#Mod会损坏我的存档吗?| 上一个问题]] ),绝大多数Mod 会直接影响你的存档,所以你可以随时停止 使 用它们
   −
==使 用模组==
+
===使 用Mod会影响Steam成就吗?===
===安装SMAPI===
+
  你通过Steam启动SMAPI 就可以正常取得成就。确保你已经按照[[# 安装SMAPI| 安装 说明]] 来在设置Windows上的Steam(在Linux或Mac上不需要更改Steam设置)。如果你能够使用Steam的游戏内覆盖(默认在游戏内同时按下 {{key|Shift}}+{{key|Tab}} 键弹出覆盖),就也应该能获得成就。
  在使用大多数MOD之前,您需 安装SMAPI,MOD加载器:
+
 
有关安装 更新或删除SMAPI的帮助:
+
===联机游戏中可以使用Mod吗?===
* [[ 使用模组:在Linux上 安装SMAPI|Linux的 说明]]
+
当然,但是对你使用的Mod有要求。通常每位玩家都可以 使用 他们自己的Mod,不使用Mod 玩家也可以和 使 用Mod的玩家一起游戏。有些Mod在多人联机游戏中不生效(或是效果很差),也可能会影响其他玩家。你可以查看相应Mod 介绍页面,来知道该Mod是否支持多人游戏(通常位于“兼容性”章节中)。
* [[ 使用 模组:在Mac上安装SMAPI|Mac 说明]]
  −
* [[ 使 用模组:在Windows上安装SMAPI|Windows 说明]]
     −
===寻找模组===
+
  下面是部分类型的Mod对多 游戏 支持情况(不完全准确):
  如果你正在寻找MOD,去[http://www.nexusmods.com/stardewvalley/mods/topalltime/ 最有 网站]是个很好的选择;也可以看看 [https://www.reddit.com/r/StardewValley/comments/5u3znf/any_mods_to_install_through_my_first_playthrough/dds5897/ 第一次通关推荐MOD列表]
     −
你可以在几个地方找到MOD:
   
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
网站
+
! Mod类型
+
生效范围
 +
简要概
 +
|-
 +
| Content Patcher
 +
| class="no-wrap"| 视具体情况
 +
|
 +
{|
 +
|-
 +
! class="no-wrap"| 视觉类
 +
| 只对安装Mod的玩家生效。
 +
|-
 +
! 地图类
 +
| 只对安装Mod的玩家生效。没有安装Mod的玩家只会看到正常地图,且受到原始地图边界的限制(例如他们可能会看到其他玩家穿墙而过,但是他们自己不能这样做)。
 +
|-
 +
! 数据类
 +
| 只会直接影响安装Mod的玩家,但会间接影响到其他玩家。举个例子,如果某个[[模组:内容包|内容包]]修改了<code> Data/ObjectInformation </code>内的数据,然后你获得了一个修改过数据的物品;即使其他玩家<code> Data/ObjectInformation </code>内的数据未被修改,他们看到的也会是这项物品修改后的数值。
 +
|}
 +
|-
 +
| 地图替换类
 +
| 本地
 +
| 该类别包括了那些直接替换游戏内原始地图的Mod(没有通过SMAPI添加额外的运行逻辑)。只有安装这些Mod的玩家才能看到修改。没有安装这些地图Mod的玩家只会看到正常地图且受到原始地图边界的限制(例如他们可能会看到其他玩家穿墙而过,但是他们自己不能这样做)。
 +
|-
 +
| 自定义物品类
 +
| 所有玩家
 +
| 该类别包括了在游戏内添加新的作物、果树、可制作物品、菜谱、家具、墙纸、地板、武器、戒指、衣服和帽子的Mod。对于任何添加原游戏中不存在物品的Mod,'''所有玩家'''都需要安装它。如果某个玩家没有安装这个Mod,可能会导致游戏崩溃、产生错误物品、阻止其他玩家加入甚至损坏存档。
 +
|-
 +
| 自定义地点类
 +
| 所有玩家
 +
| 该类别包括了所有通过TMXL或其他框架,在游戏内添加新地点、新建筑的Mod。'''所有玩家'''都需要安装相同的自定义地点类Mod。如果某个玩家没有安装这个Mod,其他人进入新地点/新建筑时会导致游戏崩溃。只有房主才能建造新的建筑。
 +
|-
 +
| 自定义NPC类
 +
| 所有玩家
 +
| 该类别包括了所有向游戏内添加新的角色的Mod。'''所有玩家'''都需要安装相同的自定义NPC类Mod以避免出现意外问题。现在除房主以外的玩家,无法在节日时看到Mod新增的NPC(即将发布的一个Content Patcher版本会修复这个问题)。此外,除房主以外的玩家无法与Mod新增的NPC结婚,而房主可以与新增的NPC结婚。
 +
|-
 +
| 视觉类
 +
| 视具体情况
 +
| 该类别包括了所有在游戏内添加自定义人像、贴图、玩家皮肤或重新着色等的Mod。这类Mod的大多数只会对安装它们的玩家生效,而不会影响未安装的玩家。如果两个玩家有相同的Mod,那他们会看到一样的贴图。但如果是基于Content Patcher向游戏内添加新的初始人物皮肤(而不是替换或重新着色原来的皮肤),'''所有玩家'''都需要有'''相同数量'''的新皮肤(例如发型和上衣),否则其他玩家可能会看见贴图错误。在旧版本的SMAPI中,这可能会导致游戏崩溃。
 +
|-
 +
| 效率/作弊类
 +
| 本地
 +
| 该类别包括了所有提高玩家移动速度、简化农场工作、无限体力、生成物品等类型的Mod。其他未安装Mod的玩家会在安装Mod的玩家身上看到效果,但他们无法使用这些Mod。该类型Mod不会影响其他玩家。
 
|-
 
|-
| '''[http://nexusmods.com/stardewvalley/ Nexus Mods]'''
+
| 改变时间类
大多数MOD都是在 里发布的 <br /><small>(注册账号 免费 的,不 过不要注册时选择一个package )</small>
+
| 所有玩家
 +
该类别包括了所有暂停时间、改变游戏时间或改变时间流逝速率的Mod。只有当房主安装 类Mod时才会生效,且影响所有玩家 如果 房主以外 玩家安装这类Mod 会生效
 
|-
 
|-
| [http://community.playstarbound.com/resources/categories/stardew-valley.22/ Chucklefish mods]
+
| class="no-wrap"| 自定义游戏界面类
部分MOD发布在 (其余大多数在Nexus)
+
| 本地
 +
该类别包括了所有向游戏界面中添加新的图标、游戏提示和菜单的Mod。 类Mod仅会对安装它们的玩家生效,其他玩家不会受到影响
 
|-
 
|-
| [https://www.moddrop.com ModDrop]
+
| 修改游戏世界类
漂亮 新网站,MOD还 通过他们的客户端可以快速 装MOD(仅Windows)
+
| 所有玩家
 +
该类别包括了修改游戏内 设定的Mod:例如围栏 会损坏、改变怪物状态等。这些Mod会对所有玩家生效 不论其他玩家
 
|-
 
|-
| [http://community.playstarbound.com/forums/mods.215/ Stardew Valley 论坛]
+
其他
一些MOD直接发布在论坛。一些好东西藏在这里,但发现它们可能是一个挑战
+
视具体情况
 +
| 查看对应Mod的介绍页面或询问Mod作者以获得详细信息
 
|}
 
|}
   −
在你下载MOD之前……
+
===什么是SMAPI?===
* 它是否适 于最新版本 游戏?(SMAPI将自动禁用大多数不兼容的SMAPI MOD 如果 自己安装的XNB MOD,请 安装之前检查MOD的描述或注释。)
+
[https://github.com/Pathoschild/SMAPI SMAPI]可以视作《星露谷物语》的Mod加载器。使 时可以正常获得Steam或GOG平台 成就,它同时支持Windows/Mac/Linux和(非官方移植)Android平台 你也可以随时卸载它。 如果你在 使用过程中需 帮助,还有一个氛围很棒 [[模组:社区|社区]]欢迎你
* 不 从stardewvalleymods.net下载MOD(这里的MOD通常是过时 ,因为网站为了获得广告收入未经许可转载了这些MOD)
     −
===添加或移除模组===
+
SMAPI可以帮 做很多事情 。例如, 它可以
只需将其解压缩到[[#游戏文件夹| 的安装目录]]下的子文件夹<tt>Mods</tt>中即可安装MOD 并且确保每个MOD都放在单独的子文件夹里; 例如, 如果你装了一个叫做<tt>PineapplesEverywhere</tt>的MOD,你的文件结构应该是这样的
  −
<pre>
  −
Stardew Valley/
  −
  Mods/
  −
    PineapplesEverywhere/
  −
     PineapplesEverywhere.dll
  −
     manifest.json
  −
</pre>
     −
  要卸载MOD 只需 将其 从<tt>Mods</tt>文件夹中删除即可
+
# 启动游戏时加载Mod 并提供API接口供各个Mod调用。如果没有SMAPI,很多Mod都不能实现。
 +
# 为跨平台兼容性重写Mod,这样你才能几乎在所有平台上使用任意Mod。
 +
# 拦截错误。如果一个Mod出现崩溃或引起游戏错误,SMAPI将会拦截该错误,并在SMAPI的控制台输出错误信息。在大部分情况下,SMAPI会自动将游戏恢复正常。
 +
# 帮助检查Mod更新。如果你使用的某个Mod发布了新版本,在启动游戏时,SMAPI会在控制台中输出信息提醒你。
 +
# 检测Mod兼容性。SMAPI会自动检测出不兼容的Mod并 将其 禁用,避免其导致问题
   −
=== 配置模组===
+
=== 我的文件在哪里?===
有些MOD在 文件夹 里有个<tt>config.json</tt> 文件 。这个 文件 会在第一次使用该MOD启动游戏时创建。可以让你自定义MOD的设置
+
====游戏 文件夹====
 +
查看[[#找到你的游戏 文件 夹|入门#找到你的游戏 文件 夹]]
   −
要编辑<tt>config.json</tt>文件 不要在 游戏 运行时编辑文件,否则更改 会无法 请看[http://www.w3schools.com/js/js_json_syntax.asp JSON 基本指南];基本上确保值被引号包围(像这样 :<tt>"value"</tt>)。你可使用[https://jsonformatter.curiousconcept.com/ JSON验证器]来确保格式正确。
+
====SMAPI日志====
 +
[[File:Modding - Player Guide - Troubleshooting - SMAPI Log Parser ZH.png|thumb|SMAPI日志解析器]]
 +
SMAPI日志里的信息有助于排除故障。里面包括了你的游戏版本和SMAPI版本,装了什么Mod ,游戏的 安装位 ,发 的错误以及情况等信息
 +
下面是分享SMAPI日志 方法
 +
<ol>
 +
<li> 在这里查找日志文件:
   −
==查找游戏文件==
  −
===存档===
  −
请看''[[存档]]''页面。
  −
  −
===游戏文件夹===
  −
"游戏文件夹"就是包含<tt>Stardew Valley.exe</tt>(Windows)或<tt>StardewValley.exe</tt> (Linux/Mac)的文件夹。以下是找到它的方法:
  −
  −
<ol>
  −
<li>检查默认位置:
   
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
 
! 平台
 
! 平台
路径
+
查找方法
 
|-
 
|-
 
| Windows
 
| Windows
| GOG: <tt>C:\Program Files (x86)\GalaxyClient\Games\Stardew Valley</tt><br />Steam: <tt>C:\Program Files (x86)\Steam\steamapps\common\Stardew Valley</tt>
+
 +
# 同时在键盘上按下Windows和R。
 +
# 在弹出的“运行”窗口中输入这行内容:<code>%appdata%\StardewValley\ErrorLogs</code>,然后按下回车键会自动打开文件夹。
 +
# 日志文件的名称应该是<tt> SMAPI-crash.txt </tt> 或者<tt> SMAPI-latest.txt </tt>
 +
|-
 +
| Mac
 +
|
 +
# 打开“[https://support.apple.com/zh-cn/HT201732 访达]”应用。
 +
# 点按菜单栏中的“前往”菜单,然后选择“[https://support.apple.com/zh-cn/guide/mac-help/mchlp1236/mac 前往文件夹]”。
 +
# 输入文件夹的路径名称:<code>~/.config/StardewValley/ErrorLogs</code>,然后点按“前往”。
 +
# 日志文件的名称应该是<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>
 
|-
 
|-
 
| Linux
 
| Linux
| GOG: <tt>~/GOG Games/Stardew Valley/game</tt><br />Steam: <tt>~/.local/share/Steam/steamapps/common/Stardew Valley</tt>
+
 +
# 打开“文件”应用。
 +
# 点击“选项”菜单(也可能是“Go”或者“: ”按钮)。
 +
# 点击“输入路径”,输入这行内容:<code>~/.config/StardewValley/ErrorLogs</code>,然后按下回车键会自动打开文件夹。
 +
# 日志文件的名称应该为<tt> SMAPI-crash.txt </tt> 或者<tt> SMAPI-latest.txt </tt>
 
|-
 
|-
| Mac
+
| Android
| GOG: <tt>/Applications/Stardew Valley.app/Contents/MacOS</tt><br />Steam: <tt>~/Library/Application Support/Steam/steamapps/common/Stardew Valley/Contents/MacOS</tt>
+
|}</li>
+
# 打开文件管理器(或是打开[https://www.coolapk.com/apk/bin.mt.plus MT管理器])。
<li> 如果没有在以 位置找 游戏 试试下面 方法:
+
# 在你的手机存储中并打开找到<tt> StardewValley </tt> 文件夹。
 +
# 继续打开里面的 <tt> ErrorLogs </tt> 子文件夹。
 +
# 日志文件的名称应该为<tt> SMAPI-crash.txt </tt>或者<tt> SMAPI-latest.txt </tt>
 +
|}
 +
</li>
 +
 
 +
<li> 将其 [https://smapi.io/log/ 日志解析器]中,点击“Save & parse log" 绿色按钮 在新打开的网页中便是对日志文件的分析。右侧的图片会告诉你如何读懂SMAPI 日志。
 +
</li>
   −
* 如果你 游戏是GOG版本
+
<li>复制当前网址 链接,它应该像这样 <tt> https://smapi.io/log/一串字母和数字 </tt>。
*# 打开GOG Galaxy客户端。
  −
*# 在游戏侧栏中,右键单击''Stardew Valley''
  −
*# 选择''Manage Installation > Show Folder''打开游戏文件夹
     −
* 如果 你的 游戏是Steam版本:
+
<li>查看[[模组:帮助]]页面,前往其他社区提问并附上 刚刚复制 网址
*# 打开Steam客户端。
  −
*# 右键单击''Stardew Valley''.
  −
*# 点击''属性''.
  −
*# 点击''本地文件''标签页。
  −
*# 点击''浏览本地文件...'按钮即可打开游戏文件夹
   
</li>
 
</li>
 
</ol>
 
</ol>
   −
===SMAPI日志===
+
====存档====
SMAPI日志里的信息有助于故障排除 里面包括了你的游戏版本和SMAPI版本,装了什么MOD,游戏的安装位置,发生的错误 及情况。
+
请看[[存档]]页面
  下是 分享SMAPI日志的方法:
+
 
<ol>
+
===我可 在几组Mod之间切换吗?===
<li>在这里查找日志文件
+
  当然,SMAPI对不同的Mod组别提供支持。接 来的说明可能看起来有点复杂,但 只要你按步骤操作,其实非常简单
    
{| class="wikitable"
 
{| class="wikitable"
 
|-
 
|-
! 平台
+
! Platform
! 路径
+
! Instructions
 
|-
 
|-
 
| Windows
 
| Windows
| <tt>%appdata%\StardewValley\ErrorLogs\SMAPI-latest.txt</tt><br /><small>( 可以直接粘贴"<tt>%appdata%</tt>" 到地址栏,Windows知道它在哪里)</small>
+
| &#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>.
 +
# Create a shortcut to the <tt>StardewModdingAPI.exe</tt> file.
 +
# 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>.
 +
# Double-click that shortcut to launch SMAPI with the specified mod folder.
 +
|-
 +
|-
 +
| Windows (Steam)
 +
| &#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>.
 +
# Create a shortcut to your <tt>steam.exe</tt> file.
 +
# 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>.
 +
# 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.
 +
# Double-click that shortcut to make Steam launch SMAPI with the specified mod folder and all steam features.
 
|-
 
|-
 
| Linux
 
| Linux
| <tt>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</tt><br /><small>( 该文件夹默认隐藏。从文件点击''Go » Enter Location''并输入"~/.config".)</small>
+
| <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>Create a file like <tt>SMAPI_multiplayer.sh</tt> on your desktop.</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]]):
 +
<syntaxhighlight lang="bash">
 +
#!/bin/bash
 +
SMAPI_MODS_PATH="Mods (multiplayer)" /path/to/StardewValley
 +
</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>Double-click the script to launch SMAPI with the specified mod folder.</li>
 +
</ol>
 
|-
 
|-
 
| Mac
 
| Mac
| <tt>~/.config/StardewValley/ErrorLogs/SMAPI-latest.txt</tt><br /><small>( 该文件夹默认隐藏。从Finder,点击''Go » Go to Folder''并输入"~/.config".)</small>
+
| <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>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</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]]):
 +
<syntaxhighlight lang="bash">
 +
/path/to/StardewValley/StardewModdingAPI.bin.osx --mods-path "Mods (multiplayer)"
 +
</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>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>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>Double-click the script to launch SMAPI with the specified mod folder.</li>
 +
</ol>
 +
|-
 +
| Mac (Steam)
 +
| <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>Create a file <tt>SMAPI_multiplayer.command</tt> on your desktop.</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>):
 +
<syntaxhighlight lang="bash">
 +
/path/to/steam_osx -applaunch 413150 --mods-path "Mods(multiplayer)"
 +
</syntaxhighlight></li>
 +
<li>Example: <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>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>Double-click the script to make Steam launch SMAPI with the specified mod folder and all steam features.</li>
 +
</ol>
 +
|-
 
|}
 
|}
<small>(如果你看到的是<tt>MODDED_ProgramLog.Log_LATEST.txt</tt>文件的话,说明SMAPI的版本太旧了,请[https://github.com/Pathoschild/SMAPI/releases 升级到最新版本]。)</small>
  −
</li>
     −
<li>如果你要分享这个文件...
+
  在Windows上,[https://moddrop.com ModDrop] 这款Mod管理 也支持你设置3组Mod 以便在它们之间切换
* [https://discord.gg/kH55QXP <tt>#modding</tt> Discord频道]:只需将文件拖到channel上即可添加附件。
+
 
* 其他地方:添加附件, 或发送一个[http://pastebin.com/ pastebin] 链接。
+
<!--
* '''测试版:'''把它上传到[http://host.kvdk.net/smapi/ 日志解析 ] 并分享链接 。</li>
+
 
</ol>
+
 
 +
 
 +
 
 +
 
      −
==故障排除==
   
===修复常见的错误消息===
 
===修复常见的错误消息===
 
* ''"哎呀!SMAPI找不到游戏了。"''
 
* ''"哎呀!SMAPI找不到游戏了。"''
** 请确定你运行的是游戏文件夹里的<tt>StardewModdingAPI.exe</tt>(请看[[#安装SMAPI|安装说明]])
+
** 请确定你运> 行的是游戏文件夹里的<tt>StardewModdingAPI.exe</tt>(请看[[#安装SMAPI|安装说明]])
 
** 你是否手动安装了SMAPI(不使用<tt>install.exe</tt>)?请确保你已复制了正确的文件:Windows上是<tt>internal/Windows</tt> ,Linux/Mac上是<tt>internal/Mono</tt>
 
** 你是否手动安装了SMAPI(不使用<tt>install.exe</tt>)?请确保你已复制了正确的文件:Windows上是<tt>internal/Windows</tt> ,Linux/Mac上是<tt>internal/Mono</tt>
   第185行: 第418行:     
* ''"跳过 '...' 因为找不到manifest.json"''
 
* ''"跳过 '...' 因为找不到manifest.json"''
** SMAPI找不到 该MOD 文件夹​​中的<tt>manifest.json</tt>文件。一般来说这表示安装的不是一个SMAPI MOD ,所以放在<tt>Mods</tt>文件夹里无法生效。请参阅 该MOD 文档的安装说明。
+
** SMAPI找不到 该Mod 文件夹​​中的<tt>manifest.json</tt>文件。一般来说这表示安装的不是一个SMAPI Mod ,所以放在<tt>Mods</tt>文件夹里无法生效。请参阅 该Mod 文档的安装说明。
    
===SMAPI文件消失或杀毒软件报错===
 
===SMAPI文件消失或杀毒软件报错===
 你的杀毒软件可能会删除或报错某些SMAPI文件。这是因为''启发式检测'' -  SMAPI改 写MOD 使其在你的计算机上工作,恶意软件也会改写文件,所以杀毒软件才会报错。 SMAPI没有木马程序 - 这点你可以通过[https://github.com/Pathoschild/SMAPI 阅读代码],[https://www.jetbrains.com/decompiler/ 反编译下载]或将其上传到[https://www.virustotal.com/ VirusTotal]进行检查。你只需要告诉你的杀毒软件“SMAPI是安全的”就可以了;可以搜索杀毒名称+“添加白名单”来查找教程。
+
 你的杀毒软件可能会删除或报错某些SMAPI文件。这是因为''启发式检测'' -  SMAPI改 写Mod 使其在你的计算机上工作,恶意软件也会改写文件,所以杀毒软件才会报错。 SMAPI没有木马程序 - 这点你可以通过[https://github.com/Pathoschild/SMAPI 阅读代码],[https://www.jetbrains.com/decompiler/ 反编译下载]或将其上传到[https://www.virustotal.com/ VirusTotal]进行检查。你只需要告诉你的杀毒软件“SMAPI是安全的”就可以了;可以搜索杀毒名称+“添加白名单”来查找教程。
    
===检查版本===
 
===检查版本===
第199行: 第432行:  
; 选项 1&#58; 重置所有文件(推荐)
 
; 选项 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 不受到影响。
+
:# 参见说明:[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来修复启动器。
 
:# 如果你是在Linux / Mac上使用SMAPI,请重新安装SMAPI来修复启动器。
   第208行: 第441行:  
:# 复制一个(重置过的)<tt>Content</tt>文件夹,重命名为<tt>Content-backup</tt>。
 
:# 复制一个(重置过的)<tt>Content</tt>文件夹,重命名为<tt>Content-backup</tt>。
 
:# 把<tt>Content-modded</tt>里的内容复制到<tt>Content</tt>。
 
:# 把<tt>Content-modded</tt>里的内容复制到<tt>Content</tt>。
: 这样你的content文件夹仍然是打 了MOD 的,但是你有了原始文件的备份。
+
: 这样你的content文件夹仍然是打 了Mod 的,但是你有了原始文件的备份。
    
; 选项 3&#58; 排查XNB模组
 
; 选项 3&#58; 排查XNB模组
: 如果你安装了很多XNB模组,不确定导致该出错 的MOD 是哪一个,并且不想删除所有XNB模组,以下是找到出 错MOD 的方法。
+
: 如果你安装了很多XNB模组,不确定导致该出错 的Mod 是哪一个,并且不想删除所有XNB模组,以下是找到出 错Mod 的方法。
 
:# 备份所有想保留的XNB模组。
 
:# 备份所有想保留的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 不受到影响。
+
:# 重置游戏文件(参见说明:[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来修复启动器。
 
:# 如果你是在Linux / Mac上使用SMAPI,请重新安装SMAPI来修复启动器。
 
# 启动游戏,看看问题是否解决。
 
# 启动游戏,看看问题是否解决。
# 一个一个的安装备份 的MOD ,每安装一个就打开游戏测试,以确 保MOD 不会出问题。
+
# 一个一个的安装备份 的Mod ,每安装一个就打开游戏测试,以确 保Mod 不会出问题。
    
===SEHException: 外部组件发生异常===
 
===SEHException: 外部组件发生异常===
第239行: 第472行:  
* 重启你的电脑。
 
* 重启你的电脑。
 
* 在打开游戏前关闭浏览器和其他程序。(可以在游戏开始后重新打开它们)
 
* 在打开游戏前关闭浏览器和其他程序。(可以在游戏开始后重新打开它们)
* 删除任何更改游戏音频 的MOD (例如添加更多音乐 的MOD )。
+
* 删除任何更改游戏音频 的Mod (例如添加更多音乐 的Mod )。
    
===其他问题===
 
===其他问题===
第249行: 第482行:  
==寻求帮助==
 
==寻求帮助==
 
===寻找帮助===
 
===寻找帮助===
 关 于MOD 的问题,直接 问MOD 作者是最好的方式。以下是与他们取得联系的最佳方式:
+
 关 于Mod 的问题,直接 问Mod 作者是最好的方式。以下是与他们取得联系的最佳方式:
   −
在MOD 页面上的讨论贴链接(如果有的话);
+
在Mod 页面上的讨论贴链接(如果有的话);
# Nexus MOD 页面上的“BUG”页面(如果有的话);
+
# Nexus Mod 页面上的“BUG”页面(如果有的话);
# 也可以直接与作者联系(例如使用Nexus MOD 页面上的“Contact”按钮)。
+
# 也可以直接与作者联系(例如使用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上询问。]
+
 如果是关于SMAPI的问题,或者你无法联系 上Mod 的作者,[http://community.playstarbound.com/threads/dos-and-donts-of-reporting-issues-with-smapi-mods.125211/ 请到这里跟帖]或[https://discord.gg/kH55QXP 在Discord上询问。]
    
===在上报错误时需要包含的内容===
 
===在上报错误时需要包含的内容===
第267行: 第500行:  
#* 当游戏出错时你在做什么?你有发现什么固定规律吗?例如,当你做某件事情时总是会发生崩溃。
 
#* 当游戏出错时你在做什么?你有发现什么固定规律吗?例如,当你做某件事情时总是会发生崩溃。
 
# 描述你的使用环境:
 
# 描述你的使用环境:
#* 你是否使 用MOD 管理软件?如果有,写出软件名字。
+
#* 你是否使 用Mod 管理软件?如果有,写出软件名字。
 
#* 你在Linux,Mac还是Windows上玩?
 
#* 你在Linux,Mac还是Windows上玩?
 
# 重现这个游戏错误(这样在日志中会记载详细信息),然后把最新日志文件的复制粘贴上去(请看上一部分)。
 
# 重现这个游戏错误(这样在日志中会记载详细信息),然后把最新日志文件的复制粘贴上去(请看上一部分)。
 
+
-->
 
{{Modding guide footer
 
{{Modding guide footer
   |prev = 
+
   |prev =
 
   |next = [[../疑难解答|疑难解答]]
 
   |next = [[../疑难解答|疑难解答]]
 
}}
 
}}
1,078

个编辑