VRMの揺れもの、そのままにしていませんか？ YureMendは、あなたの `.vrm` ファイルの揺れもの（SpringBone） データを **監査** し、壊れた参照・重複や未使用のコライダー といった「壊れている／死んでいる」と証明できるデータだけを 取り除いた **クリーニング済みコピー** を書き出すツールです。 UnityもBlenderも不要。元のファイルには一切手を加えません。 - まず **監査**：チェーン／コライダーの一覧、壊れた参照、 無駄なデータ、範囲外パラメーターの警告をレポート - 次に **クリーンアップ**：JSONレベルで安全に取り除けるもの だけを除去し、**全変更を理由つきのfixログ**に記録 - さらに **ドナーコピー**：別の `.vrm` からコライダーセットを ボーン名で照合してコピー 「直す前に、まず見えるようにする」——それがこのツールの 仕事です。 --- ### 監査で分かること - VRMの規格（1.0 / 0.x）とメタ情報 - チェーン（スプリング／ボーングループ）の一覧：ルートボーン、 ジョイント、使用中のコライダーグループ、センター - コライダー（球／カプセル／平面）とコライダーグループの一覧 - **壊れた参照**：存在しないノードを指すジョイント・コライダー、 範囲外のコライダーグループ参照など - **無駄なデータ**：重複コライダー、使われていない／空の コライダーグループ、重複チェーンなど - **気になるパラメーター**：dragForce、stiffness、gravityPower、 hitRadius、コライダー半径、gravityDir が目安の範囲を 外れている場合の警告 #### サンプルレポートの実数（テスト用ファイルでの結果） 監査：規格 VRM 1.0／チェーン 4件（ジョイント合計9）／ コライダー 5件・グループ 3件／**指摘 合計9件** （エラー 4／警告 4／情報 1）——存在しないノードのコライダー、 重複コライダー、半径0.3m、未使用グループ、dragForce 1.7、 stiffness −0.5 など、テスト用ファイルに意図的に仕込んだ 不具合を実際に検出した結果です。 公式サンプルモデル（Seed-san、VRM 1.0）では監査のみ実行し、 スプリング9件・ジョイント28件・コライダー8件、**指摘0件** を確認しています（正常なファイルへの誤検出なし）。 ### クリーンアップで取り除くもの（これだけです） - 存在しないコライダーグループ／コライダーを指す参照 - 末尾にある、存在しないノードのジョイント （チェーンの途中にあるものは、つなぎ直しになるため **取り除かず**、スキップとして報告します） - ジョイントが0になったチェーン、存在しないノードに付いた コライダー、重複コライダー、使われていない／空になった コライダーグループ（参照番号は自動で振り直され、連鎖的な 変更もすべてログに残ります） 同じサンプルでのクリーンアップ結果—— チェーン 4→3件、ジョイント 9→7、コライダー 5→3、 コライダーグループ 3→1、変更 全9件をログに記録。 パラメーター警告（4件中3件＋情報1件）は **残ります**。 パラメーターは「あなたの設定」なので、本ツールが勝手に 書き換えることは決してありません。 ### 安全へのこだわり（検証済みの動作） - **元のファイルは絶対に変更しません**（入力と出力は別ファイル） - 書き換えはJSON部分のみ。**バイナリ（BIN）は元ファイルと バイト単位で完全に一致**します - クリーンアップ済みファイルに再度fixをかけても、 **二度目は何も変わりません**（冪等性を確認済み） - 出力後に自動で再チェック：再パースできること、再監査で 対象の問題が0件であることを毎回確認します ### ドナーコピー 別の `.vrm`（ドナー）から、コライダーのセットを **ボーン名で 照合して** コピーできます（`--donor-group` で対象グループの 絞り込み可）。 - `--donor-settings` を付けると、チェーンの設定もボーン名で 照合してコピーします（**同じ規格同士のみ**。1.0と0.xでは パラメーターの持ち方が違うため、規格違いはスキップとして 正直に報告されます） - 規格をまたぐコライダーコピーは球（sphere）のみ対応。 0.xにはカプセル／平面が無いため、該当するものは球に近似 せず、スキップとして報告します - ドナー側でどのグループにも属していないコライダーは コピーしません（ドナー側でも無効なデータのためです） - センターは番号ではなくボーン名で引き直します ### 使い方 1. Python 3.10以上を用意します（インストールは不要です） 2. コマンドライン版： `python3 springtool.py audit your_avatar.vrm` `python3 springtool.py fix your_avatar.vrm your_avatar_clean.vrm` GUI版：`python3 springtool_gui.py` からファイルを選ぶだけです 3. 出力されたコピーを、お使いのビューアで確認してから ご利用ください（元のファイルは必ず残しておいてください） 詳しい手順は同梱の `MANUAL_JP.md` をご覧ください。 ### 購入前に — 無料で試せます - **体験版（無料）**：監査は製品版とまったく同じ全機能。 クリーンアップは「何がどう直るか」のプレビュー表示まで できます。まずはこちらで、お使いのファイルの状態を 確かめてください。 体験版はこのページから無料でダウンロードできます。 - **MorphAudit（無料）**：同じショップの姉妹ツール。 こんどは **表情** の監査ツールです。揺れものは YureMend、 表情は MorphAudit —— あわせてどうぞ。 MorphAudit はこちら：https://decnet.booth.pm/items/9083736 - **FitPass VRM**：同じショップの姉妹ツール。アプリ別 適合チェックと VRM 1.0 → 0.x 変換に、揺れもの クリーンアップも内蔵しています。 FitPass VRM はこちら：https://decnet.booth.pm/items/9083140 - **KaruiMend**：VRM の軽量化チェック＆安全最適化の 姉妹ツールです。ファイルサイズが気になる方はこちら。 KaruiMend はこちら：https://decnet.booth.pm/items/9083713 ### サポート お問い合わせはBOOTHのメッセージからお願いします。その際、 監査レポート（`.sb-audit.txt` の内容、またはGUIのレポート）と YureMendのバージョンを添えていただけると対応が早くなります。 不具合のご報告には、確認のうえアップデートで対応し、この ページの更新履歴に記録します。 表情チェックとの組み合わせ：同じショップで無料配布している **MorphAudit（無料）** は `.vrm` の表情をチェックする 姉妹ツールです。あわせてご利用いただけます。 © Decnet Games