Transmission and Gears

Configures automatic or manual transmission timing, shift thresholds, clutch strength and gear ratios before build().

Automatic is the default. Manual transmission accepts set_gear() at runtime; calling it for an automatic transmission fails.

Transmission options#

var car = jolt_vehicle(chassis, {
    transmission: {
        mode: JOLT_VEHICLE_TRANSMISSION_MANUAL,
        forward_gears: [3.2, 2.1, 1.4, 1.0, 0.82],
        reverse_gears: [3.0],
        clutch_strength: 10
    }
});

Manual shifting#

car.set_gear(1, 1);   // first forward gear, fully engaged clutch
car.set_gear(0, 0);   // neutral
car.set_gear(-1, 1);  // reverse

Configuration object and setters#

var transmission = jolt_vehicle_transmission();
transmission.set_automatic(true);
transmission.set_forward_gears([3.0, 2.0, 1.2]);
transmission.set_reverse_gears([3.0]);
var settings = jolt_vehicle_settings();
settings.set_transmission(transmission);
var car = jolt_vehicle(chassis, settings);

Configuration factories return a GML settings object and create no physics. Their setters return self, the settings object, and do not confirm that a value is valid. Fields are consumed and validated by jolt_vehicle, add_wheel or add_differential. An omitted field preserves the corresponding options default described above. Editing settings after consumption does not change an existing vehicle, wheel or differential. Settings need no destroy.

Vehicle creation returns undefined on failure. add_differential returns Boolean; add_wheel returns a numeric zero-based index or Boolean false on failure. Index 0 is success: do not use only if (!wheel_index). Complete wheel/differential configuration before build().

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.