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

(角色是我家的,但是原始Scene不是我做的)
2019/10/23經歷了一次BepInEx 4→5的重要框架升級,在插件安裝位置方面做了很大的變更
另外因為此版本內部變動很大,對開發者來說有些插件得要重寫
像我8個插件死了4個....
請務必詳讀內文,按照提示做升級,否則幾乎必死w

三種插件類型

現在插件分為三種安裝方式:
  • 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有修改升級,這些產出檔案就應該要再被重新轉換。IPALoaderX也是同理。

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
若喜歡我的文章,歡迎給我鼓勵 (ノ>ω<)ノ!
任何的捐助都是對我的實際支持,謝謝你們
私が作ったものが役に立ったら、寄付してください (ノ>ω<)ノ!
寄付は私にとって大きな助けになります、ありがと
If you like my works above, please feel free to support me (ノ>ω<)ノ!
Any donation will be of great help to me, thank you.

>>捐款頁 & 銘謝清單<<
>>Donation page & Thanks list<<

目錄