告别复杂操作：SMAPI模组加载器超简单入门指南

准备阶段：让我们开始这段旅程

欢迎来到SMAPI的世界！SMAPI就像是《星露谷物语》的魔法钥匙，能帮你打开各种有趣模组的大门。在开始之前，请确保你的电脑上已经安装了《星露谷物语》游戏。接下来，让我们用3分钟时间准备好所有需要的东西。

第一步：获取SMAPI源代码

我们需要先把SMAPI的代码下载到你的电脑上。这就像是买家具前先把零件搬回家一样，有了零件才能组装出漂亮的家具。

1. 打开你的终端（Windows用户可以用命令提示符或PowerShell，Mac和Linux用户用终端）
2. 输入以下命令并按回车：

git clone https://gitcode.com/gh_mirrors/smap/SMAPI

3. 等待下载完成，这可能需要几分钟时间，具体取决于你的网络速度

第二步：找到安装文件

下载完成后，我们需要找到安装程序。就像买了新玩具需要找到说明书一样，安装程序会告诉我们接下来该怎么做。

1. 打开文件管理器，找到你刚才下载的SMAPI文件夹
2. 依次进入这些文件夹：src → SMAPI.Installer → assets
3. 在这个文件夹里，你会看到几个不同名称的安装文件，根据你的操作系统选择对应的文件

安装阶段：让SMAPI在你的电脑安家

现在到了最关键的安装步骤！别担心，这个过程就像安装普通软件一样简单，只需要点击几下鼠标。

Windows系统安装（预计5分钟）

1. 双击"install on Windows.bat"文件
2. 一个黑色的命令窗口会弹出来，这是正常现象
3. 按照窗口中的提示操作，通常只需要按几次回车键
4. 等待安装完成，窗口会自动关闭

Mac系统安装（预计5分钟）

1. 打开终端，输入以下命令并按回车：

cd src/SMAPI.Installer/assets
chmod +x "install on macOS.command"
./install on macOS.command

2. 系统可能会询问你是否允许运行这个程序，点击"允许"
3. 按照终端中的提示完成安装

Linux系统安装（预计5分钟）

1. 打开终端，输入以下命令并按回车：

cd src/SMAPI.Installer/assets  
chmod +x "install on Linux.sh"
./install on Linux.sh

2. 按照终端中的提示操作，可能需要输入你的密码
3. 等待安装完成

⚠️ 注意：安装过程中请确保《星露谷物语》游戏是关闭的，否则可能会导致安装失败。

验证安装：确认SMAPI是否正确工作

安装完成后，我们需要检查一下SMAPI是否已经正确安装。这就像组装好家具后要摇一摇看看是否稳固一样。

启动SMAPI

1. 找到你的《星露谷物语》游戏文件夹
2. 双击"StardewModdingAPI.exe"文件（Windows）或相应的启动文件（Mac/Linux）
3. 游戏会启动，你会在启动界面看到SMAPI的版本信息

检查关键文件

安装成功后，游戏文件夹中会出现这些重要文件和文件夹：

• StardewModdingAPI.exe：SMAPI的启动程序
• Mods文件夹：以后所有的模组都要放在这里
• smapi-internal文件夹：SMAPI的核心文件和配置

如果你能看到这些文件，恭喜你！SMAPI已经成功安装了！

模组管理：让游戏变得更有趣

现在我们可以开始安装模组了！模组就像是给游戏添加新功能的魔法道具，能让你的星露谷体验变得与众不同。

安装第一个模组（预计10分钟）

1. 从可靠的网站下载你喜欢的模组（通常是.zip格式的压缩包）
2. 解压下载的文件，你会得到一个包含"manifest.json"文件的文件夹
3. 打开《星露谷物语》游戏文件夹中的"Mods"文件夹
4. 将整个模组文件夹复制到"Mods"文件夹中
5. 启动SMAPI，模组会自动加载

💡 为什么需要manifest.json文件？

这个文件就像是模组的身份证，里面记录了模组的名称、版本、作者和依赖信息。SMAPI通过这个文件来了解如何正确加载模组。

模组文件夹长什么样？

一个标准的模组文件夹应该包含这些文件：

模组名称/
├── manifest.json    # 模组的"身份证"，必需文件
├── ModEntry.cs      # 模组的主要代码文件
├── assets/          # 存放图片、声音等资源
├── config.json      # 模组的设置文件（可选）
└── README.md        # 模组的使用说明（可选）

管理模组状态的小技巧

有时候你可能想暂时停用某个模组，或者彻底删除它。这里有一些简单的方法：

• 临时禁用：在模组文件夹名称前加一个下划线"_"，比如"_模组名称"
• 完全删除：直接将模组文件夹拖到回收站
• 更新模组：删除旧版本文件夹，放入新版本文件夹

避坑指南：常见问题解决方法

即使是最厉害的魔法师也会遇到问题，别担心，这里有一些解决常见问题的方法。

游戏无法启动怎么办？

如果SMAPI无法启动，试试这些步骤：

1. 检查路径：确保SMAPI安装在游戏根目录，而不是子文件夹里
2. 测试冲突：将"Mods"文件夹重命名为"Mods-old"，然后尝试启动游戏。如果能启动，说明某个模组有问题
3. 检查版本：确保你的SMAPI版本与游戏版本相匹配

模组冲突了怎么解决？

当多个模组一起使用时，有时会出现冲突。别着急，按照这些步骤排查：

1. 启动SMAPI，查看控制台中的错误信息（通常是红色文字）
2. 根据错误提示找到可能有问题的模组
3. 使用"二分法"排查：先禁用一半模组，测试哪一半有问题，逐步缩小范围
4. 查看模组的说明文档，了解已知的兼容性问题

游戏运行卡顿怎么办？

如果游戏变得卡顿，可以尝试这些优化方法：

1. 精简模组：禁用不常用的模组，特别是大型地图和高清纹理模组
2. 调整设置：在模组的config.json文件中降低画质或特效设置
3. 定期清理：删除Mods文件夹中不再使用的模组

高手技巧：让SMAPI更好用

现在你已经掌握了基础知识，让我们来学习一些高级技巧，让你的SMAPI使用体验更上一层楼！

自定义SMAPI配置

SMAPI的配置文件位于"smapi-internal/config.json"，通过修改这个文件，你可以定制SMAPI的行为：

调整日志详细程度：

"consoleLogLevel": "Info"  // 可以改为Trace(最详细)、Debug、Warn、Error或Fatal(最少)

设置存档备份数量：

"saveBackupCount": 10  // 自动保留最近10个存档备份

💡 修改配置后需要重启SMAPI才能生效，建议修改前先备份原配置文件。

精选模组推荐

这里有一些非常受欢迎的模组，可以根据你的兴趣尝试：

游戏增强类

• Stardew Valley Expanded：添加新地图、角色和剧情
• Quality of Life Mods：提供自动浇水、快速收获等便利功能

视觉美化类

• Seasonal Villager Outfits：让村民根据季节更换服装
• Elle's Flower Grass and Weeds：美化游戏环境纹理

功能扩展类

• Json Assets：允许添加自定义物品、作物和工具
• Farm Type Manager：支持创建自定义农场类型

资源速查：SMAPI常用文件和文档

资源类型	路径	用途
技术文档	docs/technical/smapi.md	详细了解SMAPI的核心功能
模组开发指南	docs/technical/mod-package.md	学习如何创建自己的模组
发布说明	docs/release-notes.md	了解SMAPI的版本更新内容
配置文件	smapi-internal/config.json	调整SMAPI的各种设置

总结：开始你的星露谷模组之旅

恭喜你！现在你已经掌握了SMAPI的基本使用方法。记住，模组的选择和组合是非常个人化的，大胆尝试不同的模组，打造属于你的独特星露谷世界吧！

随着使用经验的积累，你可能还会想要尝试创建自己的模组，为星露谷社区贡献创意。无论如何，希望SMAPI能让你的星露谷体验更加丰富多彩！

如果你在使用过程中遇到问题，不要忘记查阅官方文档或寻求社区帮助。游戏愉快！