全身Grabシステム (アバターギミック) GrabFullbody

2024/12/14 大幅に挙動を改善したVer6をリリースしました！

FinalIKの代わりに、FinalIK Stubを導入してください。無料です。

https://github.com/VRLabs/Final-IK-Stub

PhysboneとFinalIKを使用して、手足、腰、頭をGrab可能にするアバターギミックです。

導入ツールによりクリック数回で導入が完了します！

Avatar3.0対応、IK2.0対応、3点トラッキング対応、6点トラッキング（フルトラ）対応

開発支援版は通常版に加え、βリリース、技術解説が含まれます。

[R-18]本ギミックにはアバターの腰同士で衝突＆ストロークができるR-18アドオンが存在します。併せてご検討ください。

https://nharuka.booth.pm/items/6070764

---ご注意---

様々なアバターでの動作確認はしておりますが、アバターによっては不具合が出る可能性があります。可能な限りサポートさせていただきますが、技術的制約から対応できないケースも存在するため、完璧を求める方は購入を控えていただきますようお願いいたします。

また、VRChatの仕様変更等により機能しなくなる可能性があること、予めご了承ください。

バグ等の報告やサポート依頼はページ下部のDiscordにお願いいたします。

---------

This avatar gimmick uses Physbone and FinalIK to make the limbs, waist, and head Grab-able.

Avatar3.0 compliant, IK2.0 compliant, 3-point tracking compliant, 6-point tracking (FBT) compliant

The development support version is identical to the standard version at this time. However, additional content (test functions, beta releases, technical explanations, etc.) may be available in future updates.

[R-18] There is an R-18 add-on for this gimmick that allows the avatar's hips to collide & stroke each other. Please consider it as well.

https://nharuka.booth.pm/items/6070764

---Note---...

Although we have confirmed the operation with various avatars, there is a possibility that some avatars may have problems. We will do our best to support you, but there are cases where we cannot support you due to technical limitations, so please do not purchase if you are looking for perfection.

Also, please note that this feature may not function due to changes in the VRChat specifications.

To report bugs and request support, please contact us on the Discord at the bottom of this page.

---------

機能詳細

PhysboneのGrab機能とFinalIKを利用して、両手、両足、頭、腰の計６か所をGrabできるようになります。

イメージは動画をご覧ください。

【特徴】

・IKを使用しているので、Physbone依存の挙動と比べて、自然にボーン位置を補間するので関節が変な方向に曲がったりしにくくなっています。

・腰Grabは手足の位置を維持したまま動くので、自然な動きになります。

・足が接地します。

・腰Grabや頭GrabでのHeadの移動に対し、視点が追従します。

・IKのため、手足を固定したままアニメーション再生が可能です。

・詳細な条件は未検証ですが、腰Grabではポータルも通れるようです。

前提条件

・VRChatSDK Avatar 3.0

・FinalIK Stub

https://github.com/VRLabs/Final-IK-Stub

（※もしFinalIKを使う場合はScript Define Symbolに"NotFinalIKStub"を追加してください。）

・3点または6点トラッキング（7点以上は未検証）

・デスクトップモードは未検証

・Quest単体は非対応（FinalIKが非対応のため）

導入手順

0. 事前にFinalIK Stub*をインポートしておく。

* https://github.com/VRLabs/Final-IK-Stub

1. 本パッケージをインポートする。

2. メニューバー「nHaruka」→「GrabFullBody」を押す。

3. 表示されたウインドウの「Avatar」欄にアバターをD&Dする。

4. 必要なチェックボックス※を選択する。

5. Setを押す。

※Handボーンの向き：Handボーンを選択して、シーンビュー上で、手の向き（指の向き）と同じ向きの矢印が赤色の場合はX軸、緑色の場合はY軸を選択してください。

※アップロード時にVRCSDKの画面にVRC Constraintに変換するようなAutoFixが出ますが、押さないでください。

アップデート履歴

[2022-05-31: v0.05β] 試験公開

[2022-05-31: v0.06β] GUIを調整、エラー処理を追加

[2022-05-31: v0.1β] FootIKのOn/Offを選択可能に変更。適用部位を選択可能に変更。

[2022-06-02: v1.0] 正式リリース。

[2022-06-13: v2.0β] 遅延を大幅に改善。ポージング（固定）機能の追加。

[2022-06-13: v2.1] FinalIK Stubに対応。FinalIKの購入が不要に。

[2022-06-18: v2.2] 一部アバターで腰、頭をGrabすると、リモート視点で挙動が不安定になる不具合を修正。

[2022-10-14: v3.0] 視点追従するように変更。一部アバターで挙動が不安定になる不具合を修正。3点トラッキングでも頭のトラッキングが維持されるように修正。

[2022-11-13: v3.32] 視点追従を改善、ズレをほぼゼロに。肩のIKを改善。

[2022-11-13: v3.33] カメラのカリング処理を最適化。

[2023-01-31: v3.4] 足のIKがおかしくなる不具合を修正。アドオン向けの機能を追加。

[2023-04-20: v4.0] SDKの更新に伴い改修。Posedの挙動を変更。

[2024-08-18: v5.1.1] 大幅改修。挙動の大幅改善。

[2024-09-01: v5.1.2] 微調整、アドオン対応。

[2024-09-01: v5.1.3] アドオン関連修正。

[2024-09-02: v5.2.0] フルトラで一部機能しない問題を修正。頭と腰の固定を可能に。

[2024-09-02: v5.2.1] トラッキングに関する微修正。

[2024-09-02: v5.2.2] 腰Grabを修正。

[2024-09-06: v5.2.5] フルトラ時の腰Grabを修正。

[2024-09-06: v5.2.6] 視点追従の仕組みが狂っていたのを修正。

[2024-09-08: v5.2.7] 腰Grabおよびアドオン時の挙動を改善。

[2024-12-04: v5.3.0] アドオン向けに諸々調整。

[2024-12-05: v5.3.1] アドオン向けに諸々調整。

[2024-12-14: v6.0.0] IKコンポーネントを刷新してフルトラ時の挙動を大幅改善。

[2024-12-26: v6.1.1] UpperChestがないアバターでの不具合修正。首の挙動を修正。ModularAvatarに部分対応。

[2025-07-17: v6.2.1] 他人ビューで視線がおかしくなる問題を修正。On/Offスイッチを追加。視線コントロールスフィアのOn.Offスイッチを追加。

[2025-12-27: v7.1.2] IK周りのパラメータをいろいろ直した。より自然になったかも。

[2026-04-04: v7.1.8] 肘が適切に動かせるように直した。腰を動かしたときに首がカクカクする問題を直した。

既知の不具合

・Uprightが1より高いないし低いときにHandをGrabすると、Grabした位置とされた位置がずれる。

・頭と腰を同時にGrabすると、ローカルとリモートで位置座標がずれる。（ResetAvatarすることで修復可能）

・頭と腰をGrabしたときに、視線追従するものの、HMDの動きには追従しない。

※アップロード時にVRCSDKの画面にVRC Constraintに変換するようなAutoFixが出ますが、押さないでください。

バグ報告・サポートについて

バグ報告やサポート依頼については、下記Discordに一元化しております。

お困りの際は下記へお問い合わせください。

https://discord.gg/zuaYSC5FHg

サポートガイドライン（抜粋）

・他ギミックとの複合的な問題やUnityのバグ、その他作者の知見を超える内容についてはご回答できない場合があります。

・リクエストの内容が不鮮明である場合、回答が困難な場合があります。

利用規約

・Unitypackageそのものやソースコードの一部または全部の二次配布は禁止します。

・本ツールを使用して全身Grabシステムを組み込んだアバターのPublishは可とします。販売アバターへの組み込みはご相談ください。

・ギミックの構造等を強く模倣したものを公開・販売することは禁止します。