跳到主要内容

MOD 安装 / 卸载

本文说明 MintCat 本体的安装、升级、卸载，以及 Mod 整合安装相关注意事项。

安装 MintCat​

下载地址：GitHub Releases

Windows​

  1. 打开 Release 页面。
  2. 下载最新版本的 Windows 安装包，通常命名为 mintcat_<版本>_x64-setup.exe。
  3. 双击运行安装包。
  4. 按安装向导完成安装。
  5. 启动 MintCat。

如果 Windows Defender 或 SmartScreen 弹出提示：

  • 确认文件来自官方 Release。
  • 选择“更多信息”后继续运行。

便携版​

如果 Release 中提供便携版：

  1. 下载便携版压缩包。
  2. 解压到一个固定目录。
  3. 运行其中的 MintCat 可执行文件。

便携版适合临时测试或不想写入安装目录的用户，但本地配置、缓存与日志仍可能写入系统应用目录。

升级 MintCat​

从 0.5.x 升级到新的 0.5.x​

  1. 关闭正在运行的 MintCat。
  2. 下载新版本安装包。
  3. 直接覆盖安装。
  4. 启动后检查 Profile、设置与 Mod 列表。

通常不需要手动卸载旧版本。

从旧版本升级到 0.5​

  1. 安装最新 0.5.x。
  2. 首次启动时根据新手引导选择是否导入旧配置。
  3. 也可以稍后进入 设置 -> MintCat Settings -> Import Config 手动导入。
  4. 导入完成后建议执行一次 Mod 更新检查。

更多细节见配置导入。

卸载 MintCat​

使用卸载程序​

  1. 打开 MintCat 安装目录。
  2. 运行 uninstall.exe。
  3. 按提示完成卸载。

完全清理本地数据​

卸载程序通常只移除应用本体。若需要完全清理，请手动删除：

类型WindowsmacOS
配置C:\Users\<用户名>\AppData\Roaming\com.mint.cat~/Library/Application Support/com.mint.cat
日志C:\Users\<用户名>\AppData\Local\com.mint.cat\logs~/Library/Logs/com.mint.cat/mintcat.log
缓存C:\Users\<用户名>\AppData\Local\com.mint.cat~/Library/Caches/com.mint.cat

删除配置目录会移除本地 Profile、设置和 OAuth 等数据。操作前请确认已经备份。

Mod 整合安装​

MintCat 中的“安装 Mod”通常指把当前 Profile 中启用的 Mod 整合到游戏目录。

推荐流程：

  1. 在首页添加 Mod。
  2. 调整分组、排序、启用状态和版本。
  3. 点击 保存。
  4. MintCat 会根据当前游戏路径执行整合。
  5. 点击 启动 进入游戏。

卸载或停用单个 Mod​

临时停用​

  1. 在首页找到目标 Mod。
  2. 关闭启用状态。
  3. 点击 保存。

这种方式会保留 Mod 在 Profile 中，方便以后重新启用。

从 Profile 删除​

  1. 在首页找到目标 Mod。
  2. 执行删除操作。
  3. 点击 保存。

这种方式会把 Mod 从当前 Profile 移除。

更换游戏路径​

如果更换了游戏安装位置：

  1. 点击标题栏启动按钮右侧的 ...。
  2. 打开 选择游戏。
  3. 重新选择正确路径。
  4. 回到首页点击 保存。

常见问题​

安装后无法启动 MintCat​

  • 检查系统是否拦截了应用。
  • 尝试以管理员权限运行。
  • 查看日志目录中的日志文件。
  • 确认 WebView2 等运行环境是否正常。

保存时报错或整合失败​

  • 确认游戏未在运行中。
  • 确认游戏目录有写入权限。
  • 检查本地 Mod 文件是否存在。
  • 尝试减少最近新增的 Mod 后重新保存。

卸载后重新安装，配置仍然存在​

这是正常现象。卸载程序通常不会删除用户数据。需要完全清理时，请手动删除配置目录。