コンテンツにスキップ

トラブルシューティング

まずは診断を実行してください

Tools > MGR > Staff Bridge System > セットアップ > 診断・修復 を開いて実行します。配線漏れ、必須オブジェクトの不足、前提パッケージの未導入など、よくある不具合の多くはここで検出でき、ボタンで修復できます。

診断・修復タブ


メニューの文字が表示されない

原因: 日本語フォント net.narazaka.vrchat.tmp-fallback-fonts-jp が未導入です。

文字が豆腐(□)になるのではなく、フォント参照そのものが欠落した状態になります。すでに別の日本語 TMP フォールバックを設定している環境でも、参照しているフォントアセットが異なるため代替にはなりません。

対処: VCC / ALCOM で導入してからシーンを再読み込みしてください。セットアップウィンドウの「導入ページを開く」ボタンからも配布元を開けます。


メニューが開かない

  • スタッフになっていない可能性があります。メニューはスタッフ状態のプレイヤーだけが開けます。一覧ボードや頭上マーカーで自分がスタッフになっているか確認してください。
  • 長押しが足りていない可能性があります。既定では 0.5 秒の長押しが必要です。VR は右スティックを下に倒して長押し、Desktop は既定 Tab キーの長押しです。
  • Desktop キーが他のギミックと競合している場合は、StaffMenuShell の「Desktop開閉キー」を変更してください。

スタッフにならない

  • 表示名が名簿と完全一致していないことが最も多い原因です。前後の空白、全角半角、絵文字の有無を確認してください。
  • 名簿を編集した後、ワールドを再アップロードしていない可能性があります。名簿はワールドに焼き込まれます。
  • 途中入室でも名簿による付与は働きます。反映されない場合は、誰かが入退室すると名簿が配り直されて揃うことがあります。
  • 応急処置として、スタッフ切替スイッチでその場でスタッフにできます。

インカムの音声が聞こえない

特定の人だけ聞こえない

その人が同じチャンネルに参加していない可能性が高いです。メニューのメンバー一覧で参加状況を確認してください。チャンネルを入り直すと復帰します。

チャンネル参加と名簿は、同期の取りこぼしを検出すると自動で再送する仕組みが入っています(3秒間隔で最大3分間)。それでも直らない場合は Rejoin してください。

全員聞こえない

  • FukuroUdon が未導入のまま生成された可能性があります。診断で確認してください。
  • 音声基盤(PA Supervisor)が複数存在すると、プレイヤータグを取り合って正しく動作しません。診断が複数検出した場合は1つに統合してください。

来場者に聞こえてしまう

「スタッフ限定モード」が OFF になっていないか確認してください。この設定はワールドに焼き込まれるため、変更後は再アップロードが必要です。

「診断・修復」タブの「インカム聴こえ方マトリクス検査」で、設定した構成での聴こえ方をエディタ上で事前確認できます。


メニューを閉じるとインカムが使えない

インカム本体が常時アクティブなオブジェクトに置かれていない可能性があります。メニュー配下に置くと、メニューを閉じた時点で動作が止まります。

StaffIncomRadio を選択すると、Inspector に注意書きが出ます。その場合は、メニューの外にある常時アクティブなオブジェクトへ手動で移動してください。


インカム設置時に警告が出る

FukuroUdon はバージョンによって内部のフィールド名が変わることがあります。本製品はリフレクションで連携しているため、動作確認済みの 3.18.0 の利用を推奨します。


テーマを適用しても色が変わらない

  • プレイモード中は適用できません。プレイ中の変更はプレイ終了時に元へ戻るため、ボタンが無効化されます。
  • 塗り替えはテーマの色と一致する要素のみを対象にします。生成時と別の色を手動で塗った要素は変更されません。

アップロード時に警告ダイアログが出る

StaffRegistry の「ログ出力する」が ON になっています。公開後もスタッフの表示名が Console に出続けるため、通常は OFF を推奨します。

警告のみで、アップロードはそのまま続行されます。


生成や診断が動かない

フォルダの中身の構成を変えていると参照できません。Prefabs / Audio / Samples などのサブフォルダごと移動していないか確認してください。

インポートしたファイルの一部だけを削除している場合も同様です。unitypackage を再インポートして復元してください。


解決しない場合

BOOTH のメッセージ機能からご連絡ください。次の情報があると調査が早く進みます。

  • 本製品のバージョン(メニューのヘッダー右上、または お読みください.txt
  • Unity のバージョンと VRChat SDK のバージョン
  • FukuroUdon のバージョン
  • 診断・修復タブの実行結果(スクリーンショット)
  • Console に出ているエラーメッセージ