#author("2026-01-05T09:49:23+00:00","","")
#author("2026-03-24T14:12:45+00:00","","")
*MOD [#j37d7352]
MODを導入することにより、公式の仕様には存在しない機能、衣装を追加することができます。
**&color(red){''【重要】Sunshine BetterRepackについて''}; [#i89e9f20]
ユーザ名「ScrewThisNoise」が配布している「Sunshine BetterRepack」については、''ダウンロードを行わない''ようにしてください。
このファイルはMOD詰め合わせパックのように見えますが、内容的にイリュージョンの著作物であるゲーム本体や最終パッチ、スタジオや''予約特典、DLC販売物などを全部含んでおり''、それらにHFパッチ相当のMOD詰め合わせパック追加してそのまま遊べるゲームデータとして配布されています。
つまり、ダウンロードした時点で著作権法違反となり、10年以下の懲役または1000万円以下の罰金(もしくはその双方)が課される可能性があります。
※無料配布されている体験版時点のBetterRepackであっても著作物の違法ダウンロードとなるので同じです。

既にイリュージョンが解散しているため、どうしてもこのゲームを入手するならばどうにかしてプレミアム価格の中古で探すことになります。
これらBetterRepackのDL利用は当然違法行為となるので、イリュージョン廃業以降このゲームをどうしても入手したければ、正しいユーザーはプレミアム価格でボッタクる中古屋か、フリマ等でふっかける転売ヤーに''高額な金銭を支払って中古品を購入してプレイすることを強くおすすめします。''
しかし、中古品は高騰傾向にあるうえ、ゲーム本体の円盤を中古で購入したところで自己満にしかすぎず、''転売屋が儲けるだけでメーカーの利益にはならない''時点でそこに正義はありません。
当然すでにイリュージョン公式が閉鎖してるので公式配布のスタジオや公式最終パッチ(全部入り追加データ)などはDLすることもできませんし、''不完全な状態''でしか遊べません。その点留意して購入して下さい。
※なお、本来はMODの利用もイリュージョンが規約で禁止している「改造行為」に当たりますので十分覚悟して下さい。
----
#contents
----
-過去ログ
#ls2(MOD/コメント)

** MODって? [#t2b8cca5]
「modification」(変形)の略。
公式の製品にユーザーが自作した拡張データを実装すること。つまり「改造」とほぼ同義。

-それってやばいの?
--非公式のプログラムを入れることになるので、利用は&color(red){''自己責任''};です
--うまく動かなかったり、ゲームが起動しなくなったりセーブが壊れても、''どうにかするのは自分自身''です
---MODを導入する時は前以てフォルダ構成を控えておく、ユーザーデータのバックアップをとっておくなどして、導入前の状態に戻せるようにしておきましょう
---複数のMODを導入したせいで動作不良の原因がわからなくなった時は、怪しいMODのファイルだけ取り除いて起動することで切り分けができます
--また同じ理由で、下記後述の「BepInExなどMOD」導入後に保存したデータ(キャラカード、シーンデータ)は、''絶対に公式アップローダーに上げてはいけません''
---データ的にBepInEx利用痕が公式にははっきりわかるので、&color(red){''発覚した時点でアクセス禁止''};となり、半永久的にアップローダーの利用が(閲覧、ダウンロード含め)できなくなります
---MODの使い方や、使ったことによる不具合を公式メーカーに問い合わせるのも厳禁です

ちなみにゲーム用語として、ゲームにMODを導入していないまっさらな素の状態を、アイスクリームのトッピングが何もない状態に例えて「''バニラ''(vanilla)」と呼ぶことが慣例となっています。
使い方として「ゲームにMOD入れたら起動しなくなったからバニラに戻した」などと、使われることが多いMOD界隈のワードなので覚えておくと便利です。

----

** MOD配布サイト [#acc92121]
- Koikatsu!サーバー(Discord)
--https://discordapp.com/invite/Jbg8c8S
コイカツ無印やエモクリ含むアニメ系総合サーバー。最新のMOD情報を効率よく追いたい人におすすめ。
配布は「sunshine-mod-sharing」チャンネルで行われています。
参加方法はコイカツ!攻略wikiの[[コイカツDiscord参加手順>https://wikiwiki7-r.net/koikatu/index.php?MOD#gc1cefa7]]を参考にしてください。
※複製を禁止しているゲームなどからデータを抜き出し移植したいわゆるぶっこ抜きMODも数多く配布されています。
権利元の著作権侵害にあたるためこういったMODの表立った使用は控えるようにしましょう。

- [[3D(エロ)ゲームうぷろだ>http://uppervolta-3d.net/]]
--ブランド別うぷろだの項目に「''ILLUSIONうぷろだ''」,「''Illusion関連うぷろだ''」というイリュージョン作品の総合MODアップローダがあります。
コメント欄の頭に [KKS] とあるのがコイカツ! サンシャイン用のMODです。
時々繋がらなくなりますが、そういう場合は[[サポート掲示板>https://jbbs.shitaraba.net/otaku/14116/]]のサポートスレッドを確認するか、時間をおいて改めてアクセスしましょう。
※機器故障等の不測の事態以外にも心情により停止される場合もあります。

----
* 目的別導入手順 [#i882dea2]

//-------------------------------
**BepInExを導入したい(基本MOD) [#wcdb1f2c]
BepInExとはUnity製ゲームで動作するイリュージョン作品の、パッチやプラグインを適用させるためのフレームワーク。
ゲーム本体にMODを追加していろいろな拡張機能を動かすために必要な基本システムのこと。

まずはこの段落のMODを一通り入れれば、概ね以降の機能拡張も楽になります。


▼導入方法
まず公式サイトへ行き、現状のアップデートファイルを全て当てておいてください → [[Downloadページへ>http://www.illusion.jp/preview/koikatsu_sunshine/download.php]] 
また、正しくファイル操作をするために Windowsのファイル拡張子を表示させておきましょう(エクスプローラーで表示→ファイル拡張子にチェック)
ちなみに、ゲームインスコ先のコイカツサンシャインまでのフォルダに''「日本語」が入ってるとBepInExは(それを含むHFパッチも)動かない''ので注意が必要です
OK例 D:\illusion\KoikatsuSunshine
NG例 D:\イリュージョン\KoikatsuSunshine

//都度、楽な手順があったら更新お願いします。

&color(red){''▼注意事項(必ず読んでください)''};
-以下の説明ではいずれのMODも「最新版を含む各バージョン」が列挙されたページにリンクしています。この時、基本的には最新版を落とせばOKですが、以下の点で注意が必要です。
--''最新版だからと言って動作するとは限りません。''MODはユーザ個人の製作物であり、また他のMOD同士で機能衝突する可能性も十分にテストされていないのが前提です。
--更に、相互に影響するMOD同士がある場合、一方だけを最新版にすると共倒れになるという場合もあります。
--もちろん「安定バージョン」と言えるMODの組み合わせも存在しますが、それを''本記事では記載しません。''理由は以下です。
---MODの更新スパンが速く、更新が追いつかなかったり、誰も修正しなかったため
---本記事に載せているMODはコイカツMODの一部であり、その限定的な範囲での安定バージョンを記載したところでその他のMODが動作するとは限らないため
-また、公開されているMODの最新バージョンが、コイカツ本体の最新バージョンに対応しているとは限りません。
--「公式アップデートした後に(それには未対応な)最新MODを当てる」「公式アップデートしたことで(現在入れているMODが依存している)プログラムが書き換えられる」といった状況でゲームが動作しなくなる場合があります。それぞれのリリース日から都度判断し、あえてアップデートしないなど対処してください。

//21.11.14 以下手順について、各MODの特定バージョンが記載され、そのファイルへの直リンも貼られていましたが、保守が行われなくなったことで「別記事とのバージョン不一致によって誤った手順になる」「公式サイトのアップデータを示す名称が古いままとなっている」事態となっており、却って初心者に不要な混乱を強要している状況となっていたため、上記注意事項を記載すると共に最新版へのリンクのみ残しました。

//wikiは誰でも編集でき、担当者が居るわけではありません、気ついた人が編集すればいいのでは?


''▼手順''
+''導入する前にインスコ先のKoikatsuSunshineフォルダを別ドライブにまるごとコピーして必ずバックアップをとってから始めてください'' 
(失敗や不具合のときはKoikatsuSunshineフォルダごと消してやり直せるので)
+ゲームアイコンをクリックし起動メニューを表示させたら「インストール先を開く」でKoikatsuSunshineフォルダ内を表示しておきます
''公式サイトのアップデータを導入済み''であることを確認して下さい
+''BepInEx_x64'' (各MODを動かす基幹エンジン) [[最新版はここから>https://github.com/BepInEx/BepInEx/releases]]
''現行最終バージョンはBepInEx 5.4.XXです''、6.0は次世代pre版なのでPluginsも未対応ですし、この世代のゲームでは動かないので対応版が出るまで使わないで下さい。
ファイルを解凍し、「BepInEx」(フォルダ)と「doorstop_config.ini」と「winhttp.dll」「changelog.txt」の中身全てを表示させたインスコ先のKoikatsuSunshineフォルダ内(InitSetting.exeのあるフォルダ)にコピーする。(必ず64版を使ってください。32bitの86版ではゲーム自体動きません)
+''KKS_BepisPlugins'' (超基本MOD詰め合わせ。詳細は[[MODプラグインもろもろ]]) [[最新版はここから>https://github.com/IllusionMods/BepisPlugins/releases]]
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。(ファイルを置き換える 以下同様)
+''IllusionFixes_KoikatsuSunshine'' (ゲーム動作最適化) [[最新版はここから>https://github.com/IllusionMods/IllusionFixes/releases]] 
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。
+''XUnity.ResourceRedirector-BepIn-5x'' (一部MODの動作用コンポーネント) [[最新版はここから>https://github.com/bbepis/XUnity.AutoTranslator/releases/tag/v4.21.0]]
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。((XUnity.ResourceRedirector-BepIn-5xに翻訳機能が付加されたのがXUnity.AutoTranslatorなので間違えてXUnity.AutoTranslator-BepIn-5xを入れると英語になる。HFパッチの場合は翻訳機能が付加されたXUnity.AutoTranslatorのほうが入るので対策しないと英語部分がそのまま機械翻訳でへんてこな日本語化されるので注意))

+''BepInEx.ConfigurationManager'' (各MODにコンフィグ機能を付与するMOD) [[最新版はここから>https://github.com/BepInEx/BepInEx.ConfigurationManager/releases]]
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。
+''KKS_MoreOutfits'' (キャラ衣装を無印同様7種にし、互換性も与えるMOD) [[最新版はここから>https://github.com/IllusionMods/KK_Plugins/releases]] ※「MoreOutfits」でページ内検索し、引っかかったバージョンの「Assets」の中にあります
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。
+''KKSAPI ※Illusion Modding API'' (一部MODの動作用コンポーネント)  [[最新版はここから>https://github.com/IllusionMods/IllusionModdingAPI/releases]]
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。
+''BepInEx.MessageCenter'' (簡易的なMOD動作状況を画面上に表示するMOD) [[最新版はここから>https://github.com/BepInEx/BepInEx.Utility/releases]] ※「MessageCenter」でページ内検索し、引っかかったバージョンの「Assets」の中にあります
ファイルを解凍し、「BepInEx」(フォルダ)をインスコ先のKoikatsuSunshineフォルダ内へ上書きする。

-各MOD導入後のバージョンUPは基本的に新しいファイルで上書きすればOKです。(上書き不可の場合は削除ファイルの指定有り)
--が、冒頭にもある通り最新版は検証が不十分(例えばバグ持ちのままリリースされるなど)であり、必ずしも良いとは限りません。
--なお、ダウンロードの際は対応をゲームを示す略語に注意してください。({KKS}サンシャイン用のファイル。他は{AI}AI少女、{HS2}ハニーセレクト2、{KK}コイカツ)

//他記事と矛盾が生じる事態になっているうえ、恐らく記載した人も面倒が見切れなくなっていると思われるため、「初心者の方は確認済みの''直Downloadから落としたファイルで着実に導入''してください。最新版リンクは公式アプデなどで既存MODが動かなくなったときの対処用です。」を削除

//↓21.11.14 以下の文書いた本人ですが、いらなくなったのでCO
//◇補足
//BepInExは上記の通り基幹プログラムのため、導入成功したかが判りにくいです。
//一方BepisPluginsは、BepInExで動作する基本的なMODの詰め合わせパックで、「スクリーンショット機能の拡張」「スライダー幅の拡張」などのMODファイルが含まれているため、その動作確認までを上記手順に含めています。
//この詰め合わせにどのようなMODが入っているかは[[MODプラグインもろもろ]]を参照してください。

上記でBepInExと、主要な幾つかのプラグインの導入がされていますが、不具合があれば随時コメントもしくは掲示板等へお願いします。
あとは''入れるMODに合わせて各所で配布されているプラグインを追加して''ください。


//----------------------------------------------------------------------
** 無修正化(ZIPMOD方式) [#rd7321e0] 

まんちんセレクター(KKS_UncensorSelector)導入法 


- 概要
ZIPMOD形式の複数の性器MODを導入して、キャラクター毎に個々に性器の種類指定ができるBepInExプラグインです。
デメリットはExtensibleSaveFormatを使うため''同じプラグイン使用者以外互換性がなくなる''(シーンデータやキャラ等を配ってもプラグインを入れていない人は読み込みができなくなる)などです。&color(red){''繰り返しますが性器MODを導入した場合は、以降、公式のアップローダーは絶対に使用しないでください。アクセス禁止となりBANされます。''};(見る人が見ればBepInExが導入されてるキャラやシーンデータはバレバレなので)
#br

- 前提条件
-- 上の''「BepInExを導入したい」の手順をすべて済ませておいて下さい''
//今後のアップデートによるトラブルや、トラブルが起きた時に問題を切り分けて対処できる人が増えるよう、
//無修正化は無修正化のみ。BPは別項目として扱わせて頂きます。
#br
#br
- 用意するもの

--KKS_UncensorSelector.v3.11.5.zip(本体) [[Download>https://github.com/IllusionMods/KK_Plugins/releases/download/v211/KKS_UncensorSelector.v3.11.5.zip]] 

--UncensorSelector用zipmod   [[Download>https://drive.google.com/drive/folders/17tOai62MHIGpPQVQE0CAgCU8DA_rsqpT]]
  男性器や女性器の種類を追加。ここから全部、もしくはお好みのものを落とす。(右クリック→ダウンロード)
  現状は[KK][Female]SAC Uncensor Selector Pack v0.9.2.zipmodだけで十分かも

--DeathWeaselKKSSoS_Dick_v1.3.zipmod(棒)  [[Download>https://cdn.discordapp.com/attachments/847675345297473546/881282884139364382/DeathWeaselKKSSoS_Dick_v1.3.zipmod]]

--DeathWeaselKKSColor_Matching_Balls.zipmod(たま) [[Download>https://cdn.discordapp.com/attachments/847675345297473546/881282812865552504/DeathWeaselKKSColor_Matching_Balls.zipmod]]

--KKS_OverlayMods_6.0.6.0.zip   [[Download>https://www.patreon.com/file?h=37785162&i=9461404]]   [[最新版はここから>https://www.patreon.com/posts/illusion-overlay-37785162]]
  衣服や身体に任意のテクスチャを貼れるようになるMOD。
  このMODも導入しないとUncensorSelectorが動作しない為、必須。
#br
#br
- 導入方法
+KKS_UncensorSelector.v3.11.5.zipを解凍する
中身のBepInExフォルダとmodsフォルダをKoikatsuSunshineフォルダ内へ上書きする
#br
+UncensorSelector用zipmodを''解凍しないまま''modsフォルダに入れる
#br
+DeathWeaselKKSSoS_Dick_v1.3.zipmodを''解凍しないまま''modsフォルダに入れる
#br
+DeathWeaselKKSColor_Matching_Balls.zipmodを''解凍しないまま''modsフォルダに入れる
#br
+KKS_OverlayModsを解凍し、中身のBepInExフォルダを上書きするようにコピーする
#br
+キャラメイクを起動して確認する
#br
#br

- 適用方法
Defaultはキャラ毎に各性器MODからランダムで割り当てた自動表示になっています。
--''各キャラ個別に種類指定''したい場合
MOD適用に成功していれば、キャラメイク画面を開き、ボディアイコン→全体で左の下の方に「Uncensor Selector」の項目が現れるのでDefaultから変更したい性器MODを指定してキャラ保存しなおします。
#ref(./114514.JPG,48%)
#br
--''性別全体で種類指定''したい場合
ランダムではなく全員一括の種類に固定したい場合はキャラメイク、もしくはスタジオ画面でF1キーを押すとオプション画面が現れるのでその左下に追加された「plugin settings」タブを開くと各種プラグインの設定ができます。
下の方に「UncensorSelector」の項目があるので[Default female body]をランダムから表示させたいMODに変更します。枠外クリックで終了。(男性も同様に変更可能)
#ref(./sa001.JPG,33%)
#br
--''ランダムだがある程度の種類指定''をしたい場合 
全種類からのランダムではなくランダムから選択して特定の無修正を除外する機能があります。
これによりスジマン系で揃えたい人や、もしくはビラマン系の任意の種類に固定したい場合などシュチュエーションに応じて簡単に対応出来るようになっています。
Random Exculudedのfamale Bodyをクリック、別枠のUncensorSelector To Exculude For Famale Bodyで除外したい種類にチェックをいれてDoneします。
#br
//-------------------------------
**無修正化するとSEX時に棒が貫通するんだけど? [#e126de76]

仕様です。
MODで棒を変更することで発生しているため、以下のMODで貫通を防げます。
棒に関連するMODも併記しておきますので、個人の用途に応じて必要なものだけ導入してください。


--KKS_BetterPenetration.zip (4.4.0) [[Download>https://github.com/Animal42069/BetterPenetration/releases/download/4.4.0/KKS_BetterPenetration.zip]]  [[最新版はここから>https://github.com/Animal42069/BetterPenetration/releases]]
  棒の貫通を防ぐ。棒に対応した「くぱっ」と開く女性器も追加。(キャラメイクで選択式)

--KKS_ModBoneImplantor_v1.1.1.0.zip   [[Download>https://github.com/IllusionMods/ModBoneImplantor/releases/download/v1.1.1/KKS_ModBoneImplantor_v1.1.1.0.zip]]  [[最新版はここから>https://github.com/IllusionMods/ModBoneImplantor/releases]]
  ''BetterPenetrationを入れる場合はこちらも必須。''
  無修正Mod、衣類、アクセサリー用に、キャラクターのボディにボーンを追加できるようになるMOD。
  壊れた(地面に伸びた)服を見た場合、このプラグインが入っていないことが原因かも。

--KKSPE.dll   [[Download>https://mega.nz/folder/7fwkFD4I#mk4btjdyVwTLeeJNbn3vUw/file/SaZSXJxY]] 
  スタジオで「くぱっ」させたい人向け。

--KFutaBoy_Modpack_for_Koikatsu_Sunshine_v2.7z  [[Download>http://mods.anime-sharing.com/public/futaboy/KK/FutaBoy_Modpack_for_Koikatsu_Sunshine_v2.7z]] 
  女性の「ふたなりボディ」を追加。(キャラメイクで選択式)

// 2021/10/23時点の情報として次にBP(ver4.4.0)を導入した場合のスカートと棒のDynamicBoneColliderの干渉問題についてを追記。
// 将来的に当該の問題が解消されたら消して下さい。
// 問題の詳細についてはBPとUncensorSelectorのGitHubでIssuesから確認して下さい。

- ''BetterPenetration(BP)を導入したらスカートに変な膨らみができるんだけど?''
-- 今の所は仕様です。詳細は省きますがUncensorSelectorとBPを組み合わせた時に発生するダイナミックボーンコライダーの読み込みや干渉に関する現象です。
暫定的な解決方法としてはプラグイン設定からUncensorSelectorの項目でデフォルトの棒を”Mosaic 〇〇”のようなボーンを持たないものにすれば良いです。
上記でうまくいかない場合はキャラメーカーでABMXを使ってcm_J_dan101_00のZ軸のスケールを0にする等、棒とスカートのボーン同士が干渉しないようにして下さい。

#br
//-------------------------------
**DLしたzipmod形式のMODを入れたい [#v4b7fff4]
上記「BepInExを導入したい」に従い、BepInExを導入することにより、zipmodの読込に使われるSideloaderというBepinプラグインが導入されます。
あとはインスコ先のKoikatsuSunshine(InitSetting.exeのあるフォルダ)の「mods」フォルダ(なければ自分で作成)の中に拾ってきたzipmodを「.zip」または「.zipmod」形式のまま放り込めばMODとして認識します。

-zipmodは「mods」というフォルダの中にさえ入っていれば認識されるのでその中で管理がしやすいように用途や作者別などフォルダ分けすることも出来ます。
HFパッチなどではmodsフォルダ内にあらかじめ作者別などでまとめられているので新たに追加した場合も同じ作者のフォルダでまとめたほうが管理がしやすいかもしれません。

-髪型や衣装などのzipmodを導入した場合はキャラメイク画面で追加されています。
-スタジオマップはマップの追加になければアイテム扱いでアイテム→作者別→で追加されてるものもありますのでそちらも見てください

なお、機能追加系のMODはzipmodの追加だけでなく独自のプラグインの追加も必要な場合があります。配布先や同封物に必ず「指定」がありますので注意して導入するようにしてください。
#br
//----------------------------------------------------------------------
**拾ってきたキャラカードがきちんと表示されずなんか変なんだけど? [#d32613e0]

もとのキャラカードに使われている髪型や衣装のMODを自分が入れていないとそのぶん表示が欠けるためおかしくなります。
MessageCenterで足りないMOD名が表示されている場合はDiscord等で自分で探していれるか、主要な髪型や衣装をまとめたMOD集であるHFパッチがあるので、入れると表示されるかもしれません。
(MessageCenterの配布先については本ページか[[MODプラグインもろもろ]]を参照。使用時はオプションでEnableになっていることを忘れず確認)

とりあえず下記後述の「HFパッチ」を入れておけばなんとかなる場合がありますが、大前提として、キャラカードそのものに顔パーツや衣装自体のテクスチャデータは含まれておらず、あくまで「ID○○のパーツを使う」という参照先だけが記録されているため、配布者が使用したMODを自分でも持っていなければ、キャラクターは完璧に再現されないと思ってください。
そのため配布者がどのMODが使っているかがわかれば、それに沿ったMODを探して導入したほうが再現確実なのは言うまでもありません。
なお現状出回っているキャラの殆どが前作コイカツ用であり、髪型や衣装MODもコイカツ用をサンシャイン用に変換したもので対応することができます

//---------------------------------------------------------------------
** キャラメイクのスライダー幅を0~100よりも拡げたい - SliderUnlocker[#e38d1c49]
上記「導入の下準備をしたい(BepInExを導入したい)」を実行してください。最大500まで可能。

//-------------------------------
** 動作を最適化したい - IllusionFixes [#nce33e67]
先にBepInExの導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

+[[https://github.com/IllusionMods/IllusionFixes/releases]]でIllusionFixesをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+判りやすいところとして、キャラメイクでスペースキーを押した時のUI表示/非表示が劇的に速くなっているはず。16GB以上推奨、メモリ32GB以上で更に爆速に?
+他にどのような効果があるかは[[MODプラグインもろもろ]]を参照

//-------------------------------
** キャラメイクで編集可能な身体の部位を増やしたい - ABMX [#i0bf8dd3]
先にBepInExの導入を完了しておいてください。

+[[https://github.com/IllusionMods/IllusionModdingAPI/releases]]でIllusion Modding APIをダウンロード (上記無臭化が済んでいれば導入済)
+[[https://github.com/ManlyMarco/ABMX/releases]]の「Download」を押した先でABMXをダウンロード
+それぞれの解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+キャラメイクを立ち上げ、顔カテゴリに「Head」や「Upper Eyelashes」といったサブカテゴリが表示されていれば導入成功
+ついでに画面右下「Split XYZ scale sliders」をONにしておくとより細かく設定ができる

◇補足
更に「Advanced Bonemod Window」をONにすると灰色の小窓が開かれます。
ここではパーツ指定で拡縮・移動・角度付けができるようになっており、例えば「Search」欄に「hairf((Hair Front、つまり前髪を示すパーツ))」と入力→その下のパーツ候補から「ct_hairF」を選択すると前髪パーツをアクセサリと同じようにサイズ調整できるようになります。

//-------------------------------
** 衣服や身体に任意のテクスチャを貼りたい - Illusion Overlay Mods [#if04634f]
先にBepInEx、Illusion Modding APIの導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

+[[https://github.com/ManlyMarco/Illusion-Overlay-Mods/releases]]の「Download」を押した先でIllusion Overlay Modsをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+キャラメイクを立ち上げ、顔カテゴリに「Iris Overlays」、体カテゴリに「Skin Overlays」が、任意の衣服に「Overlay textures」段落が表示されていれば導入成功
+「Get ~ overlay template」や「Dump original texture」といったボタンでオリジナルテクスチャがPCにダウンロードされるので、それをベースにペイントソフトで編集、「Load new texture」で読み込んで使う

//-------------------------------
** zipmod形式の衣装やアクセサリ、髪型のMODを導入したい - XUnity.ResourceRedirector [#i0ab9a9f]

先にBepInEx、BepisPlugins(Sideloader)の導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

+まずは[[https://github.com/bbepis/XUnity.AutoTranslator/releases]]でXUnity.ResourceRedirectorをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+KoikatsuSunshine.exeのあるフォルダに「mods」というフォルダを自分で作成する
+入手してきたzipmodを「mods」フォルダ内に入れる
+キャラメイクを立ち上げ、髪や衣服など対応するカテゴリにアイテムが表示されていれば導入成功
※XUnity.ResourceRedirectorに翻訳機能を付加したものがXUnity.AutoTranslatorになります。間違えてAutoTranslatorを導入してきちんと設定しないと「なにもしないのに全部英語になりました」と赤っ恥をかくので注意してください。

//-------------------------------
** もっと細かく見た目を調整したい - MaterialEditor [#l5242bd0]

先にBepInEx、BepisPlugins、Illusion Modding API、XUnity.ResourceRedirectorの導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

//[[https://github.com/IllusionMods/KK_Plugins]]の右カラム「Releases」から最新のKKS_Plugins.batch.zipをダウンロード
//Koikatsu Sunshine\BepInEx\plugins フォルダ内に「KKS_Plugins」フォルダを作成し、解凍したフォルダの中身をコピーする
+[[https://github.com/IllusionMods/KK_Plugins]]の右カラム「Releases」から最新のKKS_MaterialEditor.zipをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+キャラメイクを立ち上げ、顔>全体に「Material Editor」から始まる3種のボタンが表示されていれば導入成功
+詳細な使用方法はやや複雑なため、自身で試してみたりググったりしてみましょう

//-------------------------------
** 着衣・下着・全裸での乳の大きさを個別調整したい - Pushup [#n6fe77c8]

先にBepInEx、BepisPlugins、Illusion Modding APIの導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

//前項MaterialEditorの手順1~2を実行
+[[https://github.com/IllusionMods/KK_Plugins]]の右カラム「Releases」から最新のKKS_Pushup.zipをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+キャラメイクを立ち上げ、衣服カテゴリに「Pushup」というメニューが表示されていれば成功

◇補足
PushupウインドウではTop(着衣)/Bra(下着)のラジオボタンを選択→Enabledをチェックしてから設定していきます。
上部5ゲージで簡易的に設定してもよいが、Advanced Modeにチェックを入れて「Copy Body~」ボタンを押下すれば全裸時パラメータを元に細かく設定することが可能。

//-------------------------------

** チートしたい - CheatTools [#w2619399]

先にBepInEx、BepisPlugins、Illusion Modding APIの導入を完了しておいてください。(上記無臭化が済んでいれば導入済)

+[[https://github.com/ManlyMarco/RuntimeUnityEditor/releases]]からRuntimeUnityEditor_BepInEx5をダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+[[https://github.com/ManlyMarco/IllusionCheatTools/releases]]からKKS_CheatToolsをダウンロード
+解凍したフォルダの中身を、BepInExフォルダを上書きするようにコピーする
+ゲームを立ち上げ、Pauseキー(or F12)を押してメニューが表示されれば成功

本編を進めてなくてフリーHの体位が少ないという場合もこれで解除できます

//-------------------------------

**前作コイカツ用のzipmodを使う方法 [#k416d0dc]

コイカツ用zipmodは、ゲームシステムに関わらないもの(服や髪型、アイテムなどの小物等)なら、たいていサンシャインでも使えます。しかし、zipmod内部のmanifest.xmlに「<game>Koikatsu</game>」と指定されている場合は前作専用のため手作業で削除修正が必要です。また修正しても元からサンシャイン未対応だったりで''必ず動くわけでありません''ので留意してください。*.zipmodの修正手順は以下のとおりです。
無印コイカツ用zipmodは、ゲームシステムに関わらないもの(服や髪型、アイテムなどの小物等)なら、たいていサンシャインでも使えます。しかし、zipmod内部のmanifest.xmlに「<game>Koikatsu</game>」と指定されている場合は前作専用のため手作業で削除修正が必要です。また修正しても元からサンシャイン未対応だったりで''必ず動くわけでありません''ので留意してください。*.zipmodの修正手順は以下のとおりです。

+ 拡張子を.zipmodから.zipにリネームする
+ .zipを解凍(展開)する
+ 解凍ファイル内のmanifest.xmlをテキストエディタ(メモ帳でもよいがうまくいかない場合がある)などで開き、「<game>Koikatsu</game>」という行を削除して保存する
+ 解凍したファイルをもう一度圧縮する
--再圧縮する際、zip内部にフォルダ階層を作らないように注意。manifest.xmlはzip内のルートに存在している必要があります。
OK例 \なんとか.zip\manifest.xml
NG例 \なんとか.zip\なんとかフォルダ\manifest.xml←再保存のときに二重フォルダになってしまうと動かない
+ 出来たzipファイルを「/KoikatsuSunshine/mods/」フォルダー内にコピーして動作確認をします
+ 無事に認識できたら圧縮ファイルの拡張子を.zipから.zipmodに変更して終了です

---modsフォルダごと一括で置換更新してくれるツールがあります
''[KKS] UpdateZipmodManifest v0.1.0 ''  [[3D(エロ)ゲームうぷろだ>http://uppervolta-3d.net/]]からILLUSION関連うぷろだ→upillusion0462.zip
使い方は同封のreadme.mdをメモ帳などで開いて読んでください

#br

**前作コイカツとzipmodの格納フォルダを共有するには [#jce09087]

-コイカツとコイカツサンシャインは各自modsフォルダ内にzipmodを入れて重複した状態になっていますが、基本的に同じMODであるためサンシャイン側からコイカツのmodsフォルダを参照(またはその逆)して利用することが出来ます
--1.サンシャインのゲームかスタジオを起動してF1キー→(「plugin settings」タブ)でsideloader16.xxの設定を開いて「Additional mod directory」の記入項目に参照するコイカツのmodsフォルダまでのディレクトリパスを入力します。(例 C:\illusion\Koikatu\mods)枠外クリックで終了
--2.サンシャインのmodsフォルダを変名、または退避させるなどして無効にし、サンシャインを起動してみます。無修正などのMODが有効になっていれば取りまとめ成功です。
--3.ただしコイカツ用のMODの中にはサンシャインで不具合が出たり動かないものもあるので自分で原因を調べる必要があります。(現時点では[Misc]Default Character Translation.zipmodや[stinger722]boobs_outline+unc_outline.zipmod、[moderchan]Tongue Texture v1.1 + Outline Fix.zipmod、[KK]Face Fixes v2.0.zipmodなどが報告されています
#br

**前作コイカツ用のMOD利用キャラを使う方法 [#offf7b82]

無印コイカツ用キャラカードは、サンシャインのキャラフォルダに入れれば自動的にサンシャイン用のキャラに変換されますが、MODでアクセサリスロットにアイテムで髪型などを再現しているキャラはMOD未導入の環境では当然アイテムIDがずれて意味不明なアイテムに変換され再現されないケースが殆んどでした。

MODのKKS_MoreAccessories_v2.0.6.zipよりズレが修正されていますので、MOD未導入(もしくはKKS_MoreAccessories_v2.0.6以前の環境)で変換されたカードは一度消去して、v2.0.6以降か、最新版が採用されている下記HF Patchなどで再度コイカツ用のカードから再変換することで無印コイカツと同じくほぼ正常に再現されるようになります。もちろん手持ちに採用MODを導入していないと再現されませんし、最新HFで再現確率はかなり上がりますが完全ではないので妥協は必要です。
//(スタジオは未対応で読み込み出来ないようです←2.0.7で対応?
[[最新版はここから>https://github.com/jalil49/MoreAccessories/releases]]
#br

**HF Patchとは [#r6e59d26]  
不定期更新のMODオールインワンパック。''HF Patch自体はMODではなく、MODをまとめて導入するためのパッチファイル''であり、Discordで情報展開される。
大量のMODが1度で導入できるのでわかってる人が使うにはMOD環境の再構築などにとても便利です。利用者が上手に使えばあちこち収集することなく簡単に新しめの主要MOD環境が定期的に構築できる大変ありがたいパッチであることは言うまでもありません。が、なにもわからない初心者が「簡単なら」と手を出すと不具合の種にもなりますので注意してください。
初心者の場合は、わからない人(初心者)が、わからないまま(MOD体験なし)、わからないもの(相性がよくわからないMOD詰め合わせ)を入れることになるため、なにかトラブルが起きてもまず対処できなくなる。最悪ゲームごとインストールし直しということもあるので覚悟してください。
できれば上記「BepInExを導入したい(基本MOD)」と「無修正化(ZIPMOD方式)現状はこちらがおすすめ」を読んで「手動で無臭化」に一度挑戦してみてください。MOD導入の簡単なチュートリアルも兼ねていますし、BepInExの基本ファイルを入れ替えることで追加MOD導入時のトラブル対処のスキルにもなります。最低限自力で無臭化を体験した上でHFパッチを当てたほうがMOD導入の理解が深まると思います。

-''長所''
--個別にMODの情報を追わなくても「次へ」を押して画面を進めるだけで定期的にバージョン毎に最新のほとんどのMODが導入される
//---つまり以降の「目的別導入手順」を読む必要が基本的になくなる
-''短所''
--&color(red){''100%''};予想してないMODも一緒に導入される。&color(red){''絶対に''};思ってもない機能が追加されるし、&color(red){''必ず''};予想外の挙動が発生する
---「これ入れれば無修正になるのか!」と全裸で飛びついた後「何か変になりました……」と5chや当掲示板に泣きつくのはよくある話
---そういう場合質問しようにも「元がどういう環境だったか」「何を入れたのか」「何が起きたのか」がちゃんと理解できていないため、聞いている方もほとんど解決できない
-''その他注意点''
--基本的にデフォルトでは現状で構築されているMOD環境は削除されるので要注意。これはMODを新しくしたことで既存MOD同士の干渉や不具合を避けるため、HF Patchに規定されたMOD以外を削除して環境を統一することを目的としてるので、パッチを当てる前に現状のMOD環境は必ずバックアップしておいたほうがよい(消されたものは戻せないので)
--HF PatchやKKManagerを更新する際など、消されたくないMODがあればKoikatsuSunshine\mods\MyModsに入れるようにしておけばMyModsフォルダ内は不可侵なので残るとされているが、普通に消されたりするバグなど万が一があるのでやはりバックアップに勝るものなし、である

まとめると、HF Patchを使って不具合が起きたとしてもそれは''環境起因か注意不足によるもの''であり、必ずしも期待通りの結果が得られるとは限らない(何か起きても自力で解決できないことなら諦める)覚悟が必要となる。
また、これらのことからHF Patchを当てたことに関する''質問行為自体が拒否される''傾向が強い。


他にも、HFPatchを使って失敗するのは多くが初心者であるため、トラブルを伝えてもMODに慣れた人はそんな事象は起きていないので答えられないという構図もある。
//(更にいえば''慣れた人ほどHFPatchなんて使っていない''という事情もある)どこ情報?
とにかく何かあっても人に聞くより前に本ページの「よくある質問」などを読んで、自身でトラブルシューティングを行った方が良い。


''▼導入方法''''(無印コイカツのHF PatchとはPatch自体が別物なので間違えて無印版を入れると動きません)''
--HF Patch for KKS(最新版) https://www.patreon.com/posts/87628038
---(クロームブラウザの日本語自動翻訳で概要を読んでおくのがおすすめ)

--HF Patch for Koikatsu Sunshine    https://github.com/ManlyMarco/KKS-HF_Patch/releases
旧バージョンは各バージョンのところに記載されてる「magnet:?xt=urn:btih:XXOO~」とある文字列をまるごとコピペしてトレントソフトに貼り付ければOK

原則として公式パッチの更新が終わったHFv1.7以降を推奨。(1.6以前は内蔵されてる公式パッチが古いためHF Patchで最終上書きするとゲームVerが巻き戻りそのままだと不具合がでます。ゲームのVerはV1.14が最終です。それより若い場合は最後に公式最終の全部入りパッチで上書きしないと不具合がでます)

配布URLに遷移し、マグネットリンクを利用して、qBittorrentまたは同様のトレントソフトを使ってフルファイルバージョンをDLしましょう(マグネットリンクやトレントソフトの導入方法などは各自で調べること)
現状ここで触れられる導入方法はトレントソフトのみなので、ソフト導入に抵抗のある方は諦めて個別導入してください

「Koikatsu Sunshine HF Patch vx.x」(x.xはバージョン名)フォルダの中に「Koikatsu Sunshine HF Patch vx.x.exe」および、「~-1.bin」「~-2.bin」「~-3.bin」の3つのbinファイルがあることを確認したらexeファイルを起動

その後は基本的に日本語設定で「次へ」を押し続けるだけです(''詳細はコイカツwikiを参照して下さい'' 注意する事項は同じです)
-「コンポーネントの選択」画面では「推奨インストール」で良いですが、それでも先述の通り確実に知らないMODまで一緒に入るので、初心者は覚悟しておいてください
-「情報」画面では導入したMODの簡単な説明(英語)と、個別の配布ページURLが一覧表示されます。一応メモ帳にコピーしておくと簡易説明書になるのでおすすめです

「HF Patch for Koikatsu Sunshine セットアップウィザードの完了」画面まで行けば完了です
ゲームを起動し、純正とは異なるイリュージョンランチャーが立ち上がり、ランチャー画面右下ににHF vx.xと表示されていれば成功しているとみて良いでしょう

-''HF Patchって最新版入れとけば間違いないよね''

残念ながらそんなことはないのです。HF PatchはいろいろなMODの詰め合わせなので推奨インストールでなるべく不具合(バグ)が少ないようにある程度調整はされているのですが、バージョンによっては不具合(バグ)だらけのままリリースされている例が今まで多々あります。

要はバグや不具合を許容できる範囲は個人差がかなり大きいので、新バージョンの不具合に個人的に納得できなければ旧バージョンに巻き戻す人は多々いますし、
それらが不具合報告として各モッダーにフィードバックされて改善されれば次バージョンリリース、しかし新しいさらなる不具合、で堂々巡りがMODの世界なのです。
完全なバージョンのHFパッチは有りませんが、自分ならこのバージョンなら許容できるというお気に入りのバージョンを見つけられれば良いのですが。(ということで最新版以外、余裕があれば一つ二つ前のHFパッチもDLして導入して比べてみることもおすすめします)
-''「ゲーム更新」 KKManagerの罠''にご注意

更新すると良いことがあるのじゃないか、KKManagerで自動でアプデしてくれるなら、と安易に更新ボタンを押すと「終了まで○日〇〇時間」という激遅の更新地獄に落ちて嘆く方が散見されます そのアプデ本当に必要ですか??(笑)
某個人鯖に全世界からDLが殺到するので当然速度は出るはずがありません
必要なMODは個別に落としたほうが断然早いですし、パッチに収録されてないMODはマップMODなど大きい容量の割に使用頻度が少ないものだから外されてるのです
#br
-「HF Patch」はトレントでしか導入できないの?
元は海外のHongFire.com内でのMODのコミュニティでイリュの歴代作品ごとに個々に発表されるMODを有志が「まとめてオールインワンでインスコできるよう」に改造したものが代々「HongFire.Patch(通称 HF Patch)」としてその都度配布されていたものが本来の経緯です。
当初は無臭プラスアルファの改造でせいぜい数十~数百メガまでだったため任意のアプロダにUPされたものを各自がそれぞれDLして導入することで事足りていました。(2000年代~)
//手持ちのHFパッチの一番古いものが「らぶデス」(2005)でした
しかし時代ともにMODファイルの容量はどんどん増え続けギガバイトサイズまで膨れ上がりました。
転機としては2020年の春頃まではギガバイトサイズでも大容量アプロダのmegaなどにUPされてそれぞれDLしていたのですが、フリーユーザーは1回線で6GBまでの転送制限があり一度にそれ以上のDLができないという苦情が出始めました。同じくしてmegaでもロリ規制?のせいかコイカツHF Patchがmega運営に頻繁に削除されるようになり、配布側の苦肉の策としてトレントの導入が取られるようになったという経緯があります。((具体的には無印コイカツのHFpatch3.0頃の話で、メガでHFパッチが頻繁に削除されるようになり安定した配布が不可能にになったため、事前ファイルを200MBほどDLして残りのパッチ分を8GB分をマルコ鯖からDLするという試験的な方式が一時期取られましたが、当然全世界からDL殺到して鯖パンク、苦情殺到ということになり初期のKKManagerと同じ結末に。KKManagerはネジ氏の鯖ですが同じようにP2P形式に変更されています))

#br
なおトレントソフト自体は違法ではないのですが市場的にやり取りされる内容が違法データが多いためあまり良いイメージはありません。
ただ、トレント検索でよくある紹介サイトで「トレントは危険ですからVPN契約で安全に利用を」というのはリンクからのVPN契約で報酬を得ているアフィサイトの契約誘導詐欺なのでVPN契約はしないで下さい(HF PatchをDLするだけなら有料VPN契約はまったく意味ないです)
まれにユーザーの契約プロバイダの方針でトレントのP2P通信自体が完全ブロックされてHF Patchが全くDLできないプロバイダがありますが、そのときはVPNに課金するよりは直DLリンクに課金してDLしたほうが円安とは言え断然安上がりです。もちろん自己責任にはなりますが。(元々HF Patchの直DLリンクの課金はP2P通信が全ブロックされているヨーロッパ勢を救済するためと説明されています)
#br
--裏技としてはP2P通信の制限などでHFパッチの導入が困難な場合はKKManagerをうまく利用することでHFパッチを使わずに衣装や髪型やアイテムなどのmodsフォルダ内を最新にすることは出来ます(ただしBepInExなどのMODを動かすための基本機能系のものを自分でインスコしたりプラグイン等の準備が必要です)  ※KKManagerの場合はめちゃくちゃ時間がかかります。トレントの場合はP2P制限されてないプロバイダであれば光回線などでかかっても数時間でHFパッチはDLできます
---KKManager_v1.x.x.7z (x.xはバージョン名ですがその時点での最新版をDLして下さい) [[Download>https://www.patreon.com/posts/41869238]] 解凍したKKManager_v1.x.xフォルダをKoikatuSunshineフォルダ内にいれKKManager.exeをクリックで開始。(使い方はコイカツwikiのHFパッチのオプション参照)
#br

//--HFパッチ1.0でスタジオを使いたい場合はバニラにHFパッチ1.0(インスコ時にカスタムランチャーのチェックを外してインストール)、公式の全部入りパッチ、スタジオパッチの順であてたものに上記「BepInExを導入したい(基本MOD)」の各最新版とKKSAPI_1.26.zipやKKS_MoreAccessories_v2.0.7.zipを上書きすることで使えるようになります。
#br

----
* 体験版時点での主要MOD最終バージョン [#jb76abfd]
まず体験版でMODの効果を確認したいという人は以下を参考にしてください。
(以降更新によって体験版では機能しないということもあり得るため)
-BepInEx : 5.4.15
-BepisPlugins : r16.4
-IllusionFixes : 15.3
-KKSAPI : 1.21
-ABMX : 4.4.3
-Illusion Overlay Mods : 6.0.2
-MaterialEditor : 3.1.2
-Uncensor Selector : 3.11.2 


* ゲーム支援 [#k9d54f14]
-Dwarfize(ドワーフ化ツール)[[ILLUSIONうぷろだ>http://uppervolta-3d.net/]]----
-syncard(カード合成ツール)[[ILLUSIONうぷろだ>http://uppervolta-3d.net/]]----
-KKS/KKキャラ抽出改変(シーンからキャラカ抽出ツール)[[ILLUSIONうぷろだ>http://uppervolta-3d.net/]]----


* よくある質問 [#b1718d2b]

- ''ファイルが解凍(展開)できない''
--解凍(展開)ソフトは「7-Zip」(フリーソフト)か「WinRAR日本語版」(40日間の試用後もフリーで使える機能で十分です)での解凍をオススメします。
Windows付属の解凍ソフトやよく初心者に勧められているフリーソフトの「Lhaplus」「+Lhaca」などのLhasa系アーカイバはRARファイルに完全対応しておらず、解凍不良(解凍時にファイル抜けで中身がない)などのエラーや文字化けなどの不具合を起こすので使わないでください。
Windows付属の解凍ソフトやよく初心者に勧められているフリーソフトの「Lhaplus」「+Lhaca」、FANZA推奨の「LhaForge2」などのLhasa系アーカイバは海外勢のMODのデータファイル配布で主流であるRARファイル形式に完全対応しておらず、解凍不良(解凍時にファイル抜けで中身がない)などのエラーや文字化けなどの不具合を起こすので使わないでください。(PC初心者のMOD導入トラブルで一最初につまずくパターンのような気がします)
また、7-ZipやWinRARでもソフトverが古いままだと新しい7zやRAR形式で解凍エラーが出る場合がありますので、なるべく最新のものに更新して解凍してください。
--単純にファイルのダウンロードに失敗している可能性もあるので、質問する前に、別のブラウザから落とす事も試してみよう。

- ''MODファイルをゲームフォルダに置いたのに機能しない''
--「①DL時or解凍時のファイル破損」「②配置する場所が間違っている」「③相互作用するMOD同士のバージョンが食い違っている」「④BepInExに至るまでのフォルダ名に日本語が混ざっている」といった可能性がある。
①:再DLおよび再解凍で対処
②:配布場所の説明をよく読むなどして対処。どうしても解らず本Wikiで質問する場合は「何というファイル(フォルダ)をどのフォルダに置いたか」を明確に記載すること
③:MODによっては「ver.x.x.x以上の××MODが一緒に入っていないと動かない」ということがある。ほとんどの場合、配布場所に記載されているためそちらをよく読んで対処
④:ドライブ名含め、パスが半角英数字で構成されるようにすること

- ''複数のMODを入れたら不具合が発生したので何が原因か知りたい''
--怪しいMODをフォルダから削除→ゲーム再起動を繰り返せば原因になっているMODが突き止められる。
--単純な話、MODの導入=ゲームフォルダにMODファイルを入れる、である以上、MODの削除=ゲームフォルダから入れたファイルを消す、でしかないので特に難しいことはない。
--逆にこのWikiで「何かいっぱい入れたらおかしくなったんだけど何が原因ですか?」と聞いても人のPCの中身など知った事ではないため、原因が解らず終わることが多い。

- ''色々MODを入れていたら英語になった……''
--上の項目を元に自分で何とかしろという話だが、質問が後を絶たないため記載。ある意味「初心者狩り」の現象である。DLするファイル名をきちんと確認していれば起こらない問題なので質問してもだいたいスルーされる。
--結論的には間違えてXUnity.AutoTranslatorを入れてるのが原因なので対処法はBepInEx>plugins>XUnity.AutoTranslatorを消す。それだけ。想定外の動作が起きたら原因となるMODにあたりをつけて消せばよい、という手順を体感できるだろう。
--解決したら、今後は何でもかんでもまとめて入れるのはリスクを伴う行為だと認識のうえ、自力での解決を試みてみよう。

- ''発生した不具合がMODのせいなのかを知りたい''
--「BepInEx」フォルダの名前を適当に変える(BepInExaとか)だけでMOD無効状態(≒バニラ状態)にできる。それで起きるかを確認しよう。
--原因切り分けの初歩中の初歩なので、間違っても「こんな現象が起きたんだけどMOD入れたせい?」などと聞かないように。

- ''zipmod形式のMODを効率よく集めたいんだけどいいサイトある?''
--[[https://drive.google.com/drive/folders/1j1ZH7WunkEqvwr2YDLDF7JyutlzuyZDX]]に集積されている。あまりに大量にあるので「どれがどれだかわからない」という苦情は無しで。

- ''キャラメイクで瞳や髪色などを変えたのに再ロードすると元に戻ってしまう''
--恐らくMaterial Editorでテクスチャやカラーが直接設定されている。一時的には変更が反映されたように見えるが、Material Editorの設定は残りっぱなしなので読込時に再適用されてしまう。
例えば瞳なら、「目元」メニューでMaterial Editorを開き、「cf_m_hitomi_00」のMainTexなどをResetすることで設定を消去できる。

- ''githubから機能系のMODを落としたんだけど.dll形式じゃないしBepInExフォルダのどこに置いたらいいか解らない''
--落とすものが間違っている。恐らくソースコードを落としている。ダウンロードページ内に、どこから落とすべきかの手順説明や「Releaces」といった文字列があればそのあたりを見るべし。
--前提としてgithubは、複数のプログラマーがソースコードを一元管理するためのサービス。なので「MODの配布サイト」だと思って目立つところのリンクを踏んでも迷うだけなことがある。

// ''HFPatchはあるの?''
//2021/9/12 v1.0がリリースされました。詳細は続報を待つべし。
//→リリースされたため一旦コメントアウトしてみます

- ''MODって常に最新版にした方がいいの?''
--そうとは限らない。新しい方がバグが修正されたり、動作が最適化されたりすることは多いが、反対に「新たなバグが埋め込まれる」「処理を変えた結果他の既存MODと干渉して動かなくなる」「依存関係にあるMODとの関連が切れて動作しなくなる」ということもある。
--つまりMODを新しくしたせいで''手持ちのキャラクターがぶっ壊れる''ということも普通に起こり得るので、人によってはある程度MOD環境に満足したら以降は更新しない、という判断をする場合もある。
--勿論各種最新にしておかないと動かないMODというのもあるが、そのあたりの取捨選択は自分でするしかない。

- ''「無印にあった○○MODはまだ移植されてませんか?」''
--この質問は避けるようにしてください(複数人が不定期に質問しがちなのでログを流しやすい)。
--無印にあったMODであればMOD名が分かると思うので、「koikatsu (MOD名)」でググれば大抵出てきます。そのページに「KKS_」バージョンが無いなら、無いです。
--またサンシャインに既に存在するMODについては有志によって[[MODプラグインもろもろ]]ページにも情報がまとめられていますので、まずはそこを確認しましょう(このページに無いMODの情報をお持ちの方は是非編集してください)。
--ちなみに基本的には、コイカツ無印用に作られたプラグインがそのままサンシャインで使えることはありません。

- ''本編で女の子がハゲるor服が消えたり表示が変わったりする''
--「[[ForceHighPoly:https://github.com/IllusionMods/KK_Plugins]]」を入れるべし。もしそれでだめならそのMOD衣装は未完成品だったと思って諦めよう。

- ''股間や衣装が地面に向かって伸びる''
--「[[ModBoneImplantor:https://github.com/IllusionMods/ModBoneImplantor/releases]]」を入れるべし。それでだめならやっぱり諦めよう。

- ''本編だと動作するMODがスタジオや公式VRで動かない!''
-- そういうこともあります。スタジオや公式VRは本編とは別のソフトウェアなので、必ずしも互換性を保証していません。
-- というより、本ページ冒頭の通り、MODは動作に関するあらゆる全てを保証していません。善意のMOD製作者が直してくれるのを待つか、自分でMODを作りましょう。

- ''HF Patchを入れたらおかしくなったので解決してほしい''
-- 本ページの「HF Patchとは」項を熟読のうえ''諦めてください''。あなたにはHF Patchはまだ早かったということです。

- ''MODに関する困りごとを質問したいけどいい聞き方はある?''
--まずはこの「よくある質問」を読みましょう。ここを読めば解決する問題の場合、質問してもスルーされます。
--「おかしくなった」「変になった」「反映されない」と言った表現を避けよう
---「おかしい」「変」というのは起きた事に対する感想であって、現象ではありません。また「~されない」という表現は、「される以外の全てを示す」ため、回答者からすると原因どころか''そもそも話が伝わっていません''。事実として何が起こったのかを表現するように心がけてください。
---もちろん現象として「何も起きなかった」「一切の反応が無かった」ということはありますが、それでも「別のことなら起きた」「ある特定のMODまでは機能した」といった切り分けは可能なはずです。
--何をしたかではなくどこを押したかを書こう
---手順を書く際は画面上の何というボタンを押したかを書くようにしましょう
---これは例えば「キャラを読み込んだら~」のように「やろうとしたこと」を書いても、そもそも根底に勘違いがあり押すところを間違えていた、というケースがあるためです
---「○○MODを導入したのに~」といった場合も、入れるファイルや入れる場所を勘違いしているケースが多いので「(ファイル名).dllを○○というフォルダに置いたのに」と表現した方が回答が来やすいです
--「最新版」という表現はやめよう
---上記同様、それが本当は最新バージョンではなかったということがあります。仮に実際最新だったとしても質問の翌日にバージョンアップされた場合、質問が迷宮入りすることは想像できるでしょう
--「特定の~」なのか「すべての~」なのかを明確にしよう
---例えば一言に「キャラを読み込むとこうなる」と言っても、どのキャラでもなるならプラグインの問題かゲーム仕様が原因ですし、特定キャラでしか起きないなら高確率でそのキャラカードが原因です。こうした条件が不明確だと、正しい回答はほぼ不可能です。

// 暫定的によくある質問に追記という形で作成。何か意見があれば別セクションにするなりMODプラグインもろもろの方に移動するなり削除するなりして頂ければ幸甚。
- ''BepInExのコンソールとログについて - 導入したMOD(プラグイン)の動作状況の確認方法''
--MOD(プラグイン)を動作させるフレームワークであるBepInExにはプラグインの動作状況を表示・記録する為にコンソールとログの機能があります。
MODが機能しない場合にはコンソールやログを確認する事である程度は原因を絞り込む事が可能です。
''※コンソールやログに出てこない内容が原因の場合もあります。また、エラー等としてコンソールやログに表示されても実際には問題無い場合もありますので、''
'' 基本的にはゲームをプレイしていて何か問題がある場合や新しくMOD(プラグイン)を導入する際にコンソールやログで確認するといった使い方を推奨します。''
---他にもBepInEx.MessageCenterのプラグインを導入していればプラグインの動作状況(主にエラー等)をゲーム画面上に表示してくれますが、
いちいちスクリーンショットを取得したりメモするのは面倒という場合等はコンソールやログを使用するのがおすすめです。
--コンソール機能を有効にするにはゲーム上でコンフィグ(ショートカットキー:F1)->プラグイン設定(Plugin Settings)->BepInExの項目をクリックして展開。
Logging.Consoleの所にある有効(Enabled)の右隣にあるチェックボックスにチェックを入れて有効(Enabled)にします。
※”$(ゲームのインストールパス)\BepInEx\config\BepInEx.cfg”を直接編集してもOKです。
これにより次回以降、ゲームを起動する際に別ウィンドウでコンソールが開く様になります。
---プラグイン設定(Plugin Settings)ではログレベルも設定する事ができますが、よくわからなければデフォルトのままでOKです。
ログレベルを適切に設定すれば表示する情報を選択できるので、わかる人であれば絞り込みやデバッグの際に便利です。
---尚、コンソールのウィンドウはWindowsのコマンドプロンプト(ターミナル)と同様にタイトルバーを右クリック->プロパティで
フォントやレイアウトといった見た目等を変更可能です。
---余談ですが、コンソールのウィンドウを閉じるとゲーム自体も閉じられるので注意です。邪魔な場合はウィンドウを最小化するか、無効にしましょう。
--ログ機能はデフォルトで有効です。”$(ゲームのインストールパス)\BepInEx\LogOutput.log”に出力されます。
ゲームを起動する度に同ファイルが上書きされる為、必要なログがあれば適宜バックアップしましょう。
---”$(ゲームのインストールパス)\doorstop_config.ini”内で”redirectOutputLog=true”に設定すると”$(ゲームのインストールパス)\output_log.txt”に
ログがリダイレクトされます。こちらのログファイルはBepInExの設定内容(ログレベル等)に関わらず詳細な内容が記録されます。
(ちなみに海外のdiscord鯖であるKoikatsu!のhelpチャンネルでTechnician Chikarinボットが要求してくるログファイルはこの”output_log.txt”です)
---ログファイルはメモ帳等のテキストエディタで開く事ができます。Visual Studio Code等の多機能なエディタを使用するとログが見易くなるのでおすすめです。
--''よくあるMOD(プラグイン)が機能しない例''
ここではMOD(プラグイン)が機能しない場合にコンソールやログに表示されるメッセージの一例を紹介します。
尚、ここで紹介するもの以外にもエラー等のメッセージは沢山ありますが、切りがない為、割愛します。
エラーや警告として表示されるが実用上は何も問題ないもの等もあり、それらが表示されたからといって必ずしもゲームプレイ上で深刻な問題となるとは限りません。
ゲームをプレイしていて問題が無いのであればコンソールやログにエラーや警告があっても気にしない方が良いです。
---&color(red){''[Warning:   BepInEx] Skipping [ABC x.x.x] because of process filters (Koikatu, Koikatsu Party)''};
コイカツ無印専用なのでサンシャインではプラグインのロードがスキップされます。間違えて無印専用のプラグインを導入した時に出るメッセージです。
放置しても基本的には問題ないですがいちいちメッセージが表示されてしまう為、当該プラグインを削除する事を推奨します。
---&color(red){''[Warning:   BepInEx] Skipping [ABC x.x.x] because of process filters (CharaStudio)''};
スタジオ専用なので本編ではプラグインのロードがスキップされます。(逆に本編専用なのでスタジオではロードがスキップされるものもあります)
要するに何も問題はないのですが、ひとつ上の内容と類似するので差別化として記載しておきます。
---&color(red){''[Error  :   BepInEx] Could not load [ABC x.x.x] because it has missing dependencies: marco.kkapi (v1.25 or newer)''};
依存関係にあるプラグインが存在しない為、プラグインがロードできません。今回は例としてKKSAPIがない場合のエラーメッセージとしていますので、
解決策としては当該プラグインと依存関係にあるKKSAPI(GUID: marco.kkapi)のVersion1.25以降を導入する事となります。
※編集者の主観ですが、プラグインが全く機能しないという場合は大体このケースではないかと思います。
---&color(red){''[Info   :Sideloader] Skipping archive "ABC.zipmod" because it's meant for Koikatsu''};
コイカツ無印専用zipmodの為、サンシャインではzipmodのロードがスキップされます。詳しくは''「前作コイカツ用のzipmodを使う方法」''をご参照下さい。

-----
 
#pcomment(./コメント,50,reply)
//↓全部を赤文字にせずメリハリつけてみたバージョン
&size(12){&color(white,orange){ 注意 };};
&size(16){''※質問は本ページの''&color(Red){''「よくある質問」''};''を読んでから''};
&size(16){''※返信でコメントする際は、必ず当該コメントの左端にある''};&size(20){''○''};&size(16){''を選択して「●」にしてから投稿してください''};
&size(16){''※荒らし・煽りは厳禁''};

//↓過去あった注意書き
//※1ページあたりの表示ツリー数に制限があるため、関連する話題はできるだけツリーに対して返信してください
//&color(Red){&size(20){''既に投稿されているコメントに追加でコメントをする際は、''};};
//&color(Red){&size(20){''必ず当該コメントの左端にある、「''};};&color(black){&size(25){〇};};&color(Red){&size(25){''」をクリック又は選択''};};
//&color(Red){&size(20){''して「''};};&color(blue){&size(40){●};};&color(Red){&size(25){''」にしてからコメントしてください。ログは最新の''};};
//&color(Red){&size(20){''1ページあたりの表示ツリー数に制限があるため、''};};
//&color(Red){&size(20){''関連する話題はできるだけツリーに対して返信してください。''};};
//&color(Red){&size(20){既に投稿されているコメントにコメントをする際は、かならず当該コメントの左端にある、};};
//&color(Red){&size(20){「〇」を選択して「◎」にしてからコメントしてください(ログが流れてしまうのを防ぐ為です)。};};

トップ   編集 差分 バックアップ 添付 複製 名前変更 リロード   新規 一覧 単語検索 最終更新   ヘルプ   最終更新のRSS