setCruiseControl

2.06

LALocalLELocal

Hover & click on the images for description

⚠

Only available in Development branch(es) until its release with Arma 3 patch v2.06.

Description

Description:

Limits or sets local player-controlled vehicle's speed through cruise control.

ⓘ

• this command only works on CarX, TankX, ShipX simulation vehicles
• this command is implemented using a PID controller overwriting the vehicle's thrust/brakes input

Speed Limiter

Cruise Control

the vehicle does not accelerate by itself manually accelerating is required to move forward accelerating beyond set speed limit is restricted by the PID controller applying brakes does not disable Speed Limiter behaviour: if the speed is over 120% the set limit, the vehicle will apply 100% of braking and limit acceleration to 0% if the speed is below 80% the set limit, the acceleration and braking are untouched between 80 and 120%, the PID controller limits the acceleration and applies brakes if required

the vehicle accelerates by itself manually accelerating is possible accelerating above set speed limit is possible applying brakes disables Cruise Control behaviour: if the speed is over 120% the set limit, the vehicle will apply 100% of braking if the speed is below 80% the set limit, the vehicle will apply 100% of acceleration between 80 and 120%, the PID controller manages the speed

⚠

This command should only be called to change values and not be called every frame, as it resets the PID controller.

Groups:

Unit ControlObject Manipulation

Syntax

Syntax:

vehicle setCruiseControl [speed, autoThrust]

Parameters:

vehicle: Object - the vehicle to limit; local player's vehicle (vehicle player)

speed: Number - Desired/top speed in km/h. 0 to disable any setting. Only positives values are valid, negative values will make the vehicle unable to move forward

autoThrust: Boolean

• true - Cruise Control: the vehicle will maintain this speed until brakes is applied or driver dies or leaves the vehicle
• false - Speed Limiter: the vehicle will not accelerate above set speed

Return Value:

Nothing

Examples

Example 1:

vehicle player setCruiseControl [50, true]; // sets cruise control to 50 km/h

Example 2:

vehicle player setCruiseControl [5, false]; // limits player's vehicle speed to 5 km/h

Additional Information

See also:

getCruiseControl limitSpeed forceSpeed setAirplaneThrottle

Notes

Report bugs on the Feedback Tracker and/or discuss them on the Arma Discord or on the Forums.
Only post proven facts here! Add Note