カスタムオーダーメイド3D2改造wiki

• 改造は全て自己責任でお願いします。
• 改造に不安がある場合、ゲームのインストールフォルダを丸ごとコピーしておけば、何かあってもだいたい大丈夫。
  特にセーブデータ・プリセットはMODの影響を受けやすいです。メイドさんのためにも、こまめなバックアップを。
• 公式の規約を熟読したうえでMODを利用してください。
  • カスタムメイド3D2/カスタムオーダーメイド3D2 MOD規約
  • カスタムメイド3D2／カスタムオーダーメイド3D2 規約
• 原則、改造行為は「判る人向け」です。用語説明もサポートもありません。自分で試して・調べて・解決する心意気でどうぞ。

改造をする前に、次の点を確認しておく。

• ゲームをインストールしたフォルダ（COM3D2.exeがあるフォルダ。以下「インストールフォルダ」）の場所
• 改造なしの状態（通称「バニラ」）でゲームが動作すること

アーカイブファイル(.zipや.7z)を解凍できるソフトも用意しておく。

まず、MODを導入するためのMOD(前提MOD)を入れる。

しばりす2

ゲーム本体を書き換えずに非公式MODやプラグインを適用できるMOD（フレームワーク）。
リンク先からダウンロードしておく。

1. インストールフォルダを開く
2. ダウンロードしたしばりす2のzipを解凍し、zip内のSybarisフォルダとopengl32.dllをインストールフォルダに移動
3. （Modフォルダが無い場合はついでに作っておく）
4. ここでゲームを起動。ゲームと一緒にログウィンドウ（黒い画面）が表示されれば成功
   1. ログウィンドウにはインストールしたUnityInjectorプラグイン一覧やエラーなどが表示される
   2. 導入後、起動しなくなった場合は「管理者として実行」あるいはopengl32.dll及びCOM3D2.exeをウィルス対策ソフトの例外に設定することで回避できるケース有り

COM3D2（インストールフォルダ）
│  COM3D2.exe
│  〜その他いろいろ〜
│
│  opengl32.dll
│  
├─Mod
└─Sybaris
    │  COM3D2.UnityInjector.Patcher.dll
    │  ExIni.dll
    │  Mono.Cecil.dll
    │  Mono.Cecil.Rocks.dll
    │  Sybaris.Loader.dll
    │  UnityInjector.dll
    │  
    ├─GameData
    └─UnityInjector

例としてよく使われる しばりす用プラグイン・ReiPatcherレス化プラグイン一式・ExPluginBase を入れてみます。
あらかじめ上の前提MOD（しばりす2）を導入しておいてください。

• ModLoader - Assets COM3D2.Modloader_1.6.1.7z
• AutoConvertor 0.0.3.3
• ModPriorityToMod_0001
• BodyCategoryAdd_1.0.2
• Sybaris.AutoCompile_1.0.0.0
• DistortCorrect v0.4.0.2
• QuickEditStart_0.1.0.1
• ThumbSavePlugin_2.0.3

• ReiPatcherレス化プラグイン一式_190212

• ExPluginBase - Assets PluginExt.dll（dllそのままなので保存時に警告がでるかも・UnityInjectorフォルダへ）

※ここのリンクは古いかもしれないので最新版はプラグインページや共用ろだ（CM3D2、COM3D2）を確認してください
※各プラグインに付いているReadme.txtにはインストール方法や使用方法などが書かれているので一度は目を通しておきます
　（.txtは読み込まれないのでdllと同じ名前にリネームして一緒に置いておくと良いかもしれない）

1. インストールフォルダ（COM3D2.exeがある場所）に導入したSybarisフォルダを開く
2. ダウンロードしたアーカイブを解凍し、Sybarisフォルダ・UnityInjectorフォルダに各プラグインのReadmeに従ってファイルを配置していく
3. ゲームを起動して動作チェック（エディットモードでF5を押すなど）

Sybarisフォルダ
│  CM3D2.Toolkit.dll
│  COM3D2.AutoConverter.Managed.dll
│  COM3D2.AutoConverter.Patcher.dll
│  COM3D2.BodyCategoryAdd.Managed.dll
│  COM3D2.BodyCategoryAdd.Patcher.dll
│  COM3D2.DistortCorrect.Managed.dll
│  COM3D2.DistortCorrect.Patcher.dll
│  COM3D2.ExternalPreset.Managed.dll
│  COM3D2.ExternalPreset.Patcher.dll
│  COM3D2.ExternalSaveData.Managed.dll
│  COM3D2.ExternalSaveData.Patcher.dll
│  COM3D2.FastFade.Patcher.dll
│  COM3D2.MaidVoicePitch.Managed.dll
│  COM3D2.MaidVoicePitch.Patcher.dll
│  COM3D2.ModLoader.Managed.dll
│  COM3D2.ModLoader.Patcher.dll
│  COM3D2.ModMenuAccel.Hook.dll
│  COM3D2.ModMenuAccel.Patcher.dll
│  COM3D2.ModPriorityToMod.Patcher.dll
│  COM3D2.ProcScriptBinIgnore.Patcher.dll
│  COM3D2.QuickEditStart.Managed.dll
│  COM3D2.QuickEditStart.Patcher.dll
│  COM3D2.ThumbSave.Managed.dll
│  COM3D2.ThumbSave.Patcher.dll
│  COM3D2.UnityInjector.Patcher.dll
│  COM3D2.VoiceNormalizer.Managed.dll
│  COM3D2.VoiceNormalizer.Patcher.dll
│  ExIni.dll
│  Mono.Cecil.dll
│  Mono.Cecil.Inject.dll
│  Mono.Cecil.Rocks.dll
│  Sybaris.AutoCompile.Patcher.dll
│  Sybaris.Loader.dll
│  UnityInjector.dll
│  
├─GameData
└─UnityInjector
    │  COM3D2.AddModsSlider.Plugin.dll
    │  COM3D2.ConsistentWindowPosition.Plugin.dll
    │  COM3D2.DistortCorrect.Plugin.dll
    │  COM3D2.EditSceneUndo.Plugin.dll
    │  COM3D2.LogWindow.Plugin.dll
    │  COM3D2.MaidVoicePitch.Plugin.dll
    │  COM3D2.PersonalizedEditSceneSettings.Plugin.dll
    │  COM3D2.SkillCommandShortCut.Plugin.dll
    │  COM3D2.VoiceNormalizer.Plugin.dll
    │  PlanarRealtimeReflection.dll
    │  PluginExt.dll
    │  
    ├─AutoCompile
    └─Config
            MaidVoicePitchSlider.xml
            ModsParam.xml
            PersonalizedEditSceneSettings.ini
            VoiceNormalizerTable.txt

※ ReiPatcherレス化プラグイン一式のオプションフォルダに入っているdllは一つ上の階層に移動（有効化）させています
※ プラグインによっては導入後ゲームを起動するとConfigフォルダに設定ファイルが生成されます

プラグインの設定ファイルパスがSybaris\UnityInjector\Config以外を参照していても使用する場合の対応方法(無いとも限らないので復元）

シンボリック・リンクを使う

1. 管理者権限でコマンドプロンプトを起動する
2. mklink /d "作成するフォルダのパス" "元になるフォルダのパス"を指定　
   1. 例：mklink /d "C:\KISS\COM3D2\UnityInjector" "C:\KISS\COM3D2\Sybaris\UnityInjector"
3. C:\KISS\COM3D2\UnityInjector <<===>> C:\KISS\COM3D2\Sybaris\UnityInjector のシンボリック リンクが作成されました。と表示されればOK
4. 最後にシンボリックリンクが作成されたかを確認しましょう。

この方法だと別階層にアクセスリンクを置くので、既定の階層を参照するプラグインと別階層を参照するプラグインがあっても読み込む為管理しやすくなります。
また、シンボリックリンクはショートカットを新規に作るようなものなので削除する場合は直接リンクフォルダを削除するだけでOKです。

---

よくあるエラー

・コマンドの構文が間違っています。

ダブルクォートが全角だったり、スペースが全角だったり、または入っていない可能性があります。
※上記の例文をメモ帳にコピペして編集すればほぼ失敗は無いと思います。

・既に存在するファイルを作成することは出来ません。

シンボリックリンク(mklink)はいわば、ショートカットを新規に作るようなものです。
なので、同じ名前のフォルダがリンク元にあると上記のエラーになります。そのフォルダの名前を変えてください。
※当方何を勘違いしたのかリンク先(COM3D2フォルダ)に作成するフォルダを用意していたのが原因でこのエラーに悩まされました。(実際はコマンドプロンプトで名前を指定するだけなので事前準備不要)

参照元(https://ossan-gamer.net/windows-symbolic-link-mkli...

---

上記の手順を踏まえてCM3D2のMODをCOM3D2でも読み込むようにする方法　※全てのMODが使える訳では無いので注意（AutoConvertorプラグイン使用推奨）
スクリプト系(ks csv nei)は基本的に除外する。

シンボリックリンクの作成はコマンドでやる方法以外にもフリーソフトでいろいろあるので活用しよう。

（必要なフォルダのシンボリックリンクを一つずつ作成する手もあるのでお好みで）
事前にKISS\CM3D2\Sybaris\GameData内に任意のフォルダを作成し共用するMODを纏める。(同名のフォルダを指定出来ない為と識別しやすくする為)

1. 管理者権限でコマンドプロンプトを起動する
2. mklink /d "作成するフォルダのパス" "元になるフォルダのパス"を指定
   1. 例：mklink /d "C:\KISS\COM3D2/MOD/CM3D2共用" "C:\KISS\CM3D2\Sybaris\GameData\COM3D2共用"

「BepInEx」は、Unityゲーム用のプラグインなどのフレームワーク（しばりすと同じ「MODを導入するためのMOD」）。
これを導入することで、「BepInExを必要とするMOD」を利用できるようになる。
ここでは、しばりす2からBepInExに移行しつつ、しばりす用MODもBepInExプラグイン経由で動作するようにすることを目指す。

• BepInEx (本体) ※ COM3D2は64bitアプリなので「BepInEx_x64_*.*.*.*.zip」をダウンロードする
• BepInEx.UnityInjectorLoader
• BepInEx.SybarisLoader.Patcher

1. インストールフォルダを開く
2. BepInExのzipを解凍し、zip内のすべて（BepInExフォルダ、changelog.txt、doorstop_config.ini、winhttp.dll）をインストールフォルダに移動
3. BepInEx.UnityInjectorLoaderのzipを解凍し、zip内のpluginsフォルダをBepInExフォルダの中に移動
4. BepInEx.SybarisLoader.Patcherのzipを解凍し、zip内のconfigフォルダとpatchersフォルダをBepInExフォルダの中に移動
5. Sybarisフォルダの中にあるExIni.dll、UnityInjector.dll、Mono.Cecil.dll、Sybaris.Loader.dll、COM3D2.UnityInjector.Patcher.dllを削除
6. ゲームのインストールフォルダにあるopengl32.dllを削除
7. ここでゲームを起動。ゲームが正常に起動し、しばりす用MODが動作していれば成功

• 一気に書かれているが、内容的には、上記2がBepInExのインストール、3と4がしばりす互換プラグインの導入、5と6がしばりす2のアンインストール、となっている。
• 上記の「削除」は、そのフォルダから出せばよい。不安ならいきなり削除せず、一度デスクトップなどに「移動」させるのがお勧め。これなら失敗しても戻せる。
• 上記でうまくいかない場合、Sybarisフォルダの中にあるUnityInjectorフォルダをインストールフォルダに移動（1階層上に上げる）と動作する。
  • BepInEx環境におけるUnityInjectorフォルダの場所は、BepInExフォルダ内のconfigフォルダにある「org.bepinex.plugins.unityinjectorloader.cfg」で指定されている。
    このファイルをテキストエディタ（メモ帳など）で開き、[Paths]の一番下の行の「UnityInjector = UnityInjector」を「UnityInjector = Sybaris\UnityInjector」に書き換えて上書き保存すれば、UnityInjectorフォルダをSybarisフォルダの中に入れたまま（しばりす環境と同じ状態）にできる。
• ネット上には「ゲームを起動するとBepInExフォルダ内にconfig.iniが自動で生成される」という解説もあるが、BepInExバージョン5.xでは「configフォルダ内にBepInEx.cfgが自動で生成される」という動作になっている模様。

COM3D2（インストールフォルダ）
│  COM3D2.exe
│  〜その他いろいろ〜
│
│  changelog.txt
│  doorstop_config.ini
│  winhttp.dll
│  
├─BepInEx
│    ├─cache
│    ├─config
│    │  　SybarisLoader.cfg
│    │  
│    ├─core
│    │  　0Harmony.dll
│    │  　0Harmony.xml
│    │  　0Harmony20.dll
│    │  　BepInEx.dll
│    │  　BepInEx.Harmony.dll
│    │  　BepInEx.Harmony.xml
│    │  　BepInEx.Preloader.dll
│    │  　BepInEx.Preloader.xml
│    │  　BepInEx.xml
│    │ 　 HarmonyXInterop.dll
│    │  　Mono.Cecil.dll
│    │  　Mono.Cecil.Mdb.dll
│    │  　Mono.Cecil.Pdb.dll
│    │  　Mono.Cecil.Rocks.dll
│    │  　MonoMod.RuntimeDetour.dll
│    │  　MonoMod.RuntimeDetour.xml
│    │  　MonoMod.Utils.dll
│    │  　MonoMod.Utils.xml
│    │  
│    ├─patchers
│    │  　BepInEx.SybarisLoader.Patcher.dll
│    │  
│    └─plugins
│ 　　   　└─UnityInjectorLoader
│　　　　　　　 　BepInEx.UnityInjectorLoader.dll
│　　　　　　　　 ExIni.dll
├─Mod
│
└─Sybaris
　    │  Mono.Cecil.Rocks.dll
　    │  〜その他いろいろ〜
　    │ 
　    ├─GameData
　    │
　    └─UnityInjector