# StateChecker StateChecker は、VRChat Avatar 3.0 / Modular Avatar ギミックの Animator 状態を、アバター上で確認するためのデバッグ補助ツールです。 ギミックの `Animator` / `Modular Avatar Merge Animator` と同じ場所に `StateCheckerBuildSettings` コンポーネントを追加することで、現在どのステートにいるか、どの遷移条件が見えているか、Any State や current state の条件がどうなっているかを、アバター上の表示として確認できます。 Animator Controller の構造は、StateChecker が独自のデバッグボードとして再描画します。Unity Animator ウィンドウのスクリーンショット、Unity公式UI、VRChat公式UIをコピー・同梱するものではありません。 --- ## 利用規約 / Terms of Use 購入・利用前に、必ず利用規約をご確認ください。 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 商品ページ内の説明は、利用規約PDFの要約・補足です。 内容に差がある場合は、利用規約PDFを優先します。 --- ## Unityバージョン / Unity Version Unity 2022.3 2022.3.22f1 で制作・検証しています。 --- ## 前提アセット / Requirements - VRChat SDK - Base 3.10.4 - VRChat SDK - Avatars 3.10.4 - Modular Avatar 1.17.1 - NDMF 1.13.1 ※ StateChecker 本体は lilToon を前提アセットとして使用していません。 ※ 使用するアバターや他のギミック側で lilToon が必要な場合は、それぞれの商品の案内に従ってください。 --- ## ご利用前に StateChecker は、制作中・調整中のギミックを確認するためのデバッグ補助ツールです。 初めて導入する場合や、既存の制作プロジェクトに追加する場合は、必ず事前にプロジェクト全体、または対象アバター・Prefab・Animator Controller・AnimationClip などのバックアップを作成してください。 なるべくクリーンな検証用プロジェクト、またはバックアップ済みのプロジェクトで動作確認してから使用することをおすすめします。 本ツールは、元の Animator Controller や AnimationClip を直接編集しない設計ですが、Unity / VRChat SDK / Modular Avatar / NDMF の構成やバージョン、導入済みギミックとの組み合わせによって、生成結果や表示内容が変わる場合があります。 既存ギミック、販売用アバター、納品用データなど重要なプロジェクトで使用する場合は、必ず事前に複製・バックアップを行い、問題がないことを確認してからご利用ください。 ## 主な機能 - Animator Layer / State / Transition の可視化 - 現在アクティブな State のハイライト表示 - Any State 条件の表示 - current state に対応した条件パネル表示 - 遷移条件の成立 / 不成立の確認 - Sub-State Machine の表示 - BlendTree state の表示 - アバター上での表示位置調整 - 表示スケール調整 - Reset Position メニュー - 必要に応じた表示操作の同期設定 - 複数の StateChecker 設定を 1 つの表示にまとめる生成処理 --- ## 想定用途 - Modular Avatar ギミックのデバッグ - Expression Menu / Parameter の切り分け - Parameter Driver による状態変化の確認 - 複数レイヤーを持つ Animator の状態確認 - Contact / Menu Parameter / Parameter Driver 周りの確認(パラメーターでの間接的な確認になります) - ギミック制作中の状態共有・相談 - ギミック販売前、配布前のチェック --- ## 基本的な使い方 1. StateChecker を Unity プロジェクトにインポートします。 2. 確認したいギミックの GameObject を選択します。 3. `StateCheckerBuildSettings` コンポーネントを追加します。 4. 必要に応じて位置・スケール・同期設定を調整します。 5. NDMF / Modular Avatar のビルド時に StateChecker 表示が生成されます。 6. アバター上で現在ステートや遷移条件を確認します。 事前生成ボタンは、ローカルで表示を確認・更新したい場合に使用します。 アップロード / NDMF ビルド時には自動生成されるため、通常は必須ではありません。 --- ## 動作確認について / Runtime Check ローカルでステート遷移や表示状態を確認する場合は、Av3Emulator を使用できます。 アップロード前に、現在ステートのハイライト、Any State 条件、current state 条件パネル、表示位置やスケールなどを確認する用途に向いています。 Gesture Manager でも一部の確認ができる場合がありますが、StateChecker の主な確認方法としては推奨していません。 Modular Avatar / NDMF によるビルド後の構成や、VRChat Avatar 3.0 の実際の Animator / Playable 状態に近い確認を行う場合は、Av3Emulator または VRChat SDK のビルド・実機確認をおすすめします。 --- ## 表示と同期について 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. StateChecker は、VRChat SDK、Modular Avatar、NDMF と組み合わせて使用することを想定していますが、これらの SDK / パッケージ本体は同梱していません。 各ツールの利用条件、ライセンス、導入方法については、それぞれの公式配布元・ドキュメントを確認してください。 StateChecker は、ユーザーの代わりに VRChat へアバターやワールドをアップロードする機能、VRChat アカウント情報を取得する機能、VRChat API に接続する機能を持ちません。 本商品の制作・検証・商品説明文の整理に、制作補助ツールとして OpenAI Codex を使用しています。 最終的な内容確認、配布判断、利用規約・商品説明の掲載判断、サポート対応は作者が行っています。 --- ## サポートログについて 問い合わせ用に、StateChecker 関連の診断情報を zip として出力する機能があります。 このログは、Unity Console、パッケージ情報、StateChecker 関連のエラー抜粋など、問題調査に必要な範囲を収集するためのものです。 個人パス、ユーザー名、トークンらしい値は伏せる処理を行っていますが、送信前に必ず中身を確認してください。 完全な Unity Editor.log、シーン、Prefab、Animator Controller、生成アセットの YAML ファイルは含めません。 --- ## 使用上の補足 - アバター直下ではなく、確認したいギミック単位に追加して使用してください。 - 大規模な Animator や多数のギミックをまとめて確認する場合、表示が大きくなることがあります。 - 見やすさに応じて、表示位置やスケールを調整してください。 - Quest / Android 向けの軽量運用は、各自の環境で確認してください。 - 最終的なアップロード可否、VRChat上での動作、他ユーザーからの見え方は、各自の環境で確認してください。 --- ## 対応想定 - Unity 2022.3 系（2022.3.22f1 で制作・検証） - VRChat Avatar 3.0 - Modular Avatar / NDMF を使用したギミック - PC向けアバター制作環境 - ローカル確認には Av3Emulator の使用を推奨 --- ## 利用条件 本商品の正式な利用条件は、上記「利用規約 / Terms of Use」のPDFに従います。 この項目は、商品ページ向けの要約・補足です。 StateChecker 本体、同梱スクリプト、同梱アセット、同梱フォントを含む Unity package の再配布・再販売・改変配布は禁止です。 購入者本人（個人または法人）の制作環境、検証環境、または購入者本人が管理するプロジェクト内で使用してください。 チーム制作・外部委託などで複数人が直接 StateChecker を使用する場合は、使用者ごとに正規の入手をお願いします。 StateChecker を使用して生成したデバッグ表示は、制作・検証目的で使用できます。 VRChat 等へのアップロードは、利用規約の範囲内で行ってください。 ただし、StateChecker 本体や同梱ファイルを取り出して配布することはできません。 --- ## 免責・補足 StateChecker は、VRChat Avatar 3.0 / Modular Avatar ギミック制作を補助するデバッグ用ツールです。 本ツールの導入、使用、生成結果の確認、アバターのアップロード作業は、利用者ご自身の判断と責任において行ってください。 使用前には必ずプロジェクトのバックアップを取り、必要に応じて検証用プロジェクトで動作確認してください。 本ツールを使用したこと、または使用できなかったことによって発生した、プロジェクト、アバター、アップロードデータ、各種アセット、作業データ、販売物、作業時間などへの影響について、作者は責任を負いかねます。 Unity / VRChat SDK / Modular Avatar / NDMF / 導入済みギミックの構成やバージョンによって、生成結果や表示内容が変わる場合があります。 すべての環境での動作、特定のアバター・ギミック構成での完全な表示、VRChat 上での見え方や同期挙動を保証するものではありません。 不具合が確認された場合は、可能な範囲で調査・修正対応を行いますが、すべての環境・組み合わせでの動作保証はできかねます。 ## ライセンス・権利表記 本ツールには、文字表示用として以下のフォントファイルを同梱しています。 ### Noto Sans JP / Noto Sans CJK JP - File: `NotoSansCJKjp-Black.otf` - License: SIL Open Font License 1.1 - Source: Google Fonts / Noto Fonts - License text: 同梱の `OFL.txt` を参照してください。 フォント関連ファイルは、パッケージ内の以下に含まれています。 `Assets/Iris0000/StateChecker/ThirdParty/Fonts/NotoSansJP/` また、第三者ライセンス情報は以下にも記載しています。 `Assets/Iris0000/StateChecker/ThirdParty/NOTICE.md` 同梱フォント自体は SIL Open Font License 1.1 に基づきます。 ただし、これは StateChecker 本体、Unity package、同梱スクリプト、同梱アセットの再配布を許可するものではありません。 フォントファイルを含む形で本ツールを扱う場合は、同梱の `OFL.txt` および関連 notice を削除しないでください。