安装教学

KKS 安装教学

KKS 分为原版来源与 BR12 整合版：原版玩家建议安装 KKS HF Patch，BR12 玩家则直接使用整合环境。

返回首页
KKS

Koikatsu Sunshine

KKS 分为原版来源与 BR12 整合版：原版玩家建议安装 KKS HF Patch，BR12 玩家则直接使用整合环境。

干净来源
KKS Original 待接入

干净本体来源；下载后建议接着安装 KKS HF Patch。

KKS BR12 待接入

BetterRepack 整合版，已经包含大量插件、Mod 与常用依赖。

安装顺序
  1. 先确认要走哪一条路线：KKS Original 是干净本体，KKS BR12 是 BetterRepack 整合版。
  2. 如果下载 KKS Original，解压到独立目录，例如 C:\Games\KoikatsuSunshine，并确认它不是 KK 目录直接复制改名。
  3. 首次启动 KKS Original 本体，确认 Sunshine 本体能正常进入。
  4. 下载并安装 KKS 专用的 KKS HF Patch；不要安装 KK-HF Patch，也不要下载 GitHub 的 Source code 压缩包。
  5. 如果下载 KKS BR12，解压后先直接启动测试，不要再把 KKS HF Patch 覆盖进 BR 整合目录。
  6. 启动一次生成配置，再导入 Sunshine 卡片、场景与 zipmod。
插件与资源

KKS Original 建议

  • 原版玩家建议安装 KKS HF Patch，用来补齐 BepInEx、KKSAPI、常用插件、翻译与基础依赖。
  • HF Patch 目标目录必须选择 KKS Original 的游戏根目录。
  • 不要把 KK-HF Patch、KK 插件 DLL 或旧 KK 目录内容混进 KKS。

KKS BR12 整合版

  • BR12 已经是 BetterRepack 整合环境，通常不需要再安装 KKS HF Patch。
  • 更新插件时优先使用 KKManager 或 BR 提供的更新流程。
  • 如果想回到纯净版，应另开干净目录，不要在 BR 目录中混合拆装。

放置路径

  • 角色卡：UserData\chara\female 或 UserData\chara\male
  • 场景卡：UserData\studio\scene
  • zipmod：mods 目录
完成检查
  • 能明确分辨当前目录是 KKS Original 还是 KKS BR12，不把两条路线混在同一个资料夹。
  • KKS Original：游戏能先单独启动，之后才安装 KKS HF Patch，且目标目录选择 Sunshine 根目录。
  • KKS BR12：解压后可直接启动，不额外覆盖安装 HF Patch，也不把 Original 的档案拷进去。
  • 启动游戏后 BepInEx 没有持续红字报错；如果有报错，先看是否混用了 KK 插件或旧 DLL。
  • 人物卡能在 Sunshine 的 Maker 读取，场景卡能在 Studio 读取。
  • 缺服装、头发、配件或场景物件时，优先补 KKS 对应 zipmod，不用 KK 旧版资源硬凑。