Known Issues
Errors / Warnings in the console after installation
Try clearing the console first, if the issue persists, try performing a clean (re)installation of the asset:
Remove any objects containing the HTrace SSGI scripts from the scene, or open a scene that doesn't contain such objects.
Remove the HTrace SSGI Renderer Feature from the Renderer (for URP pipeline).
Delete the asset.
Reload the Unity Editor.
Reinstall the asset.
Right-click the folder containing the asset files and choose "Reimport".
Clear the console log if necessary.
Indirect Lighting looks wrong
Use Debug views to verify different parts of the effect, especially the Main Buffers. Make sure that all necessary objects are visible and valid (e.g. have the correct diffuse color). Don’t neglect debugging — it can save you (and us) a lot of time when diagnosing and fixing issues.
Disable all third-party assets, effects, and renderer features — even those that look harmless or too reliable to cause issues. There have been cases where even the most minimalistic third-party effects (e.g. color correction) interfered with rendering in unpredictable ways.
Check another scene. A good rule of thumb: if the HTrace SSGI sample scene works, the issue is likely scene-specific; if it doesn’t, then it’s probably a bug or a project-wide parameter/setting.
Try switching to another rendering path (e.g. Deferred → Forward), especially if you’re using URP, to see if it changes anything.
Reset all HTrace settings or re-add it to the scene.
Compare with the native SSGI, if you're using HDRP. If it produces the same issue, the problem is most likely not in GI itself but somewhere else.
Indirect Lighting is very dark
Emission Intensity of your lights should be reasonably high. The brightness of indirect lighting is often only a fraction of direct lighting.
Enough directly lit pixels (use the Direct Lighting debug mode to check) should be visible in the frame. If there isn’t sufficient direct lighting visible, there will be no GI — unless the Fallback is active.
The Diffuse (Albedo) component of your materials should be sufficiently bright. Dark colors absorb light instead of bouncing it.
Exposure values should be within a reasonable range, especially in HDRP.
Adjust the Brightness Clamp parameter — try switching it to Manual mode and increasing its value.
Adjust the Intensity slider in URP, or the Diffuse Lighting Multiplier in the Indirect Lighting Controller in HDRP.
Exclude Casting / Receiving options don't work [URP]
Solution: try switching to Deferred mode and then back to your original rendering path.
Unexpected Ghosting / Temporal Artifacts
HTrace SSGI uses a temporal denoiser, which requires correct motion vectors. Make sure that all shaders and meshes write valid motion vector data that accounts for all surface aspects (e.g., vertex animation, cutout properties, etc.) Additionaly, check if you have one of the following:
Game and Scene windows opened side by side.
Multiple cameras rendering the effect simultaneously.
If removing one or more of these conditions mitigates the issue, please report it as a bug.
Moving objects flicker in the Scene window
Unity does not write object motion vectors in the Scene view. As a result, temporal denoising of moving objects may fail.
Installation into a project with other HTrace assets overwrites files
In rare cases, trying to import the asset into a project where another HTrace asset(s) (WSGI, AO) is already installed (and vice versa) may result in a wrong merge / file replacement due to Unity's asset importer issues.
Solution: first unpack the asset to a separate project and then manually copy the folder with the asset to the project where another HTrace asset(s) is installed.
Last updated