━━━━━━━━━━━━━━━━━━━━ 好きなBlendShapeを、 「ひっぱれるギミック」に。 ━━━━━━━━━━━━━━━━━━━━ こんなこと、ありませんか？ ・この衣装、服を動かせるBlendShapeがあるけど、 ギミックが付いていないからExpression Menuから動かすしかない… ・EreMorphなどのメッシュ変形ツールで 服を動かせるようにしたけど、 せっかくなら手で直接つかんで動かせるようにしたい… でも、 ・PhysBoneの追加方法がよくわからない ・Animatorの設定が難しい ・AnimationやBlendTreeの作成が面倒 ・Modular Avatarへの組み込み方もよくわからない ……そんな面倒な作業を、 できるだけ触らず、まとめて済ませたい。 「ひっぱりシェイプ」は、 そんな作業をまとめて行ってくれる VRChat向けUnity Editorツールです。 対象のBlendShapeと、 ひっぱる方向や距離などを設定するだけで、 ・Grab用VRC Phys Bone ・Animation Clip ・BlendTree ・Animator Controller ・Modular Avatar Merge Animator ・Expression Menu用ON / OFFメニュー（任意） など、必要な設定をまとめて自動作成します。 必要に応じて、作成したひっぱりギミックを Expression Menuから個別にON / OFFすることもできます。 複数のギミックは「ひっぱりシェイプ」サブメニューにまとめて管理できます。 アバター本体のFX Controllerを 直接書き換える方式ではないため、 既存の構成をできるだけ崩さずに導入できます。 もともと衣装やアバターに入っているBlendShapeはもちろん、 EreMorphなどのメッシュ変形ツールを使って あとから作成したBlendShapeも利用できます。 たとえば、 ・服をずらす ・肩ひもを落とす ・リボンや装飾を引っぱって変形させる ・自分で作った変形を、手で直接操作する といった使い方ができます。 Expression Menuからしか動かせなかったBlendShapeを、 「実際にその場所をつかんで、ひっぱって動かす」 そんなVRChatらしい操作に変えることができます。 ━━━━━━━━━━━━━━━━━━━━ ■ ご購入前に必ずご確認ください ━━━━━━━━━━━━━━━━━━━━ 本ツールは、 BlendShapeを「作る」ためのツールではありません。 すでに存在するBlendShapeを、 VRChat内のGrab操作に合わせて動かすためのツールです。 そのため、 ・BlendShapeが存在しないメッシュには使用できません。 ・本ツール自体でメッシュを変形することはできません。 ・新しいBlendShapeを作成したい場合は、 EreMorphなどのメッシュ変形ツール等を使用して 事前にBlendShapeを作成してください。 ━━━━━━━━━━━━━━━━━━━━ ■ 主な機能 ━━━━━━━━━━━━━━━━━━━━ ● 複数BlendShape対応 1つのGrab操作で複数のBlendShapeを同時に動かせます。 ● 開始値・最大Pull時の値を自由に設定 0→100だけでなく、 100→0、20→80など任意の値を設定できます。 ● 作成後の再編集に対応 一度作成したギミックを読み込み、 BlendShapeやPull設定などを後から変更できます。 ● Grab位置・方向を調整 Scene上にGrabガイドを表示し、 位置やPull方向、最大Pull位置、Grab範囲を確認しながら調整できます。 ● 追従先を設定可能 通常はAutoでGrab位置に近いHumanoid Boneを自動選択します。 必要に応じて各Humanoid BoneやCustom Transformを指定できます。 ● 他の人からのGrabをON / OFF ON：自分・他ユーザーからGrab可能 OFF：自分だけGrab可能 ● UseでPull位置を固定 設定をONにすると、 Grab中にUseすることでそのPull位置に固定できます。 ● Expression MenuからギミックをON / OFF 必要に応じて、作成したひっぱりギミックを VRChatのExpression Menuから個別にON / OFFできます。 複数のギミックを作成した場合は、 「ひっぱりシェイプ」サブメニュー内にまとめて表示されます。 各ギミックごとに、 ・メニュー上の表示名 ・初期状態 ON / OFF を設定できます。 OFF時は対象BlendShapeが設定した開始値に戻り、 GrabしてもBlendShapeは変化しません。 ● Modular Avatar対応 生成したAnimator Controllerは、 Modular Avatar Merge Animatorを使用して統合します。 ● 複数ギミック設置対応 各ギミックには固有IDが割り当てられるため、 同じアバターへ複数設置できます。 ━━━━━━━━━━━━━━━━━━━━ ■ 使い方は5ステップ ━━━━━━━━━━━━━━━━━━━━ Tools → ひっぱりシェイプ からツールを開きます。 1. 衣装を選ぶ 対象のSkinned Mesh Rendererを指定します。 2. 動かすBlendShapeを選ぶ 開始値と最大Pull時の値を設定します。 3. ひっぱり方を決める Pull方向・距離・Grab範囲・追従先などを設定します。 必要に応じて、Expression MenuからのON / OFFも設定できます。 4. ギミックを一括セットアップ 必要なPhysBone / Animation / BlendTree / Animator / Modular Avatar設定を自動作成します。 ON / OFF機能を使用する場合は、Expression Menu用の設定も自動作成します。 5. Scene上でPullRootを配置 実際にGrabしたい位置へPullRootを移動して完成です。 配置後もGrab位置はいつでも調整できます。 ━━━━━━━━━━━━━━━━━━━━ ■ 必要環境 ━━━━━━━━━━━━━━━━━━━━ ・Unity ・VRChat SDK - Avatars ・Modular Avatar ・Humanoidアバター ・BlendShapeを持つSkinned Mesh Renderer VRChat Creator Companion（VCC）、またはALCOM環境での使用を想定しています。 ━━━━━━━━━━━━━━━━━━━━ ■ 他のBlendShapeギミックとの併用について ━━━━━━━━━━━━━━━━━━━━ 同じBlendShapeを、 複数のAnimatorやギミックから同時に操作している場合、 設定が競合して正常に動作しないことがあります。 たとえば、 ・衣装にもともと衣装ずらし等のギミックが入っている ・Expression Menu用に同じBlendShapeを動かすAnimationを組んでいる ・別のFX Animatorで同じBlendShapeを動かしている ・AvatarMenuCreator for Modular Avatar等で 同じBlendShapeを操作するメニューを作成している ・他のModular Avatarギミックから 同じBlendShapeを操作している といった場合です。 競合すると、 ・値が上書きされる ・最大Pull時の値まで変化しない ・意図しない値に戻る ・まったく動かない ・動作が不安定になる などの症状が発生する場合があります。 ひっぱりシェイプで使用するBlendShapeについては、 できるだけ他のAnimatorやギミックから 同時に操作しないようにしてください。 ※Expression Menu上で既存ギミックを「OFF」にしていても、 OFF用Animation Clipが同じBlendShapeの値を書き続けている場合があります。 ━━━━━━━━━━━━━━━━━━━━ ■ Write Defaultsについて ━━━━━━━━━━━━━━━━━━━━ ひっぱりシェイプが生成するAnimator Stateは、 Write Defaults = OFFで作成されます。 また、 Modular Avatar Merge Animatorでは Match Avatar Write Defaultsを使用します。 ただし、 アバター全体のAnimator構成や他ギミックとの組み合わせによっては、 挙動が異なる場合があります。 特にWrite DefaultsがON / OFFで混在しているアバターでは、 Build & Test等で動作をご確認ください。 ━━━━━━━━━━━━━━━━━━━━ ■ 作成済みギミックについて ━━━━━━━━━━━━━━━━━━━━ 作成済みのギミックは、 「既存ギミック編集」から再読み込みして設定を変更できます。 削除する場合も、 できるだけ「ひっぱりシェイプ」内の削除機能をご利用ください。 生成データは、 Assets/GrabPullGenerated 以下にギミックごとに保存されます。 生成されたフォルダやAnimation Clip、 Animator Controllerを手動で移動・改名・削除すると、 再編集・削除機能が正常に動作しない場合があります。 ━━━━━━━━━━━━━━━━━━━━ ■ トラブルが発生した場合 ━━━━━━━━━━━━━━━━━━━━ ツール導入後にCompile Error等が発生した場合は、 Assets/Room159/ひっぱりシェイプ を削除することで、 ひっぱりシェイプ本体をプロジェクトから取り外せます。 ※作成済みのGrabPullギミックや Assets/GrabPullGenerated内の生成データは 自動では削除されません。 ※GrabPullGeneratedには複数ギミックのデータが 保存されている場合があります。 必要なギミックが残っている場合は、 フォルダ全体を削除しないでください。 詳しくは同梱のREADMEをご確認ください。 ━━━━━━━━━━━━━━━━━━━━ ■ 注意事項 ━━━━━━━━━━━━━━━━━━━━ ・BlendShapeが存在しないメッシュには使用できません。 ・本ツールにメッシュ変形機能、BlendShape作成機能はありません。 ・Humanoidアバターを前提としています。 ・同じBlendShapeを他のAnimatorやギミックでも操作している場合、 競合して正常に動作しないことがあります。 ・生成されたAnimationやAnimator Controllerを手動編集した場合、 再編集機能が正常に動作しない場合があります。 ・Assets/GrabPullGenerated内のデータを手動で移動・改名・削除すると、 編集・削除機能が正常に動作しない場合があります。 ・VRChat SDK、Unity、Modular Avatar等の アップデートや仕様変更により、 正常に動作しなくなる場合があります。 ・すべてのアバター、衣装、外部ギミックとの 組み合わせでの動作を保証するものではありません。 ・導入前にUnityプロジェクトのバックアップを推奨します。 ━━━━━━━━━━━━━━━━━━━━ ■ 利用規約（概要） ━━━━━━━━━━━━━━━━━━━━ ○ 個人利用 ○ 商用利用 ○ 改変 ○ 動画・配信・SNS等での使用 ○ コミッション・改変代行 ○ 生成物を組み込んだアバター・衣装等の販売・配布 × 本ツール本体の再配布・再販売 × unitypackageの購入者以外への共有 × Editorスクリプト・付属Prefab等の転載 × 改変した本ツールそのものの再配布・販売 利用規約全文： https://holy-bar-0da.notion.site/Room-159-3f3cf5193cad806e9f4ede2a9eb75bb3 ━━━━━━━━━━━━━━━━━━━━ ■ 内容物について ━━━━━━━━━━━━━━━━━━━━ 本商品に含まれるのは、 「ひっぱりシェイプ」本体および付属ドキュメントです。 商品画像に使用しているアバター・衣装・アクセサリー等は 本商品には付属しません。 ━━━━━━━━━━━━━━━━━━━━ ■ 使用モデル ━━━━━━━━━━━━━━━━━━━━ オリジナル3Dモデル「しなの」 ポンデロニウム研究所 / ぽんでろ 様 https://booth.pm/ja/items/6106863 衣装：White Vessel / Ao Sirua 様 https://booth.pm/ja/items/7592493 ※上記アバター、衣装は本商品には付属しません。 ━━━━━━━━━━━━━━━━━━━━ Room #159 ひっぱりシェイプ Version 1.0.0 ━━━━━━━━━━━━━━━━━━━━