[Koikatu] コイカツ！ ( Koikatu / Koikatsu / 戀愛活動 ) BepInEx框架 v4.X→v5.X升級指南

(角色是我家的，但是原始Scene不是我做的)

前言

2019/10/23經歷了一次BepInEx 4→5的重要框架升級，在插件安裝位置方面做了很大的變更
另外因為此版本內部變動很大，對開發者來說有些插件得要重寫
像我8個插件死了4個....不過這主要是因為我對外國佬的插件們做了堆亂七八糟的事

三種插件類型

現在插件分為三種安裝方式:

• BepInEx 5插件:
  直接將*.dll等檔案放置於「BepInEx/plugins/」之下，例如「C:\illusion\Koikatu\BepInEx\plugins」
  BepInEx 5開始插件支援子資料夾，可以放置在BepInEx/plugins底下的任何多層資料夾內，但推薦參考原始壓縮檔之結構放置
• BepInEx 4插件:
  必須安裝BepInEx4Upgrader將之升級為「符合BepInEx5框架的BepInEx4插件」
  之後將*.dll等檔案放置於「BepInEx/」之下，例如「C:\illusion\Koikatu\BepInEx」，就可以自動升級
  自動升級運作有機會異常，請小心使用
• IPA:
  直接將*.dll等檔案放置於「Plugins/」之下，例如「C:\illusion\Koikatu\Plugins」
  需要IPALoaderX，但其目前尚有已知問題，若遇到錯誤請移除該個別插件

所有在2019/10/23以前發布的BepInEx插件皆是BepInEx 4插件，而在那之後的請參考各插件Readme。

BepIn4Patcher ── BepInEx4插件的修補升級器

在每次遊戲啟動時，BepIn4Patcher會掃描「BepInEx」資料夾下的BepInEx4插件。如果需要升級，他會將原始BepInEx4插件備份至「BepInEx/bepinex4_backup」，然後把升級過後之「符合BepInEx5框架的BepInEx4插件」放在原位。

請注意，這些經過轉換吐出的插件檔案，切勿再分享出去，也不適合再另外備份保留，請備份backup資料夾裡的原始插件。這是為了不要在網路上造成混淆，且將來若BepIn4Patcher有修改升級，這些產出檔案就應該要再被重新轉換。IPA插件也是同理。

BepInEx v5.X之資料夾結構說明

這些*.exe檔案所在的最外層位置稱為「遊戲根目錄」，圖中路徑為遊戲預設安裝目錄「C:\illusion\Koikatu」，若使用原版コイカツ！ 安裝光碟以預設值安裝就會在此位置

圖1，C:\illusion\Koikatu

• 「BepInEx」: BepInEx插件目錄，詳見圖2
• 「mods」: 需要自己建立的目錄，裏頭放置Sideloader mods，其應為*.zip或*.zipmod
• 「Plugins」: IPA插件資料夾，以前是位於「BepInEx/IPA」，現在改到這裡以符合IPA插件預設目錄結構
• 「Plugins_backup」: IPA插件備份資料夾，IPALoaderX會將某些IPA插件做轉換，讓他可以在BepInEx框架環境運行，而轉換吐出的插件會留在「Plugins」資料夾，原始IPA插件會備份至「Plugins_backup」

圖2，C:\illusion\Koikatu\BepInEx

• 「BepInEx」: BepInEx4插件請直接放在此目錄內，就如同舊版位置
• 「BepInEx/config.ini」: BepInEx4插件設定檔，就如同舊版位置
• 「BepInEx/bepinex4_backup」: BepInEx4插件備份資料夾，BepIn4Patcher會將BepInEx4插件自動升級為BepInEx5插件，而升級吐出的插件會留在「BepInEx」資料夾，原始BepInEx4插件會備份至「BepInEx/bepinex4_backup」
• 「BepInEx/cache」: 快取資料夾，不要去動他
• 「BepInEx/config」: BepInEx5插件設定檔資料夾，新版的設定檔是每一插件都會個別產生一個cfg檔，集中放置在此；可用文字編輯器打開
• 「BepInEx/core」: BepInEx5重要核心插件，不要去動他
• 「BepInEx/patchers」: 特殊修補程式，例如BepIn4Patcher就在這，不要去動他
• 「BepInEx/plugins」: BepInEx5插件放置位置，支援多層子資料夾，建議參考各插件的壓縮檔結構放置；若壓縮檔內無建立參考結構，直接放在「BepInEx/plugins」下即可
• 「BepInEx/Translation」: 存放翻譯資料之資料夾

BepInEx v4.X→v5.X升級方法

1. 把舊的「BepInEx」資料夾重命名為「BepInEx_bak」，或是其他名稱
2. 參考[BepInEx v5.X] コイカツ！ 主程式 + mod + plugin 安裝指南安裝所有必裝插件
3. 啟動Koikatu遊戲運行一次至主畫面(或CharaStudio至編輯器加載結束) ，確認Console無報錯
   (若有問題請參考コイカツ! 插件安裝方式、問題判斷及排除指南)
4. 參考[BepInEx v5.X] コイカツ！ 主程式 + mod + plugin 安裝指南安裝所需之其他插件
5. 啟動Koikatu遊戲運行，確認Console
6. 用文字編輯器打開「BepInEx_bak/config.ini」，檢視有無需要拷貝過去「BepInEx/config」下和「BepInEx/config.ini」的設定
7. 重啟遊戲

用一句話來概述，就是砍掉重練
不然你問題絕對會爆炸多w