【VRChatアバターギミック】AvatarPoseSystem

AvatarPoseSystem

アバターのポーズを固定して動かせるアバターギミック

身体と揺れ物（PhysBone）をそれぞれ固定可能です、身体は固定後ポーズの調整が可能です

固定したアバターをカメラで撮影できます。VirtualLens2やVRCLens出の撮影も可能です

### メニュー

- Option

- HideBody 　 ...身体固定時に表示する仮の身体の表示/非表示を切り替えます。

- AllowGrab 　　　　 　...掴みの有効/無効を切り替えます。

- ShowHandle 　　　 　 　...ハンドルの表示/非表示を切り替えます。

- LockHandle 　 ...ハンドルのロックを切り替えます。ロック中はハンドルを持てなくなります。

- On/Off (Hold) 　 ...固定/解除を切り替えます。解除する際は1秒間ホールドしてください。（誤操作防止）

- Timer5s 　...5秒後に固定するタイマーを起動します。

- Timer15s 　...15秒後に固定するタイマーを起動します。

- Ex

- FixBody On/Off 　...身体のみ固定/解除を切り替えます。

- FixBody Timer5s 　...5秒後に身体のみ固定するタイマーを起動します。

- FixBody Timer15s 　...15秒後に身体のみ固定するタイマーを起動します。

- FixPB On/Off 　　...PhysBoneのみ固定/解除を切り替えます。

- FixPB Timer5s 　 　...5秒後にPhysBoneのみ固定するタイマーを起動します。

- FixPB Timer15s 　 　...15秒後にPhysBoneのみ固定するタイマーを起動します。

### メニュー以外の操作

- 身体を固定中に身体の各部位を持つと位置や角度を調整できます。調整した位置で固定する時はPhysBoneの固定の要領で可能です。

※持てる部分はハンドルを表示すると見ることができます。

- 身体を固定中で掴みが有効になっている場合に、身体の近くで手をFistにすると身体を持って動かすことができます。手を離すと身体はその場所に固定されます。

- 身体を固定中に、手のそばにある赤いハンドルを引っ張ると手のサイズを大きくできます。ハンドルを持ちやすくするためにご使用ください。

- 身体を固定中に、背中付近にある赤いハンドルを引っ張ると身体の位置を移動できます。

## 準備事項

下記のものをあらかじめ適用してください

1. Modular Avatar

https://modular-avatar.nadena.dev/ja/

2. lilToon

https://lilxyzw.booth.pm/items/3087170

3. 円形ゲージシェーダー

https://booth.pm/ja/items/4451674

※こちらUnityPackageの中身を全部インポートしてしまうとエラーが出てしまうため、Shaderのみインポートしてください。

## 導入方法

1. アバターに、AvatarPoseSystem prefabを配置します。

2. 必要に応じて、AvatarPoseSystemコンポーネントに設定を行います。

- Unhandle Eyes : 目をハンドルで調整しない（他ギミックの視線制御を使用する場合はチェックしてください）

- Unfix Phys Bones : 固定したくないPhysBone/HeadChopを設定してください（設定した要素のみ対象）

- Unfix Phys Bones With Children : 固定したくないPhysBone/HeadChopを設定してください（設定した要素と子要素が対象）

- Unfix Objects : 固定したくないオブジェクトを設定してください（VirtualLensなどはこちら）

- Unfix Object Paths : 固定したくないオブジェクトのパスを設定してください(自動生成オブジェクト指定用)

- Handle Size : ハンドルのサイズ

- Set Paramaters On Fix : ポーズ固定時にパラメータを変更する設定

- Set Paramaters On Unfix : ポーズ固定解除時にパラメータを変更する設定

- Enable Trace : チェックするとトレース情報を作成します。バグ報告時にこの情報を添付していただけますと確認がスムーズになる可能性があります。

①固定したくないPhysBone/VRCHeadChopがある場合は、対象を 「Unfix Phys Bones」「Unfix Phys Bones With Children」に設定してください。

②固定したくないオブジェクトがある場合は、対象を 「Unfix Objects」に設定してください。

③固定したくないオブジェクト（ビルド時に追加されるオブジェクト）がある場合は、対象をのパスを 「「Unfix Object Paths」に設定してください。

※VirtualLens2やVRCLensを使用して写真を撮りたい場合はこちらに設定が必要です。詳細は後述します。

※VirtualLens2やVRCLensを使用して写真を撮りたい場合はこちらに設定が必要です。詳細は後述します。

### 導入補足

- VirtualLens2を使用したい場合

「Unfix Objects」に"VirtualLens2" オブジェクトを設定してください。

「Unfix Object Paths」に"_VirtualLens_Root"を設定してください。

また、VirtualLens2側の設定で、Marker Objectで「Auto」になっている物がある場合は「Auto」を押してオブジェクトの生成を行ってください。(これを行わない場合、ドローン等の操作ができなくなります)

- VRCLensを使用したい場合

「Unfix Objects」に"VRCLens"、"PickupA"、"PickupB"、"PickupC" オブジェクトを設定してください。

※"PickupA"、"PickupB"、"PickupC"はVRCLensによりアバターの頭と両手ボーンの下に作成されています。

- PC-1を使用したい場合

「Unfix Objects」に"Hand Proxy" オブジェクトを設定してください。

- ポーズ固定時にEmoteCollectorのポーズを解除したい場合

「Set Paramaters On Fix」に Paramater Name=EC/AllReset, Value=1 を設定してください。

「Set Paramaters On Unfix」に Paramater Name=EC/AllReset, Value=0 を設定してください。

- ポーズ固定時にAvatarPoseLibraryのポーズを解除したい場合

「Set Paramaters On Fix」に Paramater Name=AnimPoseReset_, Is Prefix=☑, Value=1 を設定してください。

### 導入補足2

- キメラアバターの場合

キメラアバター（アバターの頭部に別のアバターなどの頭部を付けたもの）にAvatarPoseSystemを適用する場合は、身体の方の元々の目のボーンと同じ階層、同じ名前ですげ変えた頭の目のボーンがある状態に調整ください。

## 注意事項

- 本ギミックではPhysBoneの固定を行いますが、本ギミック以外で制御が行われているPhysBoneはうまく制御できないことがあります。

※例えば、マヌカの尻尾はAFKアニメーション内に制御が行われているため固定時にまっすぐになってしまいます。これを回避するにはAFKアニメーションから尻尾の制御を削除する必要があります。

- 本ギミックはアバターの構造に影響を与えるため、他のギミックなどに影響を与える可能性があります。そのため同時に入れた他のギミックがうまく動かないなどの状況が発生する可能性があります。

※「Unfix Phys Bones」「Unfix Phys Bones With Children」「Unfix Objects」をうまく設定していただくことで回避できる場合がありますが、できないこともあります。

- 本ギミックは本ギミック以外の身体の部位を掴んだり動かすようなギミックとは併用できません

## エラーに関する問い合わせについて

- AvatarPoseSystem の Enable Trace にチェックを入れてビルドを行うと、トレース情報を作成します。バグ報告時にこの情報を添付していただけますと確認がスムーズになる可能性があります

- 添付前にトレース情報ファイルを開いて送付して問題ない内容であるかをご確認下さい。

## よくあるご質問への回答

- Q:ハンドルがつかめない

- A:ハンドルはPhysBoneになっております。VRChatの設定でAvatar Interactionsの設定値をご確認いただき、PhysBoneが触れる状態になっているかご確認下さい。

## 特記事項

- 今後VRChat及びVRCSDKなどのバージョンアップにより動作に問題が発生することがあります

- 本アイテムはPCVRモードでの使用を想定しております。

- 本アイテムはVRChat SDK - Avatars 3.6.1 以上をを想定しております。

## ライセンス

本アセットはVN3ライセンスで提供されます。許諾事項は商品画像および商品に含まれているPDFファイルでご確認をお願いいたします

## SPECIAL THANKS

〇 アイデア提供、テスト

- sao* ( https://x.com/sao_0u0 )

## 更新履歴

- v1.0.0 リリース

※文字数制限のため中略(ReadMe.mdに記載)

- v4.3.2

- ハンドルのサイズを調整できるようにしました

- v4.3.3

- MA 1.17.0でアバターにMA Floor AdjusterとAPSがある場合に地面に埋まったようになってしまう点を修正

- v4.3.4

- MA 1.17.0でアバターにMA Floor AdjusterとAPSがある場合に地面に埋まったようになってしまう点を修正(再修正)

- つま先の制御に関して想定と異なっていた部分があったものを修正

- v4.3.5

- MA Merge Armatureを使用した衣装などが追従しない点を修正

- v4.3.6

- Avatar Optimizerがv1.9.0未満の場合にスクリプトがエラーになる点を修正

- Modular Avatar, Avatar OptimizerがAPSで必要なバージョンより低い場合に警告メッセージを表示するように修正

- v4.3.7

- VRCConstraintのTargetTransformに身体のボーンを指定している物があった場合に動作不良が起きていた点を修正（例:ダイナなど）

- 身体のボーンの構造が想定していない構造であった場合に動作不良が起きていた点を修正（例:筋肉素体など）

- v4.3.8

- 身体のボーンの下にあるオブジェクトをUnfixObjectを設定した場合に、位置がずれたりエラーになる問題を修正

- v4.3.9

- ※本バージョン以降を使用する場合で、AlterBodyを使用する場合はAlterBody v2.1.1に更新をお願いします。

- AlterBodyで分身が角度によってカメラに映らなくなってしまう場合がある点を修正

- v4.3.10

- Constraintで制御しているボーンの制御が正常に行われていない場合がある点を修正

- v4.3.11

- v4.3.10でスクリプトがエラーになってしまっている点を修正

- v4.3.12

- ※本バージョン以降を使用する場合で、AlterBodyを使用する場合はAlterBody v2.1.2以降に更新をお願いします。

- AlterBodyで、分身側にあるMA Paramatersの「名前を変更」設定でGestureRightなどを指定していた場合にジェスチャーに反応できていない点を修正

- MA Bone Proxyで移動する先のパスを予想して指定したアニメーションを持つギミックが動作しなくなる点を修正

- v4.3.13

- VRCConstraintのTargetの取り扱いに問題があり、ましゅまろＰＢなどが動かなくなっていた点を修正

- v4.3.14

- 身体のボーンをConstraintで動かしている特定のケースが正常に動作しなかった点を修正（例:Lapwingの親指など）

- v4.3.15

- アバターのExpressionParamaterが設定されていない場合や「Blank Expressions Menu and Parameters」を使用している場合にエラーが発生した問題を修正

- v4.3.16

- 身体のボーンに直接PhysBoneを設定しているギミック（例:ふにゃ指など）が正常に動作しなくなっていた点を修正