Troubleshooting

intermediate troubleshooting

Trails FX · Troubleshooting & FAQ

Solutions to common issues when working with Trails FX.

Common Issues

Problem	Solution
No trail appears	Ensure the Active toggle is enabled and at least one trigger is configured (Continuous, World Position Change, etc.). Verify the GameObject has a `MeshFilter` or `SkinnedMeshRenderer`.
Trail is jagged or choppy with physics-based movement	Enable Rigidbody Interpolation on the Rigidbody component. Also ensure physics movement code runs in `FixedUpdate()`.
Trail does not render correctly in Deferred rendering	The stencil buffer may conflict with the deferred lighting pass. Enable `Camera.clearStencilAfterLightingPass` on your camera. See Unity documentation.
Space Distortion effect is invisible (URP)	Enable Opaque Texture in your URP Renderer Asset settings. See URP Instructions.
Demo scene materials are pink (URP)	The demo uses Built-in RP materials. Convert them via Edit > Rendering > Materials > Convert Built-in Materials to URP.
Trail renders over the character instead of behind	Enable Draw Behind in the Appearance section. For multi-part characters, also enable Hierarchy Occluder on the master trail.
Overlapping trails from different characters look wrong	Enable Clear Stencil on the trail components to reset the stencil buffer between different objects.
Trail appears on wrong submeshes	Adjust the SubMesh Mask to include only the desired submeshes (bitmask).
Animation state filtering not working	Verify the Animator reference is assigned and the state names in Animation States match exactly (case-sensitive). Time ranges use the format `StateName(start-end)`.

Getting Help

If your issue is not listed above, visit the Kronnect Support and post your question. Include:

Unity version and render pipeline (Built-in or URP)
Trails FX version
A screenshot of your TrailEffect Inspector settings
Steps to reproduce the issue

Was this page helpful? |