‹›
JoltPhysics

Impact Tracking: collision impulse

Opt-in measurement from solved Dynamic Body contacts.

First use#

GML
body.set_impact_tracking_enabled(true);
// After jolt_update():
var value = body.get_impact();

Disabled by default. The setter requires a Boolean and a live Dynamic body. Getters return 0 while disabled, waiting or on failure; distinguish errors with jolt_has_error(). Sensors do not provide a solved contact load.

Meaning of the measurement#

get_impact() returns the strongest new collision episode of the last completed outer step in N·s. This is not sustained contact force, speed or automatically computed damage. Resting support is not a fresh impact every frame.

Lifetime and limitations#

Enabling does not replay existing contacts as fresh impacts. Configuration changes, destruction and disabling invalidate the relevant state. Read after the physics step.

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.