Skip to content

Latest commit

 

History

History
245 lines (164 loc) · 9.78 KB

README.md

File metadata and controls

245 lines (164 loc) · 9.78 KB
Raw

COM3D2.CameraUtility2.Plugin

Based on CM3D2.CameraUtility.Plugin fork by Milly (https://github.com/Milly/CM3D2CameraUtility.Plugin). Ported to use BepInEx directly (instead of loading via Sybaris).

This version mostly adds fixes and QOL that I want, but this will probably no longer work with the original CM game so this probably cannot be merged back anymore.

Status

Currently a work in progress

Features

This updated plugin mostly retains the functionality of the old CM3D2.CameraUtility.Plugin version 2.3.4.0. The following features/changes were added:

ConfigurationManager support

This plugin's settings now use the BepInEX configuration library. You can now edit/change configuration by using ConfigurationManager (if you have that installed with CMI) by hitting F1 in game.

In addition, the individual modules of this plugin can now be optionally turned off if you don't need their functionality (e.g. you don't need ex camera controls, but need everything else).

Automatic first-person camera entry/exit

If first person camera is toggled on, you will now switch back out if the player character disappears automatically. Previously you'd get stuck on a random location/view or fly across the stage, but now it should properly go back to regular camera using the correct location/angles.

In cases where the player character disappears temporarily and then reappears later on, the plugin will automatically switch back to first person camera.

First person camera VR fixes

First person VR was a bit wonky if you use the original CM plugin. In this version, first person VR should now work mostly.*

Automatic entry/exit to this mode is also supported as with normal first person camera. However, this feature can be nausea inducing if you have low tolerance for motion sickness and such, specially so on spicy scenes, and if your graphics card can't keep up. Therefore, this feature is disabled by default. Enable and use it at your own risk ;)

If you do decide to use this feature, you can enter/exit first person mode via the standard first person camera keyboard bindings. You can also use your VR controller's grip+primary button. Oh and trigger+primary button starts/ends skip mode too in case you needed it. These controls are not final but "works for me" for the moment. It may change in the future.

  • only tested using oculus. It should work in theory for the other supported vr devices.

Known issues

Automatically entering first person camera can sometimes result in the wrong viewing angle if camera direction lock is disabled. The same if we detect a change in positions. Still working on a proper fix for this. Only applies to normal first person camera.

Installation

Make sure COM 3D2 is up to date.

If you havent yet, install CMI from (https://github.com/krypto5863/COM-Modular-Installer), make sure to exclude the CameraUtility plugin from the list of plugins to install.

If you already have CMI, make sure it is up to date. Either use the CMI installer to remove/clean the old CameraUtility plugin or remove/disable the old plugin from the Sybaris folder of your COM 3D2 install folder.

Copy/extract the COM3D2.CameraUtility2.Plugin.dll from this project in your *BepinEx\plugins* folder of your COM 3D2 installation.

Build from source

Copy the following dll files from your COM3D2 game into the libs directory:

From BepInEx\Core:

  • 0Harmony.dll
  • BepInEx.dll

From COM3D2x64_Data\Managed:

  • Assembly-CSharp.dll
  • UnityEngine.dllf

Install VS Studio community. See the general programming resources in the Custom Maid Server on how to install and which packages to include.

Open the sln file, and build!

CM3D2.CameraUtility.Plugin

CM3D2のカメラ機能を拡張します。その他主に撮影用の機能を追加します。 ロール回転、パース変更、背景位置変更、一人称視点、こっち見て機能、操作パネル消去の機能を加えます。 キーボード操作のみの対応です。

注意 表中のキーは日本語キーボードでの表記です。

機能・操作方法紹介

カメラ操作 (ロール回転、パース変更) VR非対応

機能 キー
視野:拡張 ] (む)
視野:縮小 ; (れ)
視野初期化 : (け)
ロール回転:左 . (る)
ロール回転:右 \ (め)
ロール初期化 / (ろ)

メインカメラのパース(視野、FoV)変更、およびロール回転機能です。 「け」「め」がそれぞれ初期化です。 キーの対応はIllusion系のゲームに合わせています。

背景位置変更

機能 キー VR キー
移動:前 ↑ I
移動:後 ↓ K
移動:左 ← J
移動:右 → L
移動:上 PgUp 0 (zero)
移動:下 PgDn P
水平回転:左 Del U
水平回転:右 End O
ロール回転:左 Ins 8
ロール回転:右 Home 9
初期化 BS BS

Shift キーを押しながらだと移動距離が1/10になります。微調整にどうぞ。 Alt キーを押しながら各キーを押すとそれぞれの操作分が初期化されます。 BS キーを押すと移動関係をまとめて初期化します。 背景が変更されると移動は初期化されます。 ロール回転を使うと操作が混乱しやすいので極力最後に使うことをお薦めします。 VR版はゲーム内で使われているキーと一部重複するため操作が変わります。

こっち見て機能

機能 キー
こっち見て／通常切り替え G
視線及び顔の向き切り替え T
  • 視線及び顔の向き種別
    • 無し = 0
    • 無視する = 1
    • 顔を向ける = 2
    • 顔だけ動かす = 3
    • 顔をそらす = 4
    • 目と顔を向ける = 5
    • 目だけ向ける = 6
    • 目だけそらす = 7

「T」キーで上記の8種を順に切り替えます。切り替え時の番号はコンソールに表示されます。 「G」キーは上記の表での 0 および 5 の切り替えです。 一人称視点時に "こっち見て" を使うと角度制限で見てくれないことがあるので 自動的に「無し」の状態になりますが、そこから更に変更することは可能です。

夜伽時一人称視点 VR一部対応

機能 キー
一人称視点切り替え F
男切り替え R

夜伽時に「F」キーで主人公らしき物体の視点に切り替えます。 もう一度押すとブレ補正モードに切り替えます。 さらにもう一度押すと元に戻ります。 主人公が表示されないシーンでは妙な場所に飛ぶので手動で解除してください。 「R」キーで主人公らしき物体を順に切り替えます。 男変更MODへの対応のため一人称視点時には男の頭が消えます。 VRモードで追従すると酔いの原因となるので主人公の視点位置に移動のみします。 体勢が変わっても追従しないので適時キーを押してください。

パネル表示切り替え VR非対応

機能 キー
パネル表示切り替え Tab

エディット及び夜伽時にステータスや操作パネルを消します。 もう一度押すと表示します。 各パネルには折りたたみ機能がありますが、こちらは一括で消し去ります。

設定ファイル

ゲームを起動すると UnityInjector\Config\CameraUtility.ini が生成されます。 各操作キーの変更、移動速度などの数値の変更が可能です。 詳細は Ini ファイルの中を参照してください。

変更履歴

  • 2.3.4.0

    • NullReferenceException を修正
    • Unity 5.3.4p4 対応
    • VR 対応修正

  • 2.3.0.0

    • Chu-B Lip + VR 対応

  • 2.2.0.0 Author: qucucu

    • 男切り替え機能を追加

  • 2.1.1.0

    • FPSモードのクラッシュを修正

  • 2.1.0.0 Author: Milly

    • ファイル名変更
    • 設定ファイルに対応
    • 撮影モードでのUIパネル非表示に対応

  • 2.0.1.2-20160220 Source: GitHub Author: MeidoDev

    • Chu-B Lip 対応
    • 回想モードでのFPSモード有効化

  • 2.0.1.2-20160103 Source: Pastebin Author: したらば改造スレその6 >>944

    • FPSモードでのカメラブレの補正機能追加
    • VIPでのFPSモード有効化
    • UIパネルを非表示にできるシーンの拡張(シーンレベル15)

  • 2.0.1.2-20151107 Source: Pastebin Author: したらば改造スレその5 >>693

    • 一人称視点の男変更MODへの対応修正。

  • 2.0.1.2

    • 夜伽開始時にNullReferenceExceptionを吐く不具合を修正。

  • 2.0.1.1

    • 一人称視点の男変更MODへの対応。

  • 2.0.0.0

    • 一人称視点、こっち見て機能、パネル消去実装。
    • 立ち位置変更の縦回転、初期化機能実装。

  • 1.1.0.1

    • 移動量を減らすキーをCtrlからShiftへ変更。
    • VRモードに対応(移動のみ)。

  • 1.1.0.0

    • 立ち位置変更機能追加。

  • 1.0.0.0 Source: Github Author: k8PzhOFo0

    • 初版