Troubleshooting
intermediate troubleshootingBeautify 3 (Built-in) · Troubleshooting & FAQ
Solutions to the most common issues when using Beautify 3 with the Built-in Render Pipeline.
Common Issues
| Symptom | Cause | Solution |
|---|---|---|
| No visible effect | Beautify script not added to camera, or all effects set to zero | Ensure the Beautify component is on your active camera. Try selecting a preset (e.g., Medium) to apply default values. |
| Effects only visible in Scene view, not Game view | Beautify is on the wrong camera | Make sure Beautify is attached to the camera tagged as MainCamera or the camera rendering to screen. |
| Depth of Field not working | Depth texture not available | Ensure the camera has Depth Texture Mode enabled. Beautify should enable it automatically, but verify in the Inspector. |
| Bloom looks burned/saturated | Bloom threshold too low or intensity too high | Increase Bloom Threshold to limit which pixels bloom. Reduce Bloom Intensity for a subtler effect. |
| Banding artifacts on skybox | Low color precision in gradient areas | Enable Dither in Beautify settings. Use Linear color space for best results. |
| Build takes very long | All shader variants being compiled | Open Shader Options and disable features you don't use. This dramatically reduces shader variants and build time. |
| Shader errors on consoles | Platform-specific shader incompatibilities | Check the FAQ for console-specific fixes. Contact support if the issue persists. |
| UI affected by post-processing | UI rendered on the same camera | Use a separate UI camera with a higher depth value and Clear Flags set to Depth Only. Don't add Beautify to the UI camera. |
| Performance drops on mobile | Too many effects enabled at full quality | Switch to Best Performance mode. See Performance Tips for detailed optimization guidance. |
| Conflicts with other post-processing effects | Execution order or rendering conflicts | Adjust script execution order (Edit > Project Settings > Script Execution Order) to ensure Beautify runs after other effects. |
Still Having Issues?
If your problem isn't listed above:
- Check the FAQ for additional answers.
- Visit the Kronnect Support.
- Include your Unity version, Beautify version, and steps to reproduce the issue when requesting help.
Was this page helpful?
Suggest an improvement
Help us improve this documentation page.