# Known Issues

## Errors / Warnings in the console after installation <a href="#errors-in-the-console-after-installation" id="errors-in-the-console-after-installation"></a>

**Try clearing the console first, if the issue persists, try performing a clean (re)installation of the asset:**

1. Remove any objects containing the HTrace WSGI scripts from the scene, or open a scene that doesn't contain such objects.
2. Delete the asset.
3. Reload the Unity Editor.
4. Reinstall the asset.
5. Right-click the folder containing the asset files and choose "Reimport".
6. Clear the console log if necessary.

## Heavy ghosting during camera or object motion (URP)

This is a sign of broken or absent motion vectors. Try disabling and then re-enabling post-processing on the Camera.

## Scene and Game windows cause artifacts when opened simultaneously

HTrace WSGI does not support multiple cameras. A window layout with both the Scene and Game tabs visible at the same time (e.g., side-by-side) counts as a multi-camera setup. As a result, WSGI may not function as expected in this configuration.

## 'unity\_ObjectToWorldArray' undefined Warning

> Instancing: Unhandled property 'unity\_ObjectToWorldArray'. Values are undefined.
>
> Instancing: Unhandled property 'unity\_WorldToObjectArray'. Values are undefined.

These warnings appear when Terrain is drawn in the Instancing mode, they are harmless and shouldn't cause any issues in the Editor.

## Terrain and / or Terrain Details are not voxelized in build

Set **Instancing Variants** to "Keep All" in Project Settings -> Graphics.

## GPU Resident Drawer & Batch Renderer Group (Unity 6.0+)

> BatchRendererGroups currently don't support override Shaders
>
> A BatchDrawCommand is using the pass "SHADOWMAP\_STATIC" from the shader "HTrace/Shadowmap" which does not define a DOTS\_INSTANCING\_ON variant

Unity doesn't currently support override (replacement) shaders required for voxelization with GPU Resident Drawer / Batch Renderer Group: <https://docs-alpha.unity3d.com/ScriptReference/Rendering.DrawingSettings.html> \
\
A workaround is to duplicate necessary objects to a separate layer:

1. Copy objects that you want to be voxelized and place them to a separate layer.
2. Add the `Disallow GPU Driven Rendering` script to the objects on this layer. Apply recursively if needed. This is a native script provided by Unity. More info on it here: <https://shorturl.at/9kFtw>
3. Go to your main camera(s) and in the `Culling Mask` dropdown uncheck this layer.
4. Go to HTrace settings and in the `Voxelization Mask` dropdown check this layer.

This workaround does not impact rendering performance. BRG and Resident Drawer continue to function normally for your main camera view.&#x20;

## MULTIBOUNCE\_CACHE Keyword not found

> Compute Shader X: Can't find kernel (X) variant with keywords: MULTIBOUNCE\_CACHE

Solution: switch to `Probe Volumes` in Project Settings. To do this go to Project Settings -> Quality -> HDRP -> Lighting -> Light Probe System.

## Shader Warnings

> 'Load': implicit truncation of vector type at kernel X

This warning is known. We haven't found a workaround for convincing the compiler that it's not an issue. This kind of warnings is harmless, so we ask you to ignore them for now. We will try to remove the in the future.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ipgames.gitbook.io/htrace-wsgi/known-issues.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.