GUIDES

模组的安装顺序与前置依赖关系

「装了却没有任何反应」,多数情况是前置模组没有先装。本文整理了哪些是地基、哪些建在其上。

结论

顺序是「地基 → API → 各个插件」。地基就是 BepInEx,本站目录中有 6 个模组把它列为前置。

初次安装时不需要自己拼装这个顺序,因为 HF Patch 会把整套地基一并装好。顺序真正开始重要,是在之后单独追加模组的时候。

作为地基的三个

模组作用以它为前置的模组
BepInEx运行插件的机制本身56 个
BepisPlugins含 Sideloader 等基本功能的合集40 个
Illusion Modding API (KKAPI / KKSAPI)各插件调用共通功能的基础42 个

这三个之间还互相依赖。BepisPlugins 与 Illusion Modding API 都以 BepInEx 为前置,因此实际安装时 BepInEx 一定排在最前。

被其他模组当作前置的模组

除了地基之外,还有一些模组被别的模组列为前置。如果打算使用建立在它们之上的模组,先装好可以省去返工。

模组以它为前置的模组
Configuration Manager8 个
MaterialEditor3 个
Sideloader3 个
ExtensibleSaveFormat2 个
Timeline1 个

看似顺序问题、其实不是的两点

即使前置都满足,下面两种情况也会让模组看起来「没生效」。

  • 对应游戏不同。恋活用与恋活 Sunshine 用是不同的文件,互换是无法运行的
  • 分享角色卡时,接收方也需要相同的模组。MoreAccessories、Pushup、MoreOutfits、DynamicBoneEditor 在缺失的环境下打开,外观会发生变化

查询单个模组的前置

本站的模组页设有「需要先安装的模组」一栏,已知的前置会从那里链接过去。反过来,基础类模组的页面会列出「以此模组为前置的模组」。

关于本文的范围

此处列出的依赖关系,来自 2026-08-18 获取并核对的各模组发布页 README(74 个中的 63 个、158 条依赖)。发布页未写明前置的 11 个模组保持为空,不做推测。安装前请务必确认发布页的说明。

最后确认:2026-08-18(本站目录 74 个模组、158 条依赖关系时的统计)