Skip to content

Troubleshooting

Nothing is drawn.

Select the object. If the Highlightable Inspector shows a warning, click Fix or open the Setup window: the renderer used by the active quality level has no (or a disabled) Highlight Kit feature. Also check that Outline Enabled is on, the width is above 0, and the object has a Mesh Renderer or Skinned Mesh Renderer (on itself, or on a child with Include Children on).

The effects work in the Editor but not in a build.

Run Tools > Pixit Games > Highlight Kit > Fix Shader References, commit the changed renderer assets and build again. Check the build log for a warning about a read-only renderer asset.

Each quality level looks different, or one platform shows nothing.

Every quality level can use a different URP asset with different renderers. Open the Setup window: it lists them all.

The outline is drawn on top of walls.

The feature's Visibility is set to Always. Set it to Visible Only.

The outline stops behind a small prop, or the X-Ray triggers behind foliage.

Visible Only and the X-Ray treat everything that writes depth as an occluder. Narrow X Ray > Occluder Layers to walls and terrain; for outlines, use the X-Ray (or Always) on objects that should stay readable.

The X-Ray does not appear.

The object has to be behind something on an Occluder Layer that is opaque or alpha-clipped and drawn by the same camera, and at least Occlusion Bias (world units) behind it.

The outline is thinner than the width I set.

Widths are clamped to the maximum of the quality level: Low 12 px, Medium 16 px, High 32 px (at 1080p).

An animated character and its outline disappear together near the edge of the screen.

Unity culls a Skinned Mesh Renderer by its bounds, and the kit uses the same bounds, so the outline is only drawn when the character itself is. If a pose reaches outside the bounds (for example a long swing of an arm), enlarge the renderer's Bounds or turn on Update When Offscreen.

An indicator paints the character standing in it.

Lower Projection Depth, keep Slope Limit at 50 or below, or put characters on their own layer and leave it out of Receiver Layers.

An indicator does not appear, or ends abruptly on a slope.

The ground must be within Projection Depth of the indicator's position, and not steeper than Slope Limit. In the Editor, a one-time warning in the Console points to a handle used after Hide().

Settings I changed in Play Mode were kept.

Renderer assets edited at runtime keep their changes in the Editor. Restore them yourself when the scene stops, or change them from an options menu in builds only.