コイカツ!でMODを使ってみた | How to use MOD for Koikatsu!

<img width="200" alt="コイカツ_アフタースクール.jpg" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/b47a3c77-f120-9b26-ecd6-4c964c256440.jpeg"><img width="200" alt="ぷにあなミラクルDX.jpg" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/0b2021f9-d6c0-4198-00b3-3f2b07cb15cf.jpeg"><img width="300" alt="Oculus_rift_s.jpg" src="https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/05c78f3a-bbcb-e706-fd99-e68776797f6a.jpeg">
※ 上画像はすべてamazonサイトから引用


#注意
* <font color="Red">18才未満NG!!!(一応)</font>
* 本内容はメモ程度の書き物です。
* 本内容に依拠した不幸は自己責任でお願いします

#背景
等身大サイズのオ〇ホールとVRを連動させて夢のような体験(アンダーグラウンドの深淵で生活)ができる
参考:
    1. https://onahot.com/?p=52
    2. https://vr-erogamer.com/archives/613

#目的
等身大サイズのオ〇ホールとVRを連動させる

#方法
#### PCスペック(Me)
* CPU:    AMD Ryzen 7 3700X 8-Core Processor 3.60 GHz
* RAM:    32.0 GB
* System: 64-bit operating system, x64-based processor
* GPU :   NVIDIA GeForce GTX 1660 Ti

#### 使うもの (10万円くらいかかったと思います...汗)
1. Oculus rift s (SteamVRが使えればよいのでrift sでなくてもよい。Vive でもよい。)(<font color="Red">注意: Oculus rift sの場合、GPUにDisplayPortがあること!</font>)
2. ぷにあなミラクルDX(https://www.amazon.co.jp/dp/B079Z5NCMH?_encoding=UTF8&blackCurtainKey=black-curtain&redirect=true) (お手入れ大変。使用後はカビ対策を行うこと。例えば、ベビーパウダを塗ったり、穴にタンポンや、珪藻土スティックを差し込んだり、乾燥剤を置いたり等。お手入れ方法はこちら(https://buuta101.fanbox.cc/posts/1520920) が大変参考になった)
3. コイカツ! アフタースクール
4. Koikatsu Official VR Patch 0531 (後述)
5. BepInEx_x64_5.3.0.0 (後述)
6. ConfigurationManager (後述)
7. KK_SetParentVR (後述)

#### 手順 (<font color="Red">インストールとダウンロードの違いに注意</font>)
1. Oculusのセットアップ(もしくはviveのセットアップ)。こちらは製品のマニュアル通りにすればOK
2. SteamVR(私のversionは1.18.7でした。ご参考までに。)をSteamからダウンロード(このとき、ソフト電池メーターというソフトウェアのインストールを促された気がする。もちろんインストールした)
3. DMM GAMESでコイカツ!とアフタースクールのダウンロードコンテンツ(DLC)を購入(パックにもなっている(https://dlsoft.dmm.co.jp/detail/illusion_0027pack/?i3_ref=search&i3_ord=1))
4. DMM GAMESでコイカツ!の結合ファイル(illusion_0023.part1.exe)と分割ファイル(illusion_0023.part2.rar, illusion_0023.part3.rar, illusion_0023.part4.rar, illusion_0023.part5.rar)を同じフォルダにダウンロードする
5. コイカツ!の結合ファイル(illusion_0023.part1.exe)を実行するとコイカツ!DL版という名前のフォルダが作られる。コイカツ!DL版フォルダ内のSetup.exeを実行し(フォルダ内の「コイカツ！DL版お読み下さい.txt」に従う)、コイカツ!をインストールする。インストール先はデフォルトでC://illusion//Koikatuとなっている(自分はDドライブに保存した)
6. DMM GAMESでアフタースクールDLCの結合ファイル(illusion_0026.part1.exe)と分割ファイル(illusion_0026.part2.rar, illusion_0026.part3.rar)を同じフォルダにダウンロードする
7. アフタースクールDLCの結合ファイル(illusion_0026.part1.exe)を実行するとコイカツ!アルタースクールDL版という名前のフォルダが作られる。コイカツ!アルタースクールDL版フォルダ内のsetupフォルダの中身をコイカツ!のインストール先(デフォルト: C://illusion//Koikatu)に上書きでコピペする(フォルダ内の「お読みください.txt」に従う)
8. Koikatsu Official VR Patch 0531 (http://www.illusion.jp/preview/koikatu/download/vr.php) で公式のVR化パッチをダウンロード。コイカツ!VR_0531更新版という名前のフォルダが作られるので、フォルダ内のsetupフォルダの中身をコイカツ!のインストール先に上書きでコピペする
9. 以上で、コイカツをVRで遊べるようになっている(これだけでも十分であるが以下から真のアンダーグラウンドへの道のりである)
10. MODプラグイン(※1)を利用するためのフレームワーク(※2)であるBepInExをダウンロードする(64bitマシンの場合はx64を選択すること。)。BepInEx v5.3をダウンロードした(https://github.com/BepInEx/BepInEx/releases/tag/v5.3 )。 BeplnEXフォルダ、doorstop_config.ini、winhttp.dllをコイカツ!のインストール先にコピペする
11. コイカツ!を一度起動する。BepInExにもろもろのフォルダが生成される
12. BepInEx 4 Patcherをダウンロードする(https://github.com/BepInEx/BepInEx.BepInEx4Upgrader/releases/tag/v1.0.0.0 )。ダウンロードしたdllファイルをBepInEx/patchersに置く
13. BepisPlugins(※3)をダウンロードする(もしかすると不要かも。同梱されているConfigurationManager(※4)がほしかったためBepisPluginsをダウンロードした。しかし、同梱されているConfigurationManagerはBepInExによってただしくインストールされなかったため(BepInEx (5.4.8.0)用のBepisPluginsだったためにうまくいかなかった可能性が高い)、次項の13でConfigurationManagerを単体でダウンロードした)(https://github.com/IllusionMods/BepisPlugins/releases/tag/r16.4 )。r16.4をダウンロードしました。ダウンロードしたものをBepInExフォルダにコピペ。
14. ConfigurationManagerをダウンロードする(<font color="Red">これがないとKK_SetParentVRがアクティブにならなかった</font> )(https://github.com/BepInEx/BepInEx.ConfigurationManager/releases/tag/v16.3 )。v16.3をダウンロードした。ダウンロードしたものをBepInEx/pluginsにコピペする
15. KK_SetParentVRをダウンロードする(https://github.com/MayouKurayami/KK_SetParentVR/releases/tag/2.1.8 )。バージョン2.1.8をダウンロードした
16. KK_SetParentVRの使い方はこちらの動画(https://mega.nz/file/RPpCDKIa#RRb_kYaRrrIqtDyojm3U2BVU_0dgin7B5nNCzXTvVQo )を参照

最終的なインストール先のディレクトリ構成(<font color="Red">注意：コイカツ!追加性格パックDL版もインストールしているため、フォルダまたはファイルの数が合わない場合があります。ご参考程度で。</font>)
![koikatu_folder.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/ca210b32-99cb-a376-b1ff-3c60fc1308e1.png)
![koikatu_folder_beplnEx.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/d435580d-74a0-1392-a5c8-bc88b0c2e6a8.png)
![koikatu_folder_beplnEx_patchers.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/a5f783fe-d1bf-aa1d-c1ba-61139c023c29.png)
![koikatu_folder_beplnEx_plugins.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/1800350f-bfad-e3ad-a8a0-537d48ba152f.png)
![koikatu_folder_beplnEx_LogOutput.log.PNG](https://qiita-image-store.s3.ap-northeast-1.amazonaws.com/0/213270/e8ae535b-f731-6763-fd16-ac8c8b8683cc.png)




(※1) MODはMODification(改変)の略。公式のコンテンツを使って、非公式な使い方をするための改変である。
(※2) ここではMODプラグイン開発の土台として機能させるソフトウェアのこと
(※3) 便利なMODがまとめて入っている
(※4) コイカツ!(Non VR空間)のメニュー画面の右上にmod/settingというタブが表示され、そこから、BepInExを介して利用できるMODが検索、閲覧できるためのMOD

#結果
いろいろ躓き、夏休みが消えました。

#参考文献
1. https://onahot.com/?p=52
2. https://vr-erogamer.com/archives/613
3. https://github.com/MayouKurayami/KK_SetParentVR
4. Discord　コイカツ (https://discordapp.com/invite/Jbg8c8S)
5. BepInExの導入にはこちらも役に立つと思います(https://apple-geeks.com/koikatu-mod-34344)

#おまけ
BeplnExに入れておいた方がよいMOD(plugin)
1. CrossFader plugin
2. KoikatuVRAssistPlugin plugin