SMAPI作为最基础的Mod运行工具，也是吧友最常提出问题的主题之一。
其实SMAPI的安装教程以前莉娜就有发过。但是由于去年11月游戏和SMAPI的一次更新后，安装的方法出现了些许不同。加之，大部分Mod作者未能及时更新，导致很多人找不到适用的Mod版本。频繁在吧内发伸手贴并不是长久之计，所以我想单独开贴，把从SMAPI的安装方法、如何处理SMAPI红字，到如何查找安装可用Mod等一系列问题写在一个帖子里方便吧友查找。
请不要再发帖问“xxx Mod我找不到，求各位大佬给个度盘 嘤嘤嘤”“我学不会看不懂”之类的帖子，休怪我顺着网线爬过去找你（核善的笑容

2楼备用

3楼目录

4楼 链接楼
莉娜的SMAPI安装教程：https://tieba.baidu.com/p/5702079944
莉娜的教程大全：https://tieba.baidu.com/p/5812479151
N网帮注册：时光的https://tieba.baidu.com/p/5984201925， 莉娜 https://tieba.baidu.com/p/5859605500
星海的如何复制SMAPI上的文字：https://tieba.baidu.com/p/5965562987

I. SMAPI安装（续）
4. 打开安装包文件夹，进行安装
如图。以前的教程说明需要点击install.exe。
现在的安装方法是
直接双击你的系统对应的文件，例如window用户双击installon Windows.bat批处理文件（不需要到internal文件夹内）。
正常情况下会跳出一个如下图的窗口（如果显示为“无法找到游戏目录”，则需要手动将游戏目录复制粘贴到控制台内，按下回车，再继续以下步骤）
输入1，按下回车，如下图所示就是安装成功了。
5. 设置启动项
接上图，如果想要从Steam直接启动SMAPI，可复制绿字第二行的内容，打开Steam，右键点击星露谷>属性>设置启动项，粘贴刚刚复制的内容，粘贴，点击确定。
如果没有复制绿字也没有关系。打开游戏目录，复制游戏路径，按照下图的示例输入到启动项（前半部分的游戏路径以自己的为准）：
如果不想要设置启动项，那么就从游戏目录内双击StardewModdingAPI.exe直接启动SMAPI。
6. 卸载SMAPI
打开安装包，打开安装程序，输入2，按回车就完成了卸载。

II. 如何看懂SMAPI的文字
1.
查看版本、平台
我们平时在吧内回答问题时经常会用到这个方法来判断吧友的问题，通常在SMAPI控制台的标题栏和控制台内显示文字的前几行能看到这些信息。如图：
标题栏和控制台第一行：SMAPI为2.7版本，游戏本体版本为1.3.33
第二行：由Mod路径看出平台为Steam
由此可判断这个SMAPI需要更新至正式版的最新版本。
Wegame平台的也会显示相应的版本：游戏1.3.28对应SMAPI 2.7。
1.
红字
红字提示有多种不同的情况，先从简单的开始
i)
Oops!Steam achievements won’t work
这只是提示你“你的steam平台没有开启，你游戏中的成就不会计算到平台成就内“。对SMAPI和游戏运行没有其他影响。如果不想看到这红字，只要打开Steam就可以。
ii)
[SMAPI] The gamefailed unexpectlly:
版本不对应，需要更新SMAPI至正式版的最新版本。
iii)
[mod名] because it’s nolonger compatible
Mod版本不匹配SMAPI版本。如何更新稍后会讲解。
iv)
[mod名] because it requires mods which aren’t installed [前置mod名]
解决: 安装所需前置mod。
v)
The game crashed last time you played…Press any key to delete the crash data and continueplaying
意为上次游戏意外崩溃。如果没有其他问题，按任意键继续。这种情况通常为上次运行时有mod导致游戏崩溃。如果这种情况重复出现，你需要测试排查出导致崩溃的mod删除。
vi) 一些相对较少见的红字提示（没找到图，凑合看吧）：
[mod名]and [mod名] mod are conflict, none of these mod will be loaded(差不多这个意思，原文我记不太清)：某两个或更多mod的功能作用在同一文件上，因此两个mod都无法运行。解决方式是删除掉冲突的mod就行。
[mod名] containsfiles, but none of them are manifest：提示文件夹内没有manifest 文件。这样的情况有很多种：这是替换mod；不是mod文件（删掉就行）。
vii) 最令人窒息的：大片红字
通常出现在mod加载成功，但游戏运行过程中出现错误（比如严重卡顿；无法进入或打开某些东西）。形成原因有很多种，比如mod本身存在的bug，或是不同mod的一部分内容同时覆盖了一个游戏文件部分等等原因。
解决方法：如果不影响到游戏体验，不造成游戏闪退或卡顿，可暂时忽略。如果游戏因此崩溃或卡顿，则需要排查删除造成这原因的mod。等待作者更新修复。

II. 如何看懂SMAPI的文字（续）
3.
灰字和黄字
一些关于mod的小问题或提示，但不影响mod运行。基本可忽略不计。（以前教程中的黄字提示“可能造成崩溃的mod”现在显示为灰字）
4.
紫字
提示可更新的mod，后面的网址就是新版本的下载地址。
Wegame玩家会经常看到此提示，但由于wegame版本依然是1.3.28，更新了反而会用不了，因此只要mod没有提示无法运行，就不需要更新。
如何更新mod稍后做讲解。

III. Mod篇
1.
在哪里找Mod？
i) 【推荐】Nexus Mod（简称N网）：英文Mod网站，聚集了星露谷绝大多数Mod。注册需要一些翻。。的操作。注册或需要帮注册请看4L的链接。很多人看不懂英文，也可参考4L链接：莉娜的教程大全，里面有此网页的部分翻译。也可借助浏览器的自带翻译功能。
Description=Mod说明页；Files=Mod文件；下载点击Manual Download
ii) ChuckleFish Forum（呵呵鱼论坛）：呵呵鱼英文论坛。这个网站相对来说比较难直接找到想要的Mod（一眼望去基本都是英文，图片很少显示或很小）。但是这个网站包含很多非官方更新的Mod，所以这个网站也是必备之一。注册同样需要特别方法，但可使用时光帮注册贴里的共享账号。
iii) 当然，吧内Mod精品区也有很多原创或汉化的Mod。可参考吧内的Mod导航贴：tieba.baidu.com/p/5860958910
iv) 不要因为上面网站是英文看不懂而去3。dm等网站下载Mod。原因：大部分是未经作者授权的Mod；说明不清；更新滞后，不一定契合版本；安全性未知等等。

III. Mod篇（续）
2. 如何找到可用的Mod
i) 通用替换类mod
替换类mod大多数是一直都可用的。少数如家具，制造物品之类的替换文件需要注意发布时间(Dateuploaded)和更新时间(Last update)，如果太过久远的可能会造成壁炉盆栽消失等问题。
以下为通过SMAPI运行的Mod的查找方法。
ii) Steam
游戏版本和SMAPI版本保持最新。SMAPI有紫字提示更新可根据其提供的网址下载。
最方便查找Mod是否可用的方法：mods.smapi.io
看到如图的一个网页，在search搜索栏输入你要找的mod，就能看到mod的可用状况：绿色=最新版可用；红色=不可用；黄色=有替代mod或使用非官方更新（点击链接）。
举例：已知get dressed梳妆台mod不可用，用kisekae代替。搜索kisekae，点击后面对应的unofficial update链接下载安装。
又比如你想找一个可用的钓鱼mod，那么搜索fish就能显示很多钓鱼相关的mod，直接点链接。

III. Mod篇 （续2）
2. 如何找到可用的Mod
iii) Wegame：
最新版本的mod也许无法使用！
Wegame的版本1.3.28，对应SMAPI版本2.7。上面方法找到的最新的mod显然是不一定能用的。那么Wegame玩家要怎么找mod呢？
第一步：打开N网，前往你想要的Mod页面。这里以Content Patcher为例，点击Files（文件），下拉到Old files(旧文件)
第二步：将Old files右侧的浏览设置为如图所示（上传时间倒序显示）
第三步：1.3.28版本的mod的发布时间通常在8月之后（也有个别在6、7月发布），11月20日之前，所以集中在这个时间段内发布的文件里。点开查看下面的说明是否为
SMAPI2.6(或2.7) compatible，或是SDV 1.3.28compatible。
如下图，找到了Wegame可用的版本为1.4。
注意：1).有的需要前置才能运行的mod（比如需要content patcher才能运行的mod）可能更早时间发布，但只要前置是可用的版本，这些mod也能正常运行。
2).有少数mod在很早之前作者就不再更新了。可找替代的mod旧版本使用。例外比如Json Asset这种前置mod旧版本在N网旧版也不可用，也无法替代。这种可到提问贴寻求帮助。
3). 有的mod可能没有及时随steam的版本更新。Mainfiles里面也有可能找到可用的版本，随机应变。

III. Mod篇（续3）
3. Mod的基本分类和安装
概括：Mod安装方法通常在下载地址的介绍(Description)里都有详细的说明。以下内容都是概括通用的安装方式。有的Mod需要具体的方法操作来设置你的喜好。所以安装Mod前请仔细阅读作者给出的安装说明。
i) 替换类
不包含manifest.json文件；文件格式均为xnb的mod统称为替换类mod。
安装方法：先将游戏目录里的Content文件夹整个复制粘贴到其他地方以备份。将xnb文件替换到相应的位置（见下）。有的作者比较贴心的将替换文件放在了Content以及各个子文件夹内，这样的可直接替换到游戏目录中即可。
非替换类的Mod都需要SMAPI运行。以下教程均为SMAPI运行的Mod。
ii) 前置Mod
作为一些Mod运行的环境或者叫框架。本身也是作为Mod的存在。
安装方法：下载，解压到游戏目录中的Mods文件夹内。
个人建议可以将所有的前置都安装上（并且Steam保持更新）。如此，下载其他Mod时只要都解压到Mods文件夹内就可以。
常见前置Mod：Content Patcher,PyTk, SpaceCore, Portraiture, MailFrameWork, Custom Farming Redux, TMXLoader,JsonAsset等等。
iii) 需要前置的Mod（叫后置Mod好了）
很多Mod需要先安装前置Mod才能正常运行，比如美化、作物扩展等等。作者也会在说明中表面所需的前置。N网的Description（说明）页面，点击Requirements就能看到所需的前置。
例如下图所示需要ContentPatcher作为前置。
后置Mod的安装方法：下载，同样解压到Mods文件夹内。除非作者特别说明，否则不要将一个Mod放到另一个Mod里面！
iv) 功能类Mod
例如生日Mod，作弊菜单，梳妆台Kisekae等等不需要前置的Mod，都统称为功能Mod。
安装方法很简单，解压到游戏目录里的Mods文件夹里就可以。
v) 更新Mod
当SMAPI提示红字或黄字（见上SMAPI文字讲解）时，安装Mod查找部分的方法找到适用的Mod，替换原来的旧版Mod。
部分Mod带有你的存档信息，比如梳妆台、生日Mod等，直接用新版的粘贴，点击替换文件就完成了更新。
部分Mod需要彻底删除旧版的再安装新版，比如染年汉化的扩展类Mod。

给全体吧务比心

小贴士：
1. Steam玩家可以建立几个文件夹来分类整理Mod，比如这样。Wegame不能因为2.7的SMAPI无法读取多层的文件夹。
2. N网登陆如果显示一个小齿轮一直转，不显示Log in按键，换个浏览器可解决。
3. 更新SMAPI后，启动时一直显示控制台正在读取Mod文件，但是一直没有反应。关机重启可解决。

=====以上为全部教程=====
部分内容来自星海，莉娜编辑的内容。感谢！