Soft sphere

Arguments are center x/y/z, radius, segments (default 16) and optional construction settings. The sphere is a closed surface shell rather than a tetrahedral solid. Pressure and stiffness must be tuned together for size and mass; excessive pressure in a soft shell can overinflate it.

Example#

ball = jolt_soft_body_create_sphere(0, 0, 3, 0.5, 24);
if (!is_undefined(ball)) {
    ball.set_mass(2);
    ball.set_stiffness(0.6);
    ball.set_pressure(100);
    ball.set_renderer(o_control_bbmod_renderer.renderer);
}

Usage and limits#

Set mass, stiffness, pressure, damping, friction, gravity factor, collision thickness and layer on the created object. Use spatial attachments for anchors and set_grab_enabled(true) for Carry. Creation returns undefined on error; check before calling methods. Register BBMOD rendering once and destroy the object in Clean Up.

API reference#

Public function and method signatures. Call methods on the returned instance; parameters with defaults are optional.

Related guides#

• Migrating existing code›
• Choosing a Soft Body›
• Volumetric soft box›
• Closed model import›
• Cloth model and named anchors›
• Spatial attachments›
• Separate visual mesh›
• Local force and impulse›
• Wind›
• Carrying Soft Bodies›

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.