Debug Draw

Renders optional physics diagnostics with the current GameMaker 3D camera.

The built-in debug renderer is separate from simulation. It reads managed state and native snapshots only when asked to draw, owns no camera, and leaves the active view and projection matrices unchanged.

Basic setup#

// Create event
jolt_debug_enable(true);
jolt_debug_set(JOLT_DEBUG_ALL, false);
jolt_debug_set(JOLT_DEBUG_SHAPES | JOLT_DEBUG_CONTACTS, true);

// Draw End event, after opaque 3D models
jolt_debug_draw();

Public controls#

Debug flags#

Render-state behaviour#

• Uses the current matrix_view and matrix_projection and never creates or changes the game camera.
• Enables depth testing with cmpfunc_lessequal and disables depth writes for diagnostic lines.
• Uses no back-face culling or blending during the pass.
• Restores the previous GPU state, world matrix, and active shader before returning.
• Reusable primitive line meshes are created lazily and released by jolt_stop().

Temporary mask override#

// Draw only constraints this frame without changing stored flags.
jolt_debug_draw(JOLT_DEBUG_CONSTRAINTS);

Current project integrations#

• Debug and model shader uniforms›
• Forces / Impulses›
• Explosions›
• Transform Points›
• Physical Controls from Blender›

New related workflows#

• Wind›
• Surfaces›

Additional current diagnostics#

JOLT_DEBUG_ALL currently equals 262143 and includes Ragdolls. Flags cover Shapes, Contacts, Sensors, Raycasts, Constraints, Characters, Cloth, Center of Mass, Shape Queries, Vehicles, Grabber, Sockets, Penetration, Explosions, Forces, Points, Surfaces and Ragdolls. Physical Controls use related mechanism drawing, not an invented JOLT_DEBUG_CONTROLS flag.

Convex shapes draw their actual hull shell rather than only an AABB. jolt_debug_set_penetration_history enables records under JOLT_DEBUG_PENETRATION. Ragdoll options: shapes, links, anchors, axes, swing_limits, twist_limits, current_pose, centers, xray, scale; scale ranges from 0.1 to 4. An unknown setter option returns false; the getter returns undefined.

• Debug flags›
• Penetration History›

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.

Complete API declarations#

Declarations match the production GML sources. A value after = marks an optional argument. This is a signature inventory; the guide sections describe meaning, units and limitations. The type before a dot identifies the method owner, not a global function.