Troubleshooting

intermediate troubleshooting

Transitions Plus · Troubleshooting & FAQ

Troubleshooting

This page covers the most common issues users encounter with Transitions Plus and how to resolve them.

Transition not visible

SymptomYou added the TransitionsPlus GameObject but no transition overlay appears.
CauseThe Progress value is at 0, or the profile/preset is not assigned.
Solution
  1. Drag the Progress slider above 0 to verify the overlay renders.
  2. Assign a preset via the Preset dropdown, or drag a TransitionProfile into the Profile field.
  3. Ensure the Sorting Order (default 100) is higher than any other canvas in the scene.

Transition appears stretched

SymptomThe transition mask looks distorted at non-16:9 resolutions.
CauseThe Keep Aspect Ratio option is disabled.
SolutionEnable Keep Aspect Ratio in the Inspector to maintain correct proportions regardless of screen size.

Scene does not load after transition

SymptomThe transition completes but the target scene does not load.
CauseThe scene name is misspelled or not added to Build Settings.
Solution
  1. Open File > Build Settings and verify the target scene is listed and enabled.
  2. Ensure the Scene Name To Load field matches the scene file name exactly (case-sensitive).
  3. Confirm Load Scene is checked on the component.

Transition not rendering in VR

SymptomThe transition works in the Editor but not in a VR headset build.
CauseThe render mode is set to FullScreen instead of VR.
SolutionSet Render Mode to VR on the TransitionAnimator component. This uses a stereo-aware rendering path optimized for headsets.

Sound effect not playing

SymptomThe transition animates but no audio is heard.
CauseNo AudioClip assigned, or there is no AudioListener in the scene.
Solution
  1. Assign an AudioClip to the Sound field.
  2. Ensure the scene has an AudioListener (typically on the Main Camera).
  3. Check that the game audio is not muted in the Editor (Mute Audio button in the Game view toolbar).

NullReferenceException when starting via script

SymptomNullReferenceException when calling TransitionAnimator.Start().
CauseThe profile asset reference is null, or the namespace is missing.
Solution
  1. Add using TransitionsPlus; at the top of your script.
  2. Verify the profile asset is assigned in the Inspector (not destroyed or missing).
  3. If using the inline overload, ensure you pass a valid TransitionType enum value.
Still stuck? Post your question on the Kronnect Support with your Unity version, render pipeline, and a screenshot of the Inspector settings.
Was this page helpful?