Debugging Queries

Enable diagnostics before executing queries. The renderer retains only the latest 32 shape queries, including placement geometry and hit markers. History is a visual aid, not a gameplay result store.

// Create event, after jolt_start().
jolt_debug_enable(true);
jolt_debug_set(JOLT_DEBUG_SHAPE_QUERIES, true);

// Step event: perform the query you want to inspect.
var r = jolt_overlap_box(0, 0, 2, 1, 1, 1);

// Draw event, with your 3D camera active.
jolt_debug_draw();

// Clear retained query geometry when no longer needed.
jolt_debug_clear_shape_queries();

Verified operation contracts#

These contracts distinguish units, return values, errors and lifetime according to the current implementation. Check results: false, 0 and undefined can mean different things for different methods.