SMAPI星露谷物语模组探索指南：从入门到精通

想让星露谷的农场焕然一新？想给角色换上酷炫服装？SMAPI（星露谷物语模组加载器）就是你的魔法钥匙！这份零基础教程将带你从模组安装到高级配置，轻松掌握星露谷物语模组安装与SMAPI使用技巧，让你的农场秒变个性化乐园。

🌱入门：搭建你的模组世界

新手必看：SMAPI环境搭建三步曲

1️⃣ 获取核心代码
打开终端，输入以下命令克隆项目（确保网络稳定，文件大小约200MB）：

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

2️⃣ 系统适配安装
根据你的操作系统选择对应脚本：

• Windows：进入 src/SMAPI.Installer/assets 双击 install on Windows.bat
• macOS：终端执行

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

• Linux：终端执行

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

⚠️ 安装警告：务必关闭星露谷游戏再执行安装，否则可能导致文件复制失败！

3️⃣ 验证安装成果
成功后游戏目录会出现这些关键文件：

• StardewModdingAPI.exe：SMAPI启动器
• Mods/：存放模组的专属文件夹
• smapi-internal/：配置与日志中心

双击启动器，若界面显示SMAPI版本号，恭喜你已踏入模组世界！

🌿进阶：打造专属模组库

模组安装黄金流程

📌 重点步骤：
1️⃣ 从可靠网站下载模组压缩包（认准.zip格式）
2️⃣ 解压得到含 manifest.json 的文件夹（这是模组的"身份证"）
3️⃣ 复制整个文件夹到 Mods 目录
4️⃣ 启动SMAPI自动加载

💡 小技巧：安装前先看模组的README.md，能避免90%的兼容性问题！

模组文件夹解密

标准模组结构长这样：

我的模组/
├─ manifest.json  🔑 必需！包含模组名称、版本和依赖信息
├─ ModEntry.cs    🧠 代码核心文件（C#模组）
├─ assets/        🎨 存放图片、音频等资源
├─ config.json    ⚙️ 可自定义的设置项
└─ README.md      📖 使用说明文档

灵活管理模组状态

• 临时禁用：文件夹名前加 _（如 _我的模组）
• 彻底删除：直接删除模组文件夹
• 版本更新：删除旧版文件夹，放入新版

🌳精通：模组玩家的进阶之路

避坑指南：新手常犯的4个错误

❌ 错误操作	✅ 正确做法	🚫 后果
直接放.zip到Mods文件夹	必须解压后放入	模组无法加载，游戏崩溃
安装多个同类功能模组	只保留最需要的一个	功能冲突，村民可能"精神分裂"
忽略依赖要求	先安装所有必备模组	模组报错，功能缺失
手动修改模组文件	通过config.json调整	存档损坏，无法恢复

配置文件深度定制

修改 smapi-internal/config.json 提升体验：

{
  "consoleLogLevel": "Warn",  // 日志级别：Warn只显示警告和错误
  "saveBackupCount": 15       // 自动备份15个存档，安全感拉满
}

💡 修改技巧：改前先备份原文件，重启SMAPI生效

模组组合推荐

休闲玩家套餐：

• Automate 自动浇水收获 + Chest Exporter 物品分类
• Seasonal Villager Outfits 村民四季换装 + Elle's Trees 美化树木

冒险玩家套餐：

• Stardew Valley Expanded 扩展地图剧情 + Combat Overhaul 战斗系统强化

官方资源速查

• 技术文档：docs/technical/smapi.md
• 模组开发指南：docs/technical/mod-package.md
• 版本更新日志：docs/release-notes.md

现在就启动SMAPI，开始你的个性化星露谷之旅吧！记住，最好的模组组合是能让你玩得开心的组合——大胆尝试，创造属于你的独特农场故事！