(角色是我家的,但是原始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