安装教学

从干净来源到可用环境

本体只是第一步。KK Party 建议先准备干净目录，再安装 KK 专用 HF Patch Full，确认 Studio 工作室可用后，再导入本站的角色卡、场景和 Mod。

返回首页
KK

Koikatsu Party

以干净 KK Party 本体为底，再用 KK-HF Patch Full 补齐插件、汉化、常用依赖与 Studio 工作室。

安装顺序
  1. 下载 KK 干净来源包，并确认压缩档完整。
  2. 解压到短路径目录，例如 C:\Games\Koikatsu，不要放在系统保护目录，也不要直接覆盖旧的 Mod 环境。
  3. 首次启动 KK Party 本体，确认游戏能正常进入，再关闭游戏。
  4. 下载 KK 专用的 HF Patch Full 版；不要下载 GitHub 的 Source code 压缩包，也不要使用 KKS-HF Patch。
  5. 执行 HF Patch 安装程式，目标目录选择刚刚解压的 KK Party 目录；一般使用者建议先沿用预设勾选。
  6. 安装完成后再次启动游戏，并确认启动器或游戏目录中可以开启 Studio / CharaStudio 工作室。
插件与资源

HF Patch 会处理的内容

  • 补入 KK Party 常缺的免费更新内容，其中包含 Studio 工作室入口。
  • 安装 BepInEx、KKAPI、常用插件、翻译与基础依赖。
  • 整理常见 Sideloader / zipmod 支援，让角色卡和场景更容易正常读取。

下载与版本判断

  • KK Party 使用 KK-HF Patch，不要与 KKS-HF Patch 混用。
  • 优先从 HF Patch 正式 Release、Patreon 说明页或其指向的镜像下载。
  • 如果 GitHub 页面同时出现 Source code，那不是给一般玩家安装的补丁包。

之后再放本站资源

  • 角色卡：UserData\chara\female 或 UserData\chara\male
  • 场景卡：UserData\studio\scene，需要先确认 Studio 能开启。
  • zipmod：mods 目录；缺服装、头发或配件时，优先补对应 zipmod。
完成检查
  • KK Party 可正常启动，没有卡在黑屏或加载界面。
  • Studio / CharaStudio 可以从启动器或游戏目录独立开启。
  • BepInEx 控制台或日志有正常载入记录。
  • 角色卡缩略图可显示，场景卡可以在 Studio 读取。
  • 如果之后使用 Steam 验证档案，可能需要重新执行一次 HF Patch。
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 旧版资源硬凑。