Mod 添加与管理
MintCat 的核心工作流是：把 Mod 添加到当前 Profile，按分组整理，选择启用状态和版本，然后保存整合到游戏目录。
支持的 Mod 来源
| 来源 | 说明 | 常见用途 |
|---|---|---|
| Local | 本地 .pak / .zip 文件 | 手动下载的 Mod、私有 Mod、测试包 |
| Online | 在线链接 | 从分享链接或网页链接导入 |
| mod.io Subscribed | mod.io 订阅列表 | 批量同步已订阅 Mod |
| Search Page | 搜索页添加 | 从 mod.io / ModCat 等来源搜索后添加 |
添加本地 Mod
- 进入首页。
- 点击
添加 Mod。 - 切换到
Local标签页。 - 选择本地 Mod 文件。
- 选择目标分组。
- 点击
OK。
建议：
- 优先保留原始 Mod 文件，不要在添加后立即删除。
- 如果跨电脑迁移配置，本地路径可能失效，需要重新选择文件。
- 本地文件丢失时，MintCat 会在后续检查或加载时提示。
通过在线链接添加
- 进入首页。
- 点击
添加 Mod。 - 切换到
Online标签页。 - 每行粘贴一个链接。
- 选择目标分组并确认。
适合场景：
- 别人分享了一组 Mod 链接。
- 从网页复制 mod.io / ModCat 链接。
- 需要一次导入多个在线 Mod。
从 mod.io 订阅添加
使用前需要先配置 mod.io OAuth。
- 点击右上角头像，打开用户设置。
- 填写
mod.io OAuth。 - 回到首页，点击
添加 Mod。 - 切换到
mod.io Subscribed标签页。 - 加载订阅列表，勾选需要导入的 Mod。
- 选择目标分组并确认。
如果列表为空：
- 确认 OAuth 是否正确。
- 确认网页端 mod.io 已订阅对应 Mod。
- 重启应用或刷新后重试。
从搜索页添加
- 打开侧边栏搜索页。
- 选择搜索来源。
- 输入关键词或直接浏览初始列表。
- 点击目标 Mod 的
Add。 - 在添加窗口确认目标分组。
搜索页会根据当前游戏过滤可用来源。例如 DRG 通常支持 mod.io 与 ModCat，Rogue Core 通常优先使用 ModCat。
启用与禁用
首页列表中的每个 Mod 都可以单独启用或禁用。
- 启用：保存时会参与整合。
- 禁用：保留在 Profile 中，但不会安装到游戏目录。
适合把常用但暂时不用的 Mod 留在配置里，避免重复添加。
批量启停
当需要一次性开关大量 Mod 时，可以使用批量启停能力。
建议用法：
- 排查冲突时，先批量禁用，再逐步启用。
- 为不同玩法切换一组 Mod。
- 临时关闭所有非必要 Mod。
修改显示名称
MintCat 支持修改 Mod 在本地列表中的显示名称。
- 只影响本地展示。
- 不会修改线上 Mod 名称。
- 适合给功能相似的 Mod 加备注。
版本选择
如果 Mod 有多个可用版本，首页可选择当前 Profile 使用的版本。
建议：
- 通常使用最新版本。
- 如果新版本出现兼容问题，可以回退到旧版本。
- 切换版本后需要重新保存整合。
删除 Mod
从当前 Profile 删除 Mod 后：
- 该 Mod 不再属于当前配置。
- 如果其他 Profile 仍引用它，不一定会删除全局缓存信息。
- 下次保存时，删除结果会反映到整合输出。
检查更新
MintCat 支持检查在线 Mod 更新，用于刷新元数据和可用版本。
建议在以下场景执行：
- 从旧配置导入后。
- 长时间没有打开 MintCat 后。
- mod.io / ModCat 上确认有新版本但本地未显示时。
保存与整合
添加、删除、启停、排序、切换版本后，需要点击 保存 才会把当前 Profile 整合到游戏目录。
推荐顺序：
- 添加或调整 Mod。
- 确认启用状态。
- 检查分组与排序。
- 点击
保存。 - 启动游戏验证效果。
常见问题
添加链接后提示失败
可能原因：
- 链接格式不支持。
- 网络不可达或 API 节点异常。
- OAuth 缺失或过期。
- 目标 Mod 已被删除或不可访问。
可尝试切换网络节点、重新获取 OAuth 或改用本地文件添加。
本地文件添加后找不到
- 确认文件仍在原路径。
- 确认文件扩展名是否为支持格式。
- 如果是压缩包，确认压缩包未损坏。
保存后游戏里没有生效
- 确认 Mod 处于启用状态。
- 确认当前 Profile 是你正在编辑的 Profile。
- 确认游戏路径配置正确。
- 尝试重新保存并重启游戏。