Donnervogel
Setting forceSpeed to -1 will make the unit move according to the group speed mode (often specified by the waypoint) again. Setting forceSpeed to 0 will halt the unit ignoring waypoints or orders.
Description
Force the speed limit on given object (object will never attempt to move faster than given by forceSpeed). Use negative value to return to default behaviour.
Important
This has no effect on players.
Syntax
object forceSpeed speed
Parameters:
Returns: Nothing
Examples
Example 1
_helicopter forceSpeed 150;
Example 2
_vtol forceSpeed 0; // vtol stop and hover
Example 3
_vtol forceSpeed -1; // vtol resume
See also
getForcedSpeed · forceWalk · isWalking · isForcedWalk · getSpeed · limitSpeed
Community notes
Kronzky
Does not seem to do anything at the current time (V1.08.5163)
Igneous01
If a unit (man) has forceSpeed set to anything under jogging (walking only) the unit will refuse to get into vehicles. He will automatically be unassigned from a vehicle everytime he is ordered to get in (via scripts or direct action)
TMZulu
This command must be executed on the client to which the object/unit is local and will only take effect where the unit is local. If locality changes, the command must be reapplied.
Leopard20
In the case of infantry units, it is recommended to use getSpeed for better and more accurate results:
_unit forceSpeed (_unit getSpeed "NORMAL"); // force the unit to run