Avatar Refinery Lite (アバターリファイナリー ライト)

Avatar Refinery Lite is a read-only Unity Editor extension that checks VRChat avatars before upload. It explains what was found, why it matters, and what to do next in English or Japanese, and can export the result as Markdown.

VRChatアバターをアップロード前にまとめて診断するUnityエディタ拡張です。「何が問題で・なぜ問題で・どう直すか」を日本語・英語で表示します。診断は読み取り専用で、アバターやアセットは一切変更しません。

  • 対応: Unity 2022.3.22f1 / VRChat SDK Avatars 3.9.x〜3.10.x (3.10.4 で検証) / NDMF・Modular Avatar・AAO 使用時は「ビルド後の姿」で性能を算定
  • VRChat SDK が無いプロジェクトでも、ジオメトリ・マテリアル・リグの汎用診断が動きます

使い方

  1. Tools > Avatar Refinery > Open Avatar Refinery
  2. Hierarchy でアバターのルートを選ぶ(自動で欄に入ります)
  3. ツールバーで Auto / 日本語 / English を選び、診断する / Check Avatar を押す

Hierarchy のアバターを右クリック → Avatar Refinery > Check This Avatar でも起動できます。 結果は「⛔ アップロードを止める / ⚠ 見た目・動作が壊れる / 📉 ランクを下げている / ℹ 情報」の4段階に分かれ、各項目に 症状 → 検出 → 対応(手順) が付きます。「詳細モード」で原因・影響・参考ページも表示されます。 「レポート保存」で Markdown ファイルに書き出せます(質問・依頼時の添付にどうぞ)。

診断項目(Lite)

分類項目
環境Unity バージョン / VRChat SDK バージョン / 旧 Dynamic Bone の残存
VRChat 設定VRC Avatar Descriptor の有無 / 視点位置 / 口パク(Viseme)/ Eye Look / Expression Parameters 容量・参照 / Expression Menu の参照切れ / FX の Write Defaults 混在 / 表情とまばたき・口パクの競合 / PhysBone の無効設定 / Missing Script
非破壊ツールNDMF(Modular Avatar / AAO 等)のビルド時エラー・警告。Expressions・Write Defaults はビルド後の状態で判定
マテリアル・テクスチャシェーダー欠落(ピンク)/ 空スロット / 非圧縮テクスチャ / Streaming Mip Maps / 4K 以上のテクスチャ
リグAnimator・Humanoid / 必須ボーン / 指ボーン
描画Anchor Override の不統一 / Bounds 異常 / メッシュ参照切れ
パフォーマンスPC・Quest 両方のランクと、各項目の「次のランクまであといくつ」
VRMVRM(VRoid 等)読み込み直後で VRChat 向け変換がまだの状態

導入

注意

  • 診断結果の「ランク」はローカルでの推定です。実際の値は VRChat のサーバー側で最終決定され、まれに異なることがあります。
  • 診断はアバターを変更しません。修正は表示された手順に沿って手動で行ってください。ワンクリックの自動修正(プレビュー・自動バックアップ・すべて元に戻す 付き)は製品版 Avatar Refinery Pro で提供しています: https://runsol.booth.pm/items/8737820
  • MMD 由来モデルなど、利用規約上 VRChat で使えないモデルの利用を推奨するものではありません。

サポート

  • 不具合報告・要望: 要望・不具合フォーム(匿名可・Googleログイン不要) https://docs.google.com/forms/d/e/1FAIpQLScE2Q7IN8UgO88KjfH6bPwvhwP3Wkc0ajo6aroXzEjgiCHuGg/viewform または X(旧Twitter)の DM → @runsol_ai
  • ツール内の「この項目を報告」「不具合・要望を送る」ボタンからも同じフォームが開きます(項目IDが自動入力されます。自動送信はしません)
  • 対象: 本ツールの不具合・使い方。個別アバターの改変相談・他ツールの不具合は対象外です。
  • レポート保存で出力した Markdown を添えていただくと、状況把握が早くなります。

ライセンス

利用規約は LICENSE.md を参照してください(再配布禁止・改変私用可)。

Package Name

com.avatarrefinery.core

Documentation

https://tmiosg-commits.github.io/avatar-refinery/

Repositories

Version

0.3.0 (Changelog)

Unity version

2022.3 or later

Dependencies

No dependencies

VPM Dependencies

Legacy Packages

No legacy packages

License

https://github.com/tmiosg-commits/avatar-refinery/blob/main/LICENSE.md

Author

tmios

Package JSON from Repository

{
  "name": "com.avatarrefinery.core",
  "displayName": "Avatar Refinery Lite",
  "version": "0.3.0",
  "unity": "2022.3",
  "description": "Read-only VRChat avatar preflight checks with Japanese and English guidance, performance estimates, and Markdown reports.",
  "author": {
    "name": "tmios",
    "url": "https://x.com/runsol_ai"
  },
  "documentationUrl": "https://tmiosg-commits.github.io/avatar-refinery/",
  "changelogUrl": "https://github.com/tmiosg-commits/avatar-refinery/blob/main/CHANGELOG.md",
  "licensesUrl": "https://github.com/tmiosg-commits/avatar-refinery/blob/main/LICENSE.md",
  "vpmDependencies": {
    "com.vrchat.avatars": ">=3.9.0 <3.11.0"
  },
  "legacyFolders": {},
  "hideInEditor": false,
  "url": "https://tmiosg-commits.github.io/avatar-refinery/downloads/com.avatarrefinery.core-0.3.0.zip",
  "zipSHA256": "869dc1d55f5196e82d4787c1ae2aadd673f875742a11f49addf585fa0e4b732e",
  "repo": "https://tmiosg-commits.github.io/avatar-refinery/vpm.json"
}