NPCグラブシステム（アバターギミック）NPC Grab System

好きなアバターに好きな別のアバターを仕込んで、自由にポージングできるアバターギミックです。

手首、足首、肩、腰をつかんで動かせるほか、全体を回転させたり、視線を動かしたりできます。

※IKであるため、膝、肘、胴体の角度は自動補完されます。

表情アニメーションをセットすれば、Expressionメニューから表情を選択できます。

FinalIKを利用しているのでFinalIK Stubを導入してください。無料です。

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

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

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

クリスマスに間に合わせるため現時点では若干粗削りな部分がありますが、追って改良予定です。

前提条件

・Unity2022.3.22f1

・VRChatSDK Avatar 3.0

・FinalIK Stub

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

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

導入手順

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

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

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

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

3. 表示されたウインドウの「Main Avatar」欄にベースのアバター、「NPC Avatar」欄にNPCとして仕込むアバターをD&Dする。

4. 必要に応じてNPC Avatarに表情アニメーションを設定する。

5. Setupを押す。

制限・注意事項

・全体回転用のレバーは最初に操作するのみにしてください。腰のボーンが中心からずれた後にこのレバーを操作すると高速回転します。

・現時点ではポーズやアニメーションはサポートしていません。

（将来的にサポート予定です）

・厳密にはHumanoidアニメーション以外はFaceAnimationに登録してセットアップすることで動作します。

Humanoidアニメーション（身体のモーションなど）はAnimator直下にArmatureが存在する（Humanoidリグ適合）場合のみに動作するのですが、NPCGrabシステムでアバターの中にアバターを入れてしまうと入れられたアバターはHumanoidリグ適合ではなくなるので、動作しなくなります。

HumanoidアニメーションをGenericアニメーションに変換し、パスを適切に設定すれば動作しますが、高度なAnimatorに関する知識が必要です。

・足首や肘、膝も現時点では任意の角度にすることはできません。（IKで自動補完されます）将来的に操作オプションを追加予定です。

更新履歴

[2025-12-24: v0.2.1] 試験公開。

[2025-12-25: v0.3.1] アニメーションを追加できるように。

[2025-12-24: v0.3.2] 腰Grabが体全体が動いてしまう問題を修正。

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

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

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

https://discord.gg/zuaYSC5FHg

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

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

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

利用規約

・Unitypackageそのものやそれに含まれるアセット、ソースコードの一部または全部の二次配布は禁止します。

・ギミックの機構、コンセプトをそのまま模倣し販売することを禁止します。

・本ギミックを導入したアバターのPublishは可ですが、unitypackage等アセットを取り出し可能な形での再配布は不可とします。

・販売アバターへの組み込みは個別にご相談ください。

・法人利用は個別にご相談ください。

・画像作品、映像作品への利用はVRChatの利用規約に違反しない形であれば自由です。可能であればクレジットいただけると嬉しいです。