 |
| (角色是我家的，但是原始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，但其目前尚有已知問題，若遇到錯誤請移除該個別插件
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升級方法
- 把舊的「BepInEx」資料夾重命名為「BepInEx_bak」，或是其他名稱
- 參考[BepInEx v5.X] コイカツ！ 主程式 + mod + plugin 安裝指南安裝所有必裝插件
- 啟動Koikatu遊戲運行一次至主畫面(或CharaStudio至編輯器加載結束) ，確認Console無報錯
(若有問題請參考コイカツ! 插件安裝方式、問題判斷及排除指南) - 參考[BepInEx v5.X] コイカツ！ 主程式 + mod + plugin 安裝指南安裝所需之其他插件
- 啟動Koikatu遊戲運行，確認Console
- 用文字編輯器打開「BepInEx_bak/config.ini」，檢視有無需要拷貝過去「BepInEx/config」下和「BepInEx/config.ini」的設定
- 重啟遊戲
不然你問題絕對會爆炸多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<<
