メインコンテンツまでスキップ
HELP

トラブルシューティング

うまく動かない場合は、まずConsoleのエラーを確認し、設定を最小構成へ戻して原因を切り分けます。
上から順番に確認してね。

最初に確認すること​

  • UnityのConsoleに赤いエラーが出ていないか。複数ある場合は、最初に出たエラーから確認する
  • Prefab本体がScene内にあるか
  • テレポート元・テレポート先が正しく登録されているか
  • 対象GameObjectが無効になっていないか
  • Play中だけ変更した設定ではないか
  • まず 通常・1対1・双方向・接触・利用モード：全員 の最小構成で確認する

設定を変更するときはPlayを停止してね。
基本の設定手順は、クイックスタートで確認できます。

テレポート関連​

テレポートしない​

  1. 接続が作成され、テレポート元・テレポート先が設定されているか確認する
  2. ポイント種類が意図した設定か確認する。双方向の基本例では両方のポイントを 両方（入口＋出口） にする
  3. 発動方法を確認する。接触 はポイントの判定に入ると発動し、トリガー はポイントで操作すると発動する
  4. 利用モードで拒否されていないか確認する
  5. 分散の場合は、各候補の対応エリアを確認する
  6. Consoleのエラーを確認する

関連：テレポートポイント・テレポート接続・利用制限

利用制限でテレポートできない​

  1. 利用モード が 全員 / ホワイトリスト / ブラックリスト のどれになっているか確認する
  2. ホワイトリストの場合、本人のVRChat表示名が登録されているか確認する
  3. ブラックリストの場合、本人のVRChat表示名が誤って登録されていないか確認する
  4. 大文字・小文字、スペース、記号、絵文字も含め、実際の表示名と完全一致しているか確認する
  5. VRChat側で表示名を変更したあと、古い登録名のままになっていないか確認する

Playを停止し、一度 利用モード：全員 に戻してから、テレポートできるか試してね。

  • 全員で動く場合：利用制限の設定と登録名を確認する
  • 全員でも動かない場合：接続・テレポート元・テレポート先・発動方法・Consoleエラーを確認する

原因確認時は、拒否時の反応 → メッセージ にすると、利用制限で拒否されているか分かりやすくなります。
確認後は、使用したい利用モードへ戻してね。

詳しくは、利用制限を確認してください。

想定と違うテレポート先へ行く​

  • 接続のテレポート先が正しいか確認する
  • ランダム・分散の候補に、意図したポイントが登録されているか確認する
  • 同じ名前のポイントを取り違えていないか確認する
  • ポイントを選択・ポイントを表示 を使い、SceneViewでポイントの位置を確認する

到着場所は、青いZ方向ではなく ポイントの位置そのもの を確認してね。
ランダム・分散では、選択方式に応じて別の候補が選ばれることがあります。

関連：テレポートポイント・ランダム・分散

到着した向きがおかしい​

テレポート先ポイントの 青いZ軸方向 が、到着後の正面方向です。
プレイヤーを向かせたい方向へ合わせてね。

詳しくは、テレポートポイントを確認してください。

到着直後に再テレポートする​

  • 到着地点が、別のテレポート元の判定と重なっていないか確認する
  • 到着ポイントが接触判定の中に入り込んでいないか確認する
  • ポイント位置を少し離して、もう一度試す

位置の確認方法は、テレポートポイントで確認できます。

一方通行の到着側に接触判定がある​

最新版では、一方通行＋接触 で到着側のポイントを単なるテレポート先として使う場合、不要な接触判定は自動で無効になります。
それでも有効な場合は、そのポイントが 別の接続の接続元 として使われていないか確認してね。
別の接続の入口として使う場合は、必要な接触判定なので有効になります。

詳しくは、テレポート接続を確認してください。

ランダム・分散​

ランダムで特定候補へ行かない​

  • 候補の 使用する がONか
  • 確率 が0になっていないか
  • テレポート先が正しく設定されているか
  • 抽選回数が少なすぎないか

数回だけでは、設定した割合どおりに見えないことがあります。
設定と抽選プレビューは、ランダムで確認してね。

分散が思った通りに選ばれない​

  1. 各候補の テレポート先＋対応エリア を確認する
  2. 分散方法が意図した方式か確認する
  3. Play中の各エリアの 現在人数・定員・空き人数・混雑率・満員状態 を確認する
  4. 最良条件が同じ候補の 同率時抽選 の設定値を確認する

分散条件が先、同率時抽選が後 です。
最良条件の候補が1つなら、その候補が選ばれます。
満員候補は通常の分散対象から外れるため、全候補満員時の設定も確認してね。

詳しくは、分散を確認してください。

エリア・定員​

エリア人数が合わない​

  • SceneViewのBoxが、人数を数えたい場所を高さも含めて覆っているか
  • エリアのBoxサイズが狭すぎないか（エリア管理のSceneViewのBoxや、Inspectorの範囲設定・XYZサイズで調整する）
  • 他のエリアと範囲が重なっていないか
  • カウント除外に対象プレイヤーの表示名が登録されていないか
  • ポイント追従の対象ポイントや位置オフセットが正しいか
  • Play中の 現在状態 に表示される人数がどう変化するか

カウント除外の表示名は完全一致です。
詳しくは、エリア・定員を確認してね。

満員判定がおかしい​

  • エリアの定員と現在人数を確認する
  • カウント除外と判定範囲を確認する
  • 分散候補の対応エリアが、意図したエリアか確認する
  • 分散側の満員候補の扱いと、全候補満員時の設定を確認する

関連：エリア・定員・分散

満員時メッセージ​

満員なのにメッセージが出ない​

  1. 分散を使用しているか確認する
  2. 一部だけでなく、全候補が満員か確認する
  3. 全候補が満員の場合 → テレポートしない になっているか確認する
  4. Prefab本体の 満員時メッセージデザイン が設定されているか確認する
  5. Play中に、表示を確認したい本人がテレポートを試す

メッセージはテレポートしようとした本人へ表示されます。
設定方法は、満員時メッセージを確認してね。

Fade​

Fadeが表示されない​

  • 接続側の Fadeを使用 がONか
  • 接続のFade時間が意図した設定か
  • 共通Fadeデザインの背景色・Fade画像が設定されているか
  • Fade画像を使う場合、画像を使用 がONか
  • 画像を使う場合、PNGが Sprite (2D and UI) に設定されているか

画像を使用 がOFFでも、背景色だけのFadeは使用できます。
ONにすると、指定したFade画像を背景へ重ねて使用します。

関連：Fade・画像素材の使い方

Fade後に画面が戻らない​

  1. Consoleのエラーと、接続の Fade In 時間を確認する
  2. 連続テレポート時だけ起こるか確認する
  3. Fadeを一度OFFにし、テレポート本体だけで動作を確認する
  4. FadeをONへ戻し、もう一度確認する

テレポートと演出を分けて確認すると、原因を絞り込みやすくなります。
設定方法は、Fadeを確認してね。

到着通知​

到着通知が表示されない​

  • 対象エリアの 到着通知を使用 がONか
  • 到着した本人 の 通知を表示する が意図した設定か
  • 到着先にいるプレイヤー の 通知を表示する が意図した設定か
  • 表示時間が意図した設定か
  • Desktop表示位置、VRの場合はVR表示位置が適切か
  • 対象エリアへ実際にテレポートしているか

背景PNGだけが表示されない場合は、背景画像を使用 がONか、背景PNG が設定されているか、画像が Sprite (2D and UI) になっているかも確認してね。

設定方法は、到着通知で確認できます。

到着通知の音が鳴らない​

  • 対象の 通知音を鳴らす がONか
  • AudioClipが設定されているか
  • ランダムの場合は音の候補が登録されているか
  • 音量と SE終了後クールタイム が意図した設定か

通知音素材は商品・配布データに付属しません。
音の設定方法は、到着通知を確認してね。

画像関連​

PNGを画像欄へ設定できない​

  1. ProjectビューへPNGを取り込んだか確認する
  2. Texture Type が Sprite (2D and UI) か確認する
  3. Apply を押したか確認する

詳しくは、画像素材の使い方：PNGをUnityへ取り込むを確認してね。

Sprite Editorが開かない​

9-slice用のBorder設定には、Unityの 2D Sprite パッケージが必要です。
通常のPNGをそのまま使う場合は、Sprite Editorを開く必要はありません。

9-sliceを使いたい場合は、画像素材の使い方：9-sliceを確認してね。

Unity全般​

Play Modeで設定した値が戻った​

Unityでは通常、Play Mode中のInspector変更は、Play終了時に元へ戻ります。
Playを停止してから設定し直してね。

Consoleにエラーが出る​

Consoleの赤いエラーは、一番上のもの・最初に出たものから確認します。
同じエラーが大量に出ていても、最初の原因を確認してね。

  • Unityのバージョン
  • UdonSharp・VRChat SDKのバージョン
  • 導入直後から発生していたか
  • 設定やデータの変更後から発生したか

これらを確認し、発生する条件を整理してください。

解決しない場合​

解決しない場合や不具合と思われる挙動がある場合は、Xの @eszou3 まで連絡してください。
次の情報があると状況を確認しやすくなります。

  • Unityのバージョン
  • ギミックのバージョン
  • 発生までの短い手順
  • Hierarchyのスクリーンショット
  • Inspectorのスクリーンショット
  • Consoleエラー全文
  • Desktop・VRのどちらで発生したか
  • 可能なら再現条件

仕様についての質問は、FAQも確認してね。