カスタムオーダーメイド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.7.2.7z
• ModPriorityToMod_0001
• AutoConvertor 0.0.3.6
• BodyCategoryAdd_1.0.2
• DistortCorrect v0.4.0.2　※最新のReipatcherレス化プラグイン一式に同梱されるようになりましたので、別途ダウンロードする必要は無くなりました
• QuickEditStart_0.1.0.1
• ThumbSavePlugin_2.0.3

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

• ExPluginBase - Assets PluginExt.dll（dllそのままなので保存時に警告がでる可能性があります・UnityInjectorフォルダへ）

※ここのリンクは古いかもしれないので最新版はプラグインページや共用ろだ（CM3D2、COM3D2）を確認してください
※各プラグインに付いているReadme.txtにはインストール方法や使用方法などが書かれているので一度は目を通しておきましょう
　（.txtは読み込まれないのでdllと同じ名前にリネームして一緒に置いておくと良いかもしれない）
※ModLoader と ModPriorittToMod は同時にインストールすると高確立でゲームが起動できなくなるので、どちらか片方を選ぶ必要があります。
　COM3D2は両者とも使用できますが、COM3D2.5ではModPriorityToModのみ使用できます。

• Sybaris.AutoCompile_1.0.0.0

※CSファイルを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を追加導入し、両方のプラグインが動作するようにすることを目指す。

• 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. ゲームを起動し、タイトル画面まで行ったらそのまま終了する
8. BepInExフォルダ内のconfigフォルダにある「org.bepinex.plugins.unityinjectorloader.cfg」をテキストエディタ（メモ帳など）で開き、[Paths]の一番下の行の「UnityInjector = UnityInjector」を「UnityInjector = Sybaris\UnityInjector」に書き換えて上書き保存
9. ゲームを起動し、しばりす用プラグインが動作していれば成功

• 上記の手順は、上記2がBepInExのインストール、3と4がしばりす互換プラグインの導入、5と6がしばりす2のアンインストール、7と8がしばりす環境と互換性を持たせるための設定変更、となっている。
• 手順7は一見無意味に思えるが、これで手順8で編集するファイルが自動生成される（手順7を実行しないと手順8のファイルが無い）。
• 「削除」が不安ならいきなり削除せず、一度デスクトップなどに「移動」させるのがお勧め。これなら失敗しても戻せる。
• ネット上には「ゲームを起動するとBepInExフォルダ内にconfig.iniが自動で生成される」という解説があるが、BepInExバージョン5.xでは「configフォルダ内にBepInEx.cfgが自動で生成される」という動作になっている模様。
• BepInExの初期設定では、しばりす2で表示されていたコンソール（黒いログウィンドウ）は表示されない。表示したい場合は、BepInExフォルダ内のconfigフォルダにある「BepInEx.cfg」をテキストエディタで開き、[Logging.Console]の一番下の行の「Enabled = false」を「Enabled = true」に書き換えて上書き保存し、ゲームを起動すればOK。

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

BepinEx用のプラグインは、BepinExフォルダ内の「plugins」に置く。