今日新增两款游戏支持：《星露谷物语》与《博德之门3》
2026年10月15日 · 游戏支持公告
今天模组加加一次上线两款游戏的支持。这两款的模组机制差别很大，但有个共同点：过去最容易出错的那一步，现在都由管理器自动完成——《星露谷物语》麻烦在"必须先装 SMAPI 前置"，《博德之门3》麻烦在"得让游戏认得这个模组"。下面分别说明。
一、《星露谷物语》：SMAPI 前置 + 模组一键安装
《星露谷物语》的模组生态建立在 SMAPI 之上——所有模组都要经过 SMAPI 才能被游戏加载。以前装过一次 SMAPI、再手动把模组解压到 Mods 文件夹，是这套流程里最费事的两步。现在这两步都在管理器里一键完成。
本次新增
- SMAPI 前置一键安装：自动识别 SMAPI 官方安装包（包内的
install.dat），静默调用 SMAPI 官方安装器，效果与官方安装器完全一致——写入 SMAPI 本体文件、生成StardewModdingAPI.deps.json、连带安装官方捆绑的两个模组（Console Commands、Save Backups），并且保留你在游戏里改过的 SMAPI 设置（smapi-internal\config.user.json会被备份再还原）。 - SMAPI 模组 / Content Patcher 内容包一键安装：自动识别模组包里的
manifest.json，把每个模组作为独立文件夹装到游戏目录\Mods\<模组名>\，包内的目录结构（assets\、i18n\等）原样保留。 - 一个压缩包里装了多个模组也能正确安装：包里有几个模组就装几个，各归各的文件夹，不会串目录。
- 前置和模组混在同一个包里也没问题：会先装 SMAPI、再装模组，一个都不会漏。
- 一键卸载：SMAPI 与模组的安装记录统一交给管理器，卸载时把 SMAPI 本体、
smapi-internal\、捆绑模组以及你装过的模组目录一并清理干净。
怎么用
- 在「全部游戏」里搜索「星露谷物语」并设为主游戏，游戏目录指向真正的游戏安装目录（该目录下应当有
Stardew Valley.dll，SMAPI 安装器需要它做校验）。 - 先装 SMAPI：从模组仓库下载 SMAPI 安装包，用管理器直接安装。（安装期间会短暂出现一个黑色命令行窗口，那是 SMAPI 官方安装器在运行，属正常现象，不要关掉它。）
- 再装你要的模组——Automate、Content Patcher、Generic Mod Config Menu、NPC Map Locations、Visible Fish…… 装完启动游戏即可。
注意（第一条最容易踩）
- 装完 SMAPI 后，请用游戏目录里的
StardewModdingAPI.exe启动游戏（或在 Steam 里设置启动选项）。SMAPI 的官方安装器不会改名游戏本体的Stardew Valley.exe，所以直接点 Steam 的「开始游戏」进的还是原版——看起来像"模组没生效"，其实是压根没走 SMAPI。 - 卸载请通过管理器卸载，不要手动删
Mods里的文件夹，否则管理器的安装记录会对不上。 - 目前暂不支持没有
manifest.json的老式 XNB 替换包（1.3 时代的内容替换模组）。这类包会明确提示「未找到可安装文件」，不会乱铺到游戏目录里。
支持范围速查
| 模组类型 | 支持情况 |
|---|---|
| SMAPI 官方安装器包（前置） | ✅ 一键静默安装（走官方安装器） |
SMAPI 模组 / Content Patcher 内容包（含 manifest.json） |
✅ 装到 Mods\<模组名>\ |
| 一个包内含多个模组 | ✅ 各自独立安装 |
| 前置 + 模组混装在一个包 | ✅ 先装前置再装模组 |
老式 XNB 内容替换包（无 manifest.json） |
⛔ 暂不支持，会明确提示 |
二、《博德之门3》：.pak 一键安装 + 自动启用
《博德之门3》装模组，麻烦的从来不是复制文件，而是让游戏认得这个模组：每个 .pak 都要在 modsettings.lsx 里登记一条记录，游戏才会加载它。漏登记、或者手动删了 pak 留下一条读不出 UUID 的孤儿条目，都是这套流程里最容易出问题的地方。现在这一步由管理器自动完成。
本次新增
.pak模组一键安装：自动装到游戏目录\Mods\，并自动写入modsettings.lsx——也就是装完即启用，不用再去游戏里的模组管理界面手动勾选。- 自动读取模组信息：优先读取模组包内的
info.json（官方 mod 包格式），没有则直接解析.pak内部的meta.lsx（含 LSPK v18 容器格式解析与 LZ4 解压），取出UUID / Folder / Name / Version。 - Script Extender 类模组：会按包内结构自动铺到
游戏目录\bin\；如果检测到模组依赖 Script Extender、而你的bin目录下还没有DWrite.dll，会明确提示你先安装 BG3SE（博德之门3 脚本扩展器）。 - 一键卸载不留垃圾：卸载时会先从
modsettings.lsx摘掉对应条目、再删除.pak文件。这个顺序很关键——pak 一删就再也读不出 UUID，modsettings.lsx里会留下一条永远清不掉的孤儿条目。同时支持文件备份回滚。
怎么用
- 在「全部游戏」里搜索「博德之门3」并设为主游戏，游戏目录指向游戏的安装目录。
- 用管理器下载并安装
.pak模组——装完直接启动游戏即可，模组已经自动启用。 - 依赖前置的模组（脚本类、需要 Script Extender 的），按管理器提示先把前置装好再装模组。
注意
- 卸载请走管理器卸载，不要手动删除
Mods目录里的.pak：手动删会让modsettings.lsx里留下无法清理的孤儿条目，游戏侧还可能报错。 modsettings.lsx在%LocalAppData%\Larian Studios\Baldur's Gate 3\PlayerProfiles\Public\下。装模组前建议自己先备份一份；一旦出问题，用管理器卸载对应模组即可把条目和文件一起撤掉。
支持范围速查
| 模组类型 | 支持情况 |
|---|---|
.pak 模组（含 info.json 的官方 mod 包） |
✅ 装到 Mods\ + 自动写 modsettings.lsx |
.pak 模组（只有内部 meta.lsx） |
✅ 解析 LSPK v18 取出 UUID 等信息后登记 |
| Script Extender 类模组 | ✅ 按结构铺到 bin\，缺 BG3SE 会提示 |
| 卸载 | ✅ 先摘 modsettings.lsx 条目再删文件，支持备份回滚 |
两款游戏的支持都随客户端更新生效，把客户端更新到最新版即可使用。