コイカツプラグイン
KK Library は、小さなプラグインを通して、シーン、キャラクターカード、衣装をコイカツの CharaStudio やキャラメイクに読み込みます。
- 場所
- [ファイル] ▸ [設定] ▸ [ゲーム連携]、インスペクターの [CharaStudio] と [コイカツで編集]
概要
#KK Library はプラグインを通して、ファイルを今ある場所からゲームに読み込ませます。ゲームへファイルをコピーするわけではありません。
プラグインがファイルを読み込むのは CharaStudio とキャラメイクです。フリー H などの画面は独自の方法でキャラクターを選ぶため、プラグインは読み込みません。
できること
#アセットごとの読み込み先
#シーンは CharaStudio に、カードと衣装は CharaStudio かキャラメイクに読み込まれます。
- CharaStudio では、カードはキャラクターを追加するか、選択中のキャラクターと置き換えます。衣装は選択中のキャラクターに着せます。
- タイトル画面やフリー H など、ゲーム本編のほかの画面では、カードや衣装はキャラメイクを開くまで待機します。
- アセット読み込み設定 で、カードや衣装のどの部分を読み込むかを選べます。
- クイックリスト からドラッグしても読み込めます。違いはそのページにあります。
ゲームに入れるプラグイン
#プラグインはコイカツ用とコイカツサンシャイン用に分かれていて、ゲームの BepInEx\plugins フォルダーに入ります。
- BepInEx と Modding API (KKAPI または KKSAPI) が必要で、MOD を入れたゲームならたいていそろっています。MOD なしのゲームでは読み込めませんが、KK Library はファイルをすべて読めます。
- KK Library は起動時と読み込み前にプラグインを確認します。入れ替えが必要でも、ゲームが開いている間は閉じるまで待ちます。
- ゲームフォルダーを指定すると、
UserData\Studio\scene、UserData\chara\female、UserData\chara\male、UserData\coordinateもライブラリに追加されます (ライブラリフォルダーを外す)。
ゲームの準備前に読み込む
#ゲームが閉じていれば、KK Library が確認してから起動します。ゲームの準備ができたら、プラグインがファイルを読み込みます。
- 待つ時間は、[設定] の [起動中のゲームを待つ時間] で 1 分から 4 分まで選べます。
- 待っている間に別のものを読み込むと、新しいほうに置き換わります。
- [次回から確認しない] で確認を止められます。戻すには、[設定] の [KK Library がゲームを起動する前に確認する] か [CharaStudio で開いているシーンを置き換える前に確認する] をオンにします。
ゲームの状態を見る
#
ステータスバーの左端に、ゲームの状態(1)が表示されます。ゲームを開くまでは [ゲームが開いていません]、CharaStudio の準備ができると [CharaStudio に接続中] と表示されます。KK Library は 2 秒ごとに、ゲームが開いているか、プラグインが読み込まれて応答するかを確かめます。
- MOD を入れたゲームは起動に何分もかかることがあり、準備ができるまで [CharaStudio を起動中] と表示されます。赤くなるのは、問題が確かなときだけです (何も読み込まれないとき)。
- ボタンからの読み込みが終わると、Windows の通知が出ます。[ゲームでの読み込みが完了したら通知する] でオフにできます。パニックキー で KK Library を隠している間は出ません。
- ゲームの中にも、「KK Library: シーンを読み込みました。」のような短いメッセージが KK Library と同じ言語で出ます。
使い方
#プラグインをインストールする
#![[設定] の [ゲーム連携] ページの上部。[参照] に1、[KK Library プラグインをインストール/更新] に2、その下の行に3](img/koikatsu/settings-game.png)
- コイカツと CharaStudio を閉じます。開いているゲームはプラグインのファイルを使っています。
- [ファイル] ▸ [設定] を開き、[ゲーム連携] を選択します。
- [参照](1)を選択し、
CharaStudio.exeがあるゲームフォルダーを選びます。KK Library がBepInEx\pluginsにプラグインをコピーします。 - ボタンの下の行(3)で、プラグインがインストールされたこととバージョンを確認します。
- プラグインがなくなったときは、[KK Library プラグインをインストール/更新](2)を選択します。
コイカツのインストールではないようだと表示されたら、CharaStudio.exe と BepInEx の両方があるフォルダーを選んでください。最初のセットアップでも指定できます (はじめに)。
シーンを CharaStudio に読み込む
#- [シーン] を選び、タイルを選択します。
- インスペクターの [CharaStudio] を選択します。
![「CharaStudio を起動しますか?」の確認。[次回から確認しない] に1、[起動] に2、[キャンセル] に3](img/koikatsu/open-game-question.png)
- CharaStudio が閉じていると、「CharaStudio を起動しますか?」と確認されます。[起動](2)を選択します。次から確認しないなら、先に [次回から確認しない](1)をオンにします。[キャンセル](3)で読み込みをやめます。
- CharaStudio のシーンに何か置いてあれば、置き換える前に確認されます。[置き換える] を選択すると、ステータスバーに「CharaStudio でシーンを読み込みました。」と表示されます。
開いているシーンに追加するには、タイルを右クリックして [現在のシーンにインポート] を選びます。
カードや衣装を CharaStudio に読み込む
#![キャラクターカードのインスペクターの下部。[CharaStudio] に1、[コイカツで編集] に2](img/koikatsu/card-buttons.png)
- CharaStudio でシーンを開きます。
- 置き換えるなら、CharaStudio でそのキャラクターを選択します。追加するなら、誰も選択しません。
- KK Library で [キャラ] を選び、カードを選択して [CharaStudio](1)を選択します。置き換えたキャラクターは位置とポーズを引き継ぐので、アニメーションもそのまま動きます。
- 着せ替えるには、CharaStudio でキャラクターを選択し、KK Library で衣装を選択して [CharaStudio] を選択します。
CharaStudio が閉じていると、衣装の [CharaStudio] は起動するだけです。まだ誰も選択できないためです。キャラクターを選択してから、もう一度選択してください。誰も選択されていなければ、KK Library がそう伝えます。
カードや衣装をキャラメイクに読み込む
#- カードか衣装を選択し、[コイカツで編集] を選択します。
- ゲームが閉じていれば、確認で [起動] を選択します。カードに合ったキャラメイクが開きます。
- [性別] が [どちらでも] の衣装では、確認で [女性] か [男性] を選択します (衣装の対象の性別を設定する)。
- タイトル画面のときは、キャラメイクを開くまでカードは待機します。
- キャラメイクで同じカードに上書き保存すると、KK Library はすぐに読み直します。
もう一方の性別のキャラメイクにカードを読み込むと、キャラクターはカードの性別のままですが、スライダーは開いたときの性別のものなので、一部が合わなくなります。もう一方の性別用の衣装では [性別が異なります] の確認が出ます。たいていは読み込めますが、一部の衣類が既定のアイテムになることがあります。
カードや衣装のどの部分を読み込むか選ぶ
#![[アセット読み込み設定] の [キャラ] タブ。[キャラ] と [衣装] のタブに1、[パーツを選んで読み込む] に2、[カード] のパーツに3、ゲームの状態に4。4 は「ゲームが開いていません」と表示されている](img/koikatsu/load-settings.png)
- 先にゲームを開きます。この設定はゲームが持っているので、つながるまでパーツはロックされます。つながったかどうかは、ゲームの状態(4)でわかります。
- [表示] ▸ [アセット読み込み設定] を開きます。
- [キャラ] か [衣装](1)を選択します。
- [パーツを選んで読み込む](2)の横のスイッチをオンにします。オフなら、まるごと読み込まれます。
- 読み込まないパーツ(3)をオフにします。今の服をそのままにするには、[服] をオフにします。
これ以降は、ボタンでもドラッグでもこの設定で読み込まれます。ゲームの読み込み画面で変えると、こちらにも反映されます。[衣装] タブには Coordinate Load Option MOD が必要で、ないときは衣装がまるごと読み込まれ、タブにもそう表示されます。
何も読み込まれないとき
#フリー H などほかの画面では、カードや衣装はキャラメイクを開くまで待機します (アセットごとの読み込み先)。それ以外のときは、ステータスバーの左端にあるゲームの状態を見てください。
- [ゲームのフォルダーを選んでください]。選択すると [設定] が開きます。
- [ゲームのフォルダーが見つかりません]。フォルダーの移動か、ドライブの取り外しです。指定し直してください。
- [ゲームのフォルダーにプラグインを入れられません]。[設定] で [KK Library プラグインをインストール/更新] を選択すると、理由がわかります。
- [CharaStudio を開き直してください]。プラグインが古いか、入っていません。ゲームを閉じてもう一度読み込むと、起動前にプラグインが新しくなります。
- [CharaStudio が KK Library のプラグインを読み込みませんでした]。Modding API が入っていて新しいかを確かめてください。理由はゲームフォルダーの BepInEx のログに出ています。
- [CharaStudio に接続できません]。ファイアウォールやウイルス対策ソフトなどが接続を拒んでいます。
起動が [起動中のゲームを待つ時間] より長くかかると、「CharaStudio が時間内に準備できませんでした。」と表示されます。起動したらもう一度読み込むか、長い時間を選んでください。
KK Library 0.1.0-beta.9.1 で確認済み