コンテンツにスキップ

トラブルシューティング

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

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

診断・修復ページ

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

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

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

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

導入済みなのに出ない場合: TMP Essentials が未インポートの可能性があります。Assets/TextMesh Pro/ フォルダが無ければ、Window > TextMeshPro > Import TMP Essential Resources を実行してください。この状態は診断でも「TMP Essentials（TextMesh Pro の初期リソース）」の警告として検出されます。詳しくは 導入 を参照してください。

メニューが開かない

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

メニューのボタンが押せない・反応しない

  • ワールドのオブジェクトとボタンが重なっている可能性があります。開いたメニューは手前に描画されますが、当たり判定のあるオブジェクトの向こう側にあるボタンはレーザーが遮られて押せません。少し移動して開き直してください。

メニューがワールドのオブジェクトに隠れて見えない

  • v1.1.0 以降は、開いたメニューや視界の表示が手前に描画されます。以前の版から更新したプロジェクトで反映されていない場合は、セットアップ窓の「診断・修復」から「メニューを手前に描く」を実行してください。

スタッフにならない

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

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

特定の人だけ聞こえない

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

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

全員聞こえない

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

スタッフ以外に聞こえてしまう

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

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

インカム・メガホンの声が小さい・遠く感じる

声は聞こえているが小さい場合、聞く人の設定とワールド設定の順に確認してください。

1. 聞く人の設定を確認する

  • イヤーマフ：減衰（外側の音量／Outside Volume）が 0% だと範囲外の音がすべて遮断され、インカム等の音声も聞こえなくなります。オフにするか、最低でも 5% 程度確保してください。
  • 相手の個別音量：クイックメニューで、相手の音量を個別に下げていないか確認します。
  • 他の音声ギミック：防音室など音量を変える他ギミックと同居していると、設定が上書きされる場合があります（他ギミック使用時の停止）。

イヤーマフはワールド側から解除・検知できません

VRChat のイヤーマフ処理はワールド側の音声制御よりも後の最終段階で適用されるため、ワールド側から設定の上書きや状態検知を行うことができません。範囲外のスタッフにも声を届ける必要がある場合は、イヤーマフの減衰を 0% にせず、最低でも 5% 程度確保する運用を推奨します。

2. 聞こえる音量（Voice Gain）を上げる

聞く側の設定に問題がなければ、届く音量（Voice Gain）を上げます（上限 24 dB）。話す側のマイク音量ではなく、聞く側にどう聞こえるかの設定です。

  • ワールド全体の既定：セットアップ窓の「インカム」ページ > 「インカムの声の大きさ（dB）」「メガホンの声の大きさ（dB）」で調整します（既定：インカム 12、メガホン 15）。
  • スタッフ各自の調整：メニューの設定タブ > 「インカム」で、自分に聞こえる音量を個別に増減できます（自分の話す声の音量は変わりません）。

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

インカム本体が常に Active な GameObject の下に置かれていない可能性があります。メニュー配下に置くと、メニューを閉じた時点で動作が止まります。

StaffIncomRadio を選択すると、Inspector に注意書きが出ます。その場合は、メニューの外にある常に Active な GameObject へ手動で移動してください。

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

FukuroUdon の内部仕様の差異による不具合を防ぐため、動作確認済みのバージョン（3.19.5）のご利用を推奨します。

共有タイマーが開始できない・時間が増えない

原因: 名簿（StaffRegistry）が割り当てられていない可能性があります。同梱の Prefab を手で置いた構成では、Prefab がシーン内の名簿を参照として持てないため、配置後のリンクが必要です。

対処: 診断・修復ページ > 必須項目をまとめて自動修復 を実行してください。タイマーとスイッチへの名簿の割り当てもここで行われます。

共有タイマーの開始と取消は2回押しです。1回目でボタンの文言が変わり、既定 5 秒以内にもう一度押すと確定します。時間内に押さないと取り消されるため、1回しか押していない場合は始まりません。

スイッチを押しても何も起きない

  • イベント名が違う可能性があります。スペルミスや大文字小文字の違いはコンパイルエラーにならず、無音で失敗します。スイッチページの 「イベント名」 を送り先の実装と突き合わせてください
  • 他の人の画面では何も起きない場合、それは仕様です。イベントが送られるのは押した本人のクライアントだけで、全員へ届けるかどうかは送り先が決めます。同梱の StaffObjectToggle なら 「同期する」 を ON にしてください。それ以外のギミックは、そのギミック側の作りによります（リファレンス）
  • 途中から入室した人にも状態を反映したい場合は、送り先のギミックが対応しているか確認してください

通知ログが出ない・邪魔になる

  • 出るのはスタッフだけです。スタッフ状態を確認してください
  • 各自の設定タブで「表示しない」を選んでいると出ません。位置は左下・左上から選べます。ミラーと重なる場合は切り替えてください。画面端で読みづらい場合は「表示位置を調整」で通知ログとノートの横・縦を個別に調整できます
  • 人の出入りが多くて流れすぎる場合は、StaffNoticeLog の 「入退室を表示する」 を OFF にすると入退室が載らなくなります
  • 1件あたりの表示時間は StaffNoticeLog の 「表示秒」（既定 20）で変えられます

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

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

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

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

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

Desktop のキーを押すと別の操作も一緒に動く

同じキーが2つの機能に割り当てられています。「診断・修復」ページの「Desktopキーの割り当て」が次を検出します。

検出するもの 何が起きるか
メニュー開閉キーとの重複 キー候補の B や G はメニューの開閉キーの選択肢にもあります。同じキーだと、押すたびにメニューが開閉しながら発話が始まります
VRChat 本体の操作との重複 V（マイク）・C／Z・WASD・Space・Shift・Ctrl・Esc・Enter・Tab など。押すと本来の操作も一緒に動きます
キー候補どうしの重複 同じキーのボタンが設定タブに2つ並びます
候補の1つ目が OFF でない OFF を選んだつもりで発話キーが生きたままになります
インカムとメガホンの初期キーが同じ 同じキーには両方を割り当てられないため、メガホン側が OFF で始まります

キー候補は「既定値」ページから差し替えられます。

なお、インカムとメガホンに同じキーを選んだ場合は、あとから選んだ側が優先され、もう片方は自動で OFF になります。1回の押下で両方が動くのを避けるためです。

予約キーの一覧は網羅ではありません

確実に重なるものだけを挙げています。ここに出ていないキーでも、VRChat 側の操作と重なる可能性はあります。実機で一度お試しください。

生成や診断が動かない

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

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

解決しない場合

BOOTH のメッセージ機能からご連絡ください。

セットアップ窓の「サポート」ページにある 「サポートに送る情報」 で「状態レポートを作る」を押すと、調査に必要な情報が文章としてまとまります。「クリップボードにコピー」でコピーして、メッセージに貼り付けてください。

サポートに送る情報

  • レポートに含まれるもの
    • 本製品・Unity・VRChat SDK・FukuroUdon のバージョン
    • 診断結果
    • 設置数
    • チャンネル構成
    • 音声レギュレータの並び順
    • 名簿の件数
  • 含まれないもの: スタッフの表示名、PC 内のパス、ワールド ID
  • シーン名・チャンネル名など、ご自身で付けた名前は含まれます。内容はその場で編集できるので、送りたくない行は消してからコピーしてください

レポートを作るボタンはシーンに何も書き込みません。外部への送信も行いません。

あわせて、Console に出ているエラーメッセージがあれば添えてください。

VRの耳元操作（インカム／メガホン）が意図せず起動する・止まらない

設定タブの「VRの耳元操作」で、インカム（右手）とメガホン（左手）の操作方式を個別に変更できます。

  • PTT（長押し）: トリガーを引いている間のみ送信します。
  • トグル: トリガーを離しても送信が継続します。終了時はもう一度操作してください（方式を変更した際も停止します）。
  • OFF: 誤操作を防ぐ場合は OFF に設定します。

視界HUDに発話者名が出ない

設定タブの「受信時の発話者名」を確認してください。

  • 表示タイミング: 誰かが話している間（受信中）のみ、帯が拡張して発話者名が表示されます。
  • 待機中・送信中: チャンネル番号のみの通常表示に戻ります。

タイマーの通知音が聞こえない

設定タブの「通知音」が 0 になっていないか確認してください。音が鳴るのはタイマーが 0 に到達したときです。ストップウォッチの経過中には鳴りません。

タイマー終了時にギミックが連動しない

以下の点を確認してください。

  • 配線の確認: Inspector で StaffOpsTimer の「終了時トリガー」にシーン内の StaffTrigger が割り当てられているか。
  • 設定行の確認: 指定した「終了時トリガー番号」の行に、正しい発火先とイベント名が設定されているか。
  • 実行権限: 連動発火は共有タイマーの Owner（通常はタイマーを開始したクライアント）から1回のみ実行されます。