Blender 4.2用のアバター表情シェイプキー検証・管理アドオンです。アバターの表情シェイプキーを「検証」と「一括管理」で整えます。VRChat向けアバター制作の補助を想定したツールですが、Blenderの中で完結するアドオンであり、VRChat専用ツールではありません。 口パク（リップシンク）のキーが1つ足りない、名前の大文字小文字が違っていた、右目のまばたきだけ作り忘れた——。アップロード直前に気づくような名前まわりのミスを、Blenderの中で機械的にチェックし、直す作業をまとめて支援します。 3Dビューポートのサイドバー（Nキー）「シェイプキー検証」タブから使います。 ■できること 【検証レポート】 ・口パク用キー（vrc.v_* 標準15種）の不足を一覧表示 ・表記ゆれ検出（例:「VRC.V_OH」→ VRChatは名前を完全一致で参照するため、表記違いは実質「無いキー」扱いになります） ・まばたき用キー（blink等）の有無チェック ・左右ペア不足の検出（blink.L はあるが blink.R が無い、等） ・死にキー検出（Basisと同一形状＝変形し忘れの可能性） ・類似重複の検出（連番コピー「○○.001」のような名前） ・検証結果はBlender内のテキストとして出力でき、保存・共有が可能です 【一括管理】 ・一括リネーム：接頭辞の追加／削除、文字列の一括置換（Basis以外が対象） ・左右ミラーコピー：指定キーをX軸で左右反転コピー（.L⇔.Rの名前を自動提案） ・不足キーの空作成：不足している口パクキーと、まばたきキー（blink.L / blink.R）を空キーとして一括作成（※名前だけの空キーです。形状の彫刻は別途必要です） ■動作環境 ・Blender 4.2 LTS（4.2.3で動作検証済み） ・Blender 4.2系以外（4.1以下／4.3以上／5.x系）での動作は未検証です ・OS不問（Blenderが動作する環境） ・VRChat SDK・Unityとの連携機能はありません（Blender内で完結するツールです）。VRChat本体・VRC SDKとの連携は未検証です。また、VRChat本体およびVRC SDKとの互換性（Unity上でリップシンク／まばたきとして正しく割り当てられ、動作すること）は未検証であり、保証いたしません ■内容物 ・MiyabixShapeKeyTools-v1.zip（アドオン本体＋readme.txt） ※ インストールはこのZIPをそのままBlenderに読み込ませます（展開不要） ■注意事項 ・本ツールが扱うのはBlender内のシェイプキーの「名前と形状データ」です。キーの自動生成（顔形状から口パク形状を作る機能）はありません ・ミラーコピーは、鏡像位置の近傍にある頂点の変形を距離に応じた重みで混ぜ合わせて転写する計算です。コピー後には、対応の目安（対応良好率）と、転写不足の可能性を示す警告がパネルに表示されます。検証では、目の高さが左右で約2mmずれた自作モデル（約28,000頂点、滑らかな変形）で、まばたき変形の最大値の約99.7%が反対側へ転写されることを確認しています。ただし、変形の境目が急なキーでは境目がわずかに平滑化される場合があり、頂点の粗いメッシュや極端に非対称な部分では転写が弱くなる場合があります。結果は必ず目視で確認してください ・VRChat本体およびVRC SDKとの互換性は未検証であり、保証いたしません。本アドオンはBlender内での名前・形状データの整備を行うもので、VRChat側での動作結果を約束するものではありません ・VRChatへのアップロード前に、Unity上でリップシンク／まばたきの割り当てと動作を必ず最終確認してください ■検証状況について（正直なご案内） 本アドオンは、実際に販売するZIPファイルを使って、Blender 4.2.3 LTSにインストール・有効化したうえで、機能テスト全35項目（検証レポートの検出内容、一括リネーム、ミラーコピー、不足キーの空作成）を実施し、全項目合格を確認しています。 【動作確認済みの機能（Blender 4.2.3 LTS）】 ・販売用ZIPからのインストール・有効化 ・シェイプキー検証レポート（口パク不足・表記ゆれ・まばたき有無・左右ペア不足・死にキー・類似重複の検出）と、結果のテキスト出力 ・一括リネーム（接頭辞の追加／削除、文字列の一括置換） ・左右ミラーコピー（転写の目安＝対応良好率と、転写不足の可能性を示す警告の表示を含む） ・不足キーの空作成（口パクキー、まばたきキー） ・仮想ディスプレイ上の画面（GUI）環境で、サイドバーの「シェイプキー検証」タブとパネル表示、検証ボタンの実クリックによる実行と結果表示、ミラーコピー結果（対応良好率・警告）のパネル表示 ・実物に近い自作モデル（約28,000頂点、非対称部分を含む合成モデル。実在の商用アバターではありません）での全機能の動作と処理速度（いずれも1秒未満） ミラーコピーについては、当初「左右で約2mmずれた部分では変形が転写されない」という制限が判明したため、対応付け方式を改修しました（鏡像位置の近傍頂点から変形を転写する方式へ変更し、転写の目安と警告を表示する機能を追加）。改修後、同じ条件のモデルで再計測し、まばたき変形の最大値の約99.7%が反対側へ転写されることを確認しています。 【未検証の項目（保証いたしません）】 ・VRChat本体・VRC SDKとの連携、およびVRChat／Unity（VRC SDK）側での動作・割り当て結果（VRChat本体・VRC SDKとの互換性は保証しません） ・Blender 4.2 LTS以外のバージョンでの動作 ・実在の商用アバターモデルでの挙動、人間の制作者による実使用テスト ミラーコピーについては制限があります。近傍頂点から変形を転写する方式のため、極端に左右非対称な部分や頂点の粗い部分では転写が弱くなる場合があり、変形の境目が急なキーでは境目がわずかに平滑化される場合があります（詳細は同梱の説明書をご覧ください）。 万一お使いの環境で動作しない場合は、下記の返金規定で対応します。 ■返金規定 デジタル商品の性質上、原則として返金は行いません。ただし、動作環境（Blender 4.2 LTS）で本アドオンが利用できないなど、本アドオンの不具合で利用できない場合に限り、詳しい動作状況（OSとBlenderのバージョン、表示されたエラーメッセージ、実行した手順など）を記載のうえ、購入後5日以内に申請いただければ返金します。