導入ガイド

クリーンソースから使える環境へ

本体だけでは十分ではありません。クリーンなフォルダを用意し、対応するフレームワークとプラグインを入れてから、カード、シーン、Mod を追加します。

ホームへ戻る
KK

Koikatsu Party

多くの旧来 KK カード、シーン、zipmod リソース向けの基本環境です。

導入順
  1. KK クリーンソースをダウンロードし、圧縮ファイルが完全か確認します。
  2. C:\Games\Koikatsu など短いパスへ解凍し、保護されたシステムフォルダは避けます。
  3. 本体を一度起動し、正常に開くことを確認してから閉じます。
  4. KK 用のフレームワークとプラグインパックを入れます。KKS 専用プラグインは混ぜないでください。
  5. もう一度起動して設定フォルダを生成し、その後カード、シーン、Mod を追加します。
プラグインとリソース

コア環境

  • BepInEx 5 系列
  • KKAPI
  • BepisPlugins / ExtensibleSaveFormat
  • XUnity Auto Translator

よく使うリソース

  • Sideloader Modpack または zipmod
  • MaterialEditor / MoreAccessories 系の依存
  • 作者が指定した追加プラグイン

配置フォルダ

  • キャラカード：UserData\chara\female または UserData\chara\male
  • シーン：UserData\studio\scene
  • zipmod：mods
完了チェック
  • 黒画面や読み込み停止なしで起動できます。
  • BepInEx ログに正常な読み込み記録があります。
  • カードのサムネイルが表示されます。欠品は zipmod や依存不足を先に確認します。
  • 大量投入の前に、少量のリソースでテストします。
KKS

Koikatsu Sunshine

KKS には Original と BR12 の 2 ルートがあります。Original は 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 とは別のフォルダへ解凍します。KK フォルダを名前変更しただけのものは使いません。
  3. KKS Original 本体を一度起動し、Sunshine が正常に開くことを確認します。
  4. KKS 用の HF Patch をダウンロードして導入します。KK-HF Patch や GitHub の Source code 圧縮ファイルは使いません。
  5. KKS BR12 は解凍後にそのまま起動確認し、BR フォルダへ KKS HF Patch を上書き導入しないでください。
  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 または BetterRepack 側の更新手順を優先します。
  • クリーン環境にしたい場合は、BR フォルダを削りながら使うより別フォルダの KKS Original から始めます。

配置フォルダ

  • キャラカード：UserData\chara\female または UserData\chara\male
  • シーン：UserData\studio\scene
  • zipmod：mods
完了チェック
  • KK と KKS は別フォルダで管理します。
  • Original ルートでは KK-HF Patch ではなく KKS HF Patch を使います。
  • BR12 ルートでは HF Patch を上書き導入していません。
  • BepInEx ログに赤字エラーが連続していません。
  • Sunshine 用カードがメーカーで読み込めます。
  • 衣装、髪、アクセサリ不足は KKS 用 zipmod を先に確認します。