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

トラブルシューティング

インポート後にコンパイルエラーが発生する​

  • unitypackageのインポート時に、ObjectSpawn と ObjectSpawnExtension の両方を選択したか確認する
  • Projectウィンドウに PurabeWorks/ObjectSpawn と PurabeWorks/ObjectSpawnExtension の両方があるか確認する
  • UnityのConsoleで、最初に発生しているエラーを確認する

Spawnスイッチを操作しても出現しない​

  • SpawnObjectExt の VRC Object Pool が設定されているか確認する
  • VRCObjectPool のPool配列にGameObjectが登録されているか確認する
  • Pool内のすべてのオブジェクトがすでに表示中でないか確認する
  • UnityのConsoleに「VRC Object Poolを登録してください」と表示されていないか確認する

Pool配列の設定方法は、VRCObjectPoolを設定する をご覧ください。

Pool内のオブジェクトが最初から見えない​

VRCObjectPool に登録されたオブジェクトは、ワールド実行時に非表示になります。

Spawnスイッチで表示するまで見えないのが正常です。

Returnトリガーへ入れても非表示にならない​

  • ReturnトリガーのColliderで Is Trigger が有効か確認する
  • ReturnObjectExt の Layer と、トリガーに入るColliderのGameObjectのレイヤー番号が一致しているか確認する
  • 対象GameObjectが Pools から参照できる VRCObjectPool に登録されているか確認する
  • Pools が空の場合は Reference が設定されているか確認する

単一のSpawn Pointへ移動しない​

  • 出現先が 単一 になっているか確認する
  • Move Item To Hand が有効になっていないか確認する
    • 有効の場合、手元への移動が優先されます
  • Spawn Point に正しいTransformが設定されているか確認する
  • 通常オブジェクトでは Spawn Delay Frames、Helperコンポーネントを持つアイテムでは Move Delay を少しずつ増やす

手元へ移動しない​

  • Move Item To Hand が有効か確認する
  • 通常オブジェクトでは Spawn Delay Frames、Helperコンポーネントを持つアイテムでは Move Delay を少しずつ増やす

Spawn時の位置・回転オフセットが反映されない​

  • Move Item To Hand、単一の Spawn Point、または複数の Spawn Points のいずれかで移動先が指定されているか確認する
  • 通常アイテムでは、SpawnOffset またはTrayItem系コンポーネントがSpawnルートにあるか確認する
  • Helper付きアイテムでは、SpawnOffset がSpawnルートまたは Return Base Go / HG Base にあり、TrayItem系コンポーネントが Return Base Go / HG Base にあるか確認する
  • SpawnルートやHelperのBaseGoに優先度の高い SpawnOffset がないか確認する
  • ObonEasy連携を使用する場合は、ObonEasy v3.0以降が導入されているか確認する

子階層全体は検索しません。検索対象と優先順位の詳細は、Spawn時の位置・回転を調整する をご覧ください。

Resetしても一部だけ表示されたままになる​

  • All Reseter に指定した ReturnObjectExt の Pools を確認する
  • 対象のPoolが、Pools に登録した親GameObjectの外にないか確認する
  • Reference を利用している場合は、参照先の Pools を確認する

複数の出現地点を選択できない​

  • コンポーネントが SpawnObject ではなく SpawnObjectExt か確認する
  • Move Item To Hand が無効か確認する
  • 出現先を 複数 に切り替えたか確認する
  • Spawn Points に有効なTransformが1件以上登録されているか確認する

最も近い地点へ移動しない​

  • Spawn Points に未設定の要素がないか確認する
  • テスト中のプレイヤー位置と各地点の距離を確認する
  • 通常オブジェクトでは Spawn Delay Frames、Helperコンポーネントを持つアイテムでは Move Delay を少しずつ増やす

子PickupをReturnしてもルートが非表示にならない​

  • Poolへ登録したルートに CompSpawnHelper または HGSpawnHelper があるか確認する
  • HelperコンポーネントがPoolへ登録したGameObjectと同じGameObjectにあるか確認する
  • ReturnObjectExt の Layer と、トリガーに入るColliderのGameObjectのLayerが一致しているか確認する
  • ルートを登録した VRCObjectPool を Pools または Reference から参照できるか確認する

CompSpawnHelper で正しい位置へ移動しない​

  • Return Base Go が設定されているか確認する
  • Return Base Go に意図したGameObjectを設定しているか確認する
  • Move Delay を少しずつ増やす
  • VRCObjectSync を使用している場合は、所有権と同期状態を2クライアントで確認する

HGSpawnHelper が動作しない​

  • 使用するアイテムに合う v7.x.x または v8.x.x が選択されているか確認する
  • HG Base に対応するBaseスクリプトがあるか確認する
  • AUTO SET を押し、参照が正しく設定されるか確認する
  • v8.x.x系では、HG Base に VRCObjectSync があるか確認する
  • v8.x.x系では、HGSpawnHelper と同じルートGameObjectに ResetSwitchHelper があるか確認する
  • v7.x.x系では、HG Sync が設定され、そのGameObjectに VRCObjectSync があるか確認する
  • UnityのConsoleに表示された HGSpawnHelper のエラーを確認する

イベントが呼び出されない​

  • 対応する通知設定が有効か確認する
  • 受信メソッドが public で、引数がないことを確認する
  • イベント名が OnPurabeSpawn または OnPurabeReturn と完全に一致しているか確認する
  • アイテムへの通知では、受信する UdonBehaviour がルートGameObjectへ直接付いているか確認する
  • 外部通知では、External Event Targets に対象が登録されているか確認する
  • SpawnまたはReturn自体が成功しているか確認する

他のクライアントでイベントが実行されない​

イベント通知は、操作したクライアント上でのみ実行されます。全クライアントで処理する場合は、イベント受信側で SendCustomNetworkEvent などを使用してください。

移行ツールで一部が移行されない​

  • 移行先の SpawnObjectExt または ReturnObjectExt がすでに同じGameObjectにないか確認する
  • 移行ウィンドウに表示された警告を確認する
  • Prefab Assetではなく、現在アクティブなシーンが対象であることを確認する
  • 移行後にシーンを保存したか確認する

上記対処で解決しない場合​

次の情報を添えて、Purabe WorksのBOOTH からお問い合わせください。

  • Unityのバージョン
  • VRChat SDKのバージョン
  • Object Spawn SystemとObject Spawn Extensionのバージョン
  • UnityのConsoleに表示されたエラー全文
  • 対象コンポーネントのInspector画像
  • Poolへ登録したルートからPickupまでのHierarchy画像
  • 問題が発生する操作手順