# StateChecker v2 Beta StateCheckerは、VRChat Avatar 3.0／Modular AvatarギミックのAnimator状態を、アバター上で確認するためのデバッグ補助ツールです。 確認したいギミックの `Animator`／`Modular Avatar Merge Animator` と同じGameObjectへ `SC: State Checker Build Settings` を追加すると、Animator Layer、State、Transition、条件の成立状況を、VR内で見られるデバッグボードとして生成します。 > 2026/08/08：配布ファイルに `StateChecker_v2.0.0-beta.1_SHARE.zip` を追加しました。 --- ## StateCheckerの主な機能 - Animator Layer／State／Transitionの可視化 - 現在アクティブなStateのハイライト - Any Stateとcurrent stateに関係する条件の表示 - 遷移条件の成立／不成立の確認 - Sub-State Machine／BlendTree stateの表示 - 複数のStateChecker設定を1つの表示へ統合 - VR内での表示位置、スケール、ページの操作 - Reset Positionメニュー - 必要に応じた表示操作の同期設定 - Editor上で詳細比較できるCombined Animator Watcher 通常は、確認したいギミック単位で `SC: State Checker Build Settings` を使用してください。 --- ## v2 Betaで追加・改善した内容 - Add Component名を `SC:` で始まる名称に統一 - 複数設定の統合表示と、複数アバターを開いたときの生成物分離を改善 - Avatar WideとPseudo Remote Avatar Simulatorを標準パッケージへ同梱 --- ## Avatar Wide `SC: State Checker Avatar Wide Build Settings` をVRCAvatarDescriptor配下へ追加すると、アバター全体のModular Avatar Merge Animator、Animator、Avatar DescriptorのカスタムAnimation Layerを収集し、1つのStateCheckerへまとめます。 全レイヤーを対象にするため、アバターによっては生成ボード、Animator Layer、Clip、Renderer、Materialが大きく増え、SDK Build／Upload時間にも影響します。通常のギミック確認ではAvatar Wideではなく、通常版のState Checker Build Settingsを使用してください。 --- ## Pseudo Remote Avatar Simulator `SC: Pseudo Remote Avatar Simulator` は、自分の前へ疑似リモートアバターのクローンを生成し、次の差をVR内で観察するための実験的なデバッグ機能です。 - クローン側での `IsLocal=false` の近似 - 固定周期でコピーするパラメーター遅延 - Local／RemoteのStateCheckerを同じLayerごとに横並び表示 - Localを薄い水色、Remoteを薄いピンクで表示 - VRメニューからクローン表示、追従、World Fixedを切り替え Pseudo Remoteは別クライアントそのものではありません。VRChatの正確なserialization順、packet loss、ownership、remote IK、late join、実ネットワークの補間を完全には再現しません。 同期不具合の候補を探すための近似機能として使用し、最終確認はアップロード後に別クライアント／別アカウントから行ってください。 --- ## 導入・更新方法 1. Unityプロジェクトをバックアップしてください。 2. v1.1.1以前、または導入中の版が不明な場合は、UnityのProjectウィンドウから次の旧フォルダを削除してください。 - `Assets/Iris0000/StateChecker` - `Assets/Iris0000/StateCheckerAvatarWide` - `Assets/Iris0000/StateCheckerPseudoRemote` 3. `StateChecker_v2.0.0-beta.1.unitypackage` をインポートしてください。 4. Unityのインポートとコンパイルが完了し、Consoleにエラーがないことを確認してください。 同じv2 Betaから更新する場合は、フォルダを削除せず上書きインポートできます。 `Assets/Iris0000` フォルダ全体や、同じ作者の別製品フォルダは削除しないでください。 旧フォルダの削除からインポート完了まで、Missing Script状態のScene／Prefabを保存しないでください。 詳しい導入手順と制限は、配布ZIP内の `README_JA.md` を確認してください。 --- ## 基本的な使い方 1. 確認したいギミックのGameObjectを選択します。 2. `Iris0000/State Checker/SC: State Checker Build Settings` を追加します。 3. InspectorのBuild操作、または `Tools/Iris0000/State Checker/Build Selected StateChecker Settings` を実行します。 4. Av3Emulator、またはアップロードしたPCデバッグアバターで表示を確認します。 5. Editor上での詳細比較には `Tools/Iris0000/State Checker/Combined Animator Watcher` を使用できます。 NDMF／Modular Avatarのビルド時にも自動生成されるため、事前生成は通常必須ではありません。 --- ## 制作・検証環境 - Unity 2022.3.22f1 - VRChat SDK - Base 3.10.4 - VRChat SDK - Avatars 3.10.4 - Modular Avatar 1.17.1 - NDMF 1.13.1 - PC向けVRChatアバター制作環境 Av3Emulatorはローカル確認に利用できますが、配布機能の実行時依存ではありません。 StateChecker本体はlilToonを前提アセットとして使用していません。 VRChat SDK、Modular Avatar、NDMF、Av3Emulator本体は同梱していません。 --- ## ご利用前の注意 - 必ずプロジェクト、対象アバター、Prefab、Animator Controller、AnimationClipなどのバックアップを作成してください。 - なるべくクリーンな検証用プロジェクト、またはバックアップ済みプロジェクトで先に確認してください。 - 表示操作は基本的にローカル確認用です。他ユーザーにも表示操作を見せる同期設定を有効にすると、VRChatの同期パラメーター容量を使用します。 - 大規模なAnimatorや多数のギミックでは、生成される表示とAnimatorが大きくなる場合があります。 - Quest／Android向けの軽量運用は保証していません。 - 最終的なSDK Build／Upload、VRChat上での表示、他ユーザーからの見え方は各自の環境で確認してください。 - すべてのアバター、ギミック、SDK／Package構成での完全な動作を保証するものではありません。 --- ## 利用規約／Terms of Use 購入・利用前に、必ず正式な利用規約をご確認ください。商品ページ内の説明と内容が異なる場合は、利用規約PDFを優先します。 - JP https://drive.google.com/file/d/1vUju2tra_E4MWIy_YHjJPlCIViUOXOmq/view?usp=drive_link - KR https://drive.google.com/file/d/1ggWB-MxS4Gx_8SxbSFkTawKFAHFoiFBD/view?usp=drive_link - EN https://drive.google.com/file/d/1E7QGocoMRJRkWIxDEVWI1V9-N7rVysTn/view?usp=drive_link StateChecker本体、同梱スクリプト、同梱アセット、UnityPackageの再配布・再販売・改変配布は禁止です。 チーム制作や外部委託などで複数人が直接StateCheckerを使用する場合は、使用者ごとに正規の入手をお願いします。 StateCheckerを利用して生成したデバッグ表示は、利用規約の範囲内で制作・検証およびVRChatへのアップロードに使用できます。 --- ## 権利・ライセンス表記 本ツールはVRChat Inc.、Unity Technologies、Modular Avatar／NDMF関連作者による公式ツールではありません。 This product is an unofficial tool and is not affiliated with or endorsed by VRChat Inc., Unity Technologies, or the authors of Modular Avatar / NDMF. 文字表示には、Noto Sans JP／Noto Sans CJK JP由来の静的Glyph Atlasを使用しています。 v2 Betaの配布物にはTextMeshProおよび元のOTFファイルを同梱せず、SIL Open Font License 1.1の本文と第三者通知を同梱しています。 フォントのライセンスはStateChecker本体やUnityPackageの再配布を許可するものではありません。 本商品の制作・検証・商品説明文の整理には、制作補助ツールとしてOpenAI Codexを使用しています。 最終的な内容確認、配布判断、利用規約・商品説明の掲載判断、サポート対応は作者が行っています。 --- ## 免責 StateCheckerの導入、使用、生成結果の確認、アバターのアップロード作業は、利用者ご自身の判断と責任で行ってください。 本ツールを使用したこと、または使用できなかったことによって発生した、プロジェクト、アバター、アップロードデータ、各種アセット、作業データ、販売物、作業時間などへの影響について、作者は責任を負いかねます。 不具合が確認された場合は可能な範囲で調査・修正対応を行いますが、すべての環境・組み合わせでの動作保証はできません。