そのVRM、何メガ太っていますか？ KaruiMendは、あなたの `.vrm` ファイルの「どこに何バイト 使われているか」をテクスチャごとに数字で示し、**安全が 証明できる削減だけ** を行った軽いコピーを書き出すツールです。 - **軽量化チェック（監査）**：画像ごとに、名前・ピクセル サイズ・バイト数・ファイル全体に対する割合・使われ方を表示。 大きすぎるテクスチャ、未使用データ、重複も検出します - **最適化**：可逆PNG再圧縮（画素が完全一致した場合だけ採用）、 参照を証明できた未使用データの除去、そして任意のテクスチャ 縮小（初期設定オフ）だけを行い、変更は全件ログに記録します UnityもBlenderも不要。Windows / Mac / Linux で動きます。 **元のファイルは、どの処理でも絶対に上書きしません。** そして最初にお伝えします。このツールには **モーフ（シェイプキー）の削除機能がありません。** 理由は「正直な制限事項」の節で説明します。 --- ### 1. 軽量化チェック（監査） `.vrm` を指定するだけで、テクスチャごとの表と検出結果を 出します（画面表示＋ `.diet-audit.txt` / `.diet-audit.json` ファイル出力）。監査は読み取り専用で、ファイルは変更しません。 検出する項目： - **大きすぎるテクスチャ**（2048px超／単体2MB超） - **写真的なPNG**：可逆形式のままだと重い可能性が高いもの。 **監査での指摘のみ** で、形式変換は行いません - **どこからも参照されていない画像・テクスチャ・マテリアル** - **バイト単位で同一の重複画像** - **外部ファイル参照（uri）の画像**：このツールの対象外として報告 参照のたどり方も全部入りです。メッシュのマテリアルはもちろん、 マテリアル拡張（KHR_materials_* や MToon）のテクスチャスロット、 テクスチャの source、メタ情報のサムネイルまで追跡します。 #### サンプルレポートの実数（テスト用ファイルでの結果） テクスチャ中心のテスト用ファイル（VRM 1.0、11,300,748バイト） での監査結果：画像6枚でファイルの **100.0%** を占め、検出は **9件** でした。 | 画像 | サイズ | バイト数 | 割合 | 検出 | |---|---|---|---|---| | #0 dead | 800×600 PNG | 1,442,621 | 12.8% | 写真的なPNG、未使用 | | #1 bigphoto | 2200×1100 PNG | 7,271,360 | 64.3% | 2048px超、写真的なPNG、2MB超 | | #2 flat（サムネイル） | 512×512 PNG | 787,271 | 7.0% | 重複 | | #3 flat_dup | 512×512 PNG | 787,271 | 7.0% | 重複 | | #4 orphan | 300×300 PNG | 828 | 0.0% | 未使用 | | #5 photo_jpg | 1600×900 JPEG | 1,007,326 | 8.9% | ― | このほか、未使用マテリアル1件・未使用テクスチャ1件も検出。 ※テスト用ファイルでの結果です。お手元のファイルでは 内訳も件数も変わります。ギャラリーの監査レポートカードも 同じ実行結果です。 ### 2. 最適化（安全な削減だけ） 監査で見えた削減を、実際に書き出すのが最適化です。 出力はコピー＋変更の全記録（`.dietlog.json`、日本語・英語）。 行うのは次だけです。 - **可逆PNG再圧縮**：再圧縮結果が「より小さく」かつ 「デコード後の画素が完全に一致」した場合にだけ採用します。 一致しなければ元のバイト列のまま残し、その旨をログに記録 します。**JPEGの再圧縮は劣化するため行いません** - **未使用データの除去**：ファイル全体の参照をたどり、 どこからも参照されていないと **証明できた** 画像・ テクスチャ・マテリアルだけを除去（番号の振り直し込み）。 証明できないものは消さず、「保持した項目」として理由を ログに残します - **テクスチャ縮小（任意・初期設定オフ）**：`--max-size N` を 指定した場合のみ、最大辺がNピクセルを超えるテクスチャを 縮小します。**見た目が変わるのはこの処理だけです** 最適化のたびに自己検証が動きます：入力ファイルが変更されて いないこと（ハッシュ確認）、出力が再び読み込めること、 ノード／メッシュ／アクセサ／スキン／アニメーションの数が 変わっていないこと、再圧縮したテクスチャの画素一致。 **最適化済みのファイルに最適化をかけ直しても、変更は0件です。** #### 実例（検証済みの数値） **公式サンプルモデル Seed-san（VRM 1.0、実ファイル）を 標準設定（可逆のみ）で最適化：** - **10,917,800 → 9,435,424 バイト（−1,482,376バイト、−13.6%）** - 内訳：可逆PNG再圧縮 **15件**（すべて画素一致を確認して採用） ＋ 未使用テクスチャ **1件** の除去。画像・マテリアルの除去は0件 - このファイルでは画像が全体の **63.7%**（6,952,233バイト） でした。容量の大半がジオメトリやモーフにあるファイルは、 その分だけ軽くなりにくくなります（監査が先に数字で示します） **テクスチャ中心のテスト用ファイルでは：** - 標準設定（可逆のみ）：11,300,748 → **8,285,016 バイト（−26.7%）** - 任意オプションの縮小（最大1024px）付き：11,300,748 → **2,330,628 バイト（−79.4%）** ― ただし縮小は見た目が変わります どちらの実例も、最適化後のファイルを Blender 公式の VRM アドオンで読み戻し、構造カウント（オブジェクト／メッシュ／ マテリアル／ボーン／SpringBone）が最適化前後で一致することを 確認しています。 ### 最適化を拒否するファイル 壊すくらいなら止める、がこのツールの方針です。次に当てはまる ファイルは最適化を **拒否** し、理由をログに残して **何も書き出しません**。 - 外部バッファ（uri参照）や複数バッファを持つファイル - EXT_meshopt_compression 等の圧縮済みバッファビュー、 KHR_draco_mesh_compression を含むファイル - バイト範囲が部分的に重なるバッファビューを持つファイル - GLBとして読み込めないファイル ### 安全へのこだわり（検証済みの動作） - **元のファイルは絶対に上書きしません**（入力と出力が 同じ場所だと拒否します。最適化の最後に入力ファイルの ハッシュが変わっていないことを確認します） - 監査は読み取り専用です。最適化は新しいファイルに書き出します - 変更はすべて `.dietlog.json` に記録されます。 **黙って消えるデータはありません** - 参照を証明できないデータは消さずに残し、理由を記録します ### 使い方 1. Python 3.10以上と **Pillow** を用意します （`pip install Pillow`。画像の読み書きに必要です。 **姉妹ツールと違い、このツールには Pillow が必要です**） 2. GUI版：`python3 diettool_gui.py` からファイルを選んで 「軽量化チェック」→必要なら最大サイズを指定して 「最適化して保存」 コマンドライン版： `python3 diettool.py audit your_avatar.vrm` `python3 diettool.py optimize your_avatar.vrm your_avatar_diet.vrm` `python3 diettool.py optimize your_avatar.vrm your_avatar_diet.vrm --max-size 1024` 3. 出力されたコピーを、お使いのアプリで確認してから ご利用ください（元のファイルは必ず残しておいてください） 詳しい手順は同梱の `MANUAL_JP.md` をご覧ください。 ### 購入前に — 無料で試せます - **体験版（無料）**：軽量化チェックは製品版とまったく同じ **全機能** です。最適化は、製品版と同じ処理・同じ自己検証を 一時ファイルで実行する **プレビュー** で、「何バイトになるか」 「何がどう変わるか」の実際の数字を表示します（ファイルの 書き出しは製品版のみ）。まずはこちらで、お使いのファイルの 見込みを確かめてください。 体験版はこのページから無料でダウンロードできます。 - **FitPass VRM（姉妹ツール）**：アプリ別（VSeeFace / Warudo / VMagicMirror / cluster）の適合チェック＆VRM 1.0 → 0.x 変換 ツールです。「軽いのに読み込めない」を防ぎたい方はこちら。 FitPass VRM はこちら：https://decnet.booth.pm/items/9083140 - **YureMend（姉妹ツール）**：揺れもの（SpringBone）専用の 監査＆クリーンアップツールです。 YureMend はこちら：https://decnet.booth.pm/items/9083625 - **MorphAudit（無料）**：同じショップの姉妹ツール。 こんどは **表情** の監査ツールです。 MorphAudit はこちら：https://decnet.booth.pm/items/9083736 ### サポート お問い合わせはBOOTHのメッセージからお願いします。その際、 監査レポート（`.diet-audit.txt` の内容、またはGUIのレポート）と KaruiMendのバージョンを添えていただけると対応が早くなります。 不具合のご報告には、確認のうえアップデートで対応し、この ページの更新履歴に記録します。 あわせてどうぞ：アプリ別適合の **FitPass VRM**、揺れもの専用の **YureMend**、表情監査の **MorphAudit**（無料）も同じショップに あります。 © Decnet Games