Troubleshooting
Support in the account menu opens RAPTOR's Discord server. When you ask for support, include the output of Settings → General → Copy diagnostics.
Setup
These appear in the Environment section of Settings → Modules.
| Message | Fix |
|---|---|
| Too old | RAPTOR needs Unity 6000.0 or newer. Open the project in a newer version from Unity Hub |
| Missing | On the URP package row, install Universal RP from Window → Package Manager, or start from the Universal 3D template |
| Not assigned | Press Assign and confirm with Switch. The whole project then uses URP, and materials made for the Built-in pipeline show magenta until you convert them with Window → Rendering → Render Pipeline Converter. If there is no URP asset, create one with Assets → Create → Rendering → URP Asset (with Universal Renderer), then set it in Edit → Project Settings → Graphics |
| Other pipeline | RAPTOR supports URP only. Set a URP asset in Edit → Project Settings → Graphics, and check that no Quality level overrides it |
| Partial | On the Bakery row, RAPTOR could not find everything it reads from your Bakery version. RAPTOR needs Bakery 1.98 or newer, and 1.985 or newer on Unity 6.5 and later. Update Bakery from the Asset Store, and include Copy diagnostics when you ask for support |
Render and bake
These appear in the Render menu, in Bake settings or in the Sky panel.
| Message | Fix |
|---|---|
| No baker | A compile error stopped part of RAPTOR from loading. Fix the red errors in the Console, then reopen RAPTOR |
| Save scene | Save the scene with File → Save, then bake again |
| Baked GI off | Open Window → Rendering → Lighting, and on the Scene tab turn on Baked Global Illumination |
| Bakery scene | The scene has Bakery lightmaps, which a Unity bake does not overwrite. Bake it with Bakery on a PC with an NVIDIA GPU, or open a scene with no Bakery lightmaps |
| Bakery needs NVIDIA | Bake on a PC with an NVIDIA GPU, or choose Use Unity's lightmapper in the Render menu or Bake settings. This PC then bakes with Unity's Progressive lightmapper, and PCs with an NVIDIA GPU keep Bakery. Removing Bakery does the same for every PC |
| Bakery needs setup | Bakery has not tested this GPU in this project. Choose Set up Bakery in the Render menu, Bake settings or the Bakery project settings to run Bakery's GPU test. If the test cannot run, choose Bake without it |
| Requires Unity 6.3 | The ray-traced preview requires Unity 6000.3 or newer. Open the project in a newer version from Unity Hub. The rest of RAPTOR, baking included, works on older versions |
| Needs a Skybox face | The sky lights a bake only through Skybox faces. Paint the faces open to the sky with the Skybox material from Special in Materials |
Scene turns white after Generate Lighting
Unity's Generate Lighting turns a scene white when it has the default sky and no Directional Light. Bake with Render → Bake lighting instead.
Materials, hotspots and props
These appear in Materials, Patches and Props when they are empty.
| Message | Fix |
|---|---|
| No packs | → Add pack in Materials and pick a folder of materials. A deleted Prototype pack is not restored |
| No sheets | RAPTOR ships with no hotspot sheets. To make one, see Hotspot sheets |
| No props | → Add folder in Props and pick a folder of prefabs |
Models
This appears in the model menu and in Models.
| Message | Fix |
|---|---|
| No storage provider | Fix any red errors in the Console. If the project has no storage provider, set Edit → Project Settings → RAPTOR → Models → Model storage to Built-in |
Script errors
Script errors in the bottom bar means a script in the project does not compile, so Play cannot start. the chip to see the errors in Unity's Console. The chip goes away when the scripts compile again.
Red errors after install
Check that the project uses the Universal 3D template and Unity 6000.0.85f2 to 6000.7. If it does, include the first red error when you ask for support.
Red errors after an update
Files of the old version can clash with the new one. Reinstall RAPTOR cleanly and keep your data. See Updating RAPTOR.