{"name":"forceSpeed","title":"forceSpeed","type":"command","url":"https://community.bistudio.com/wiki/forceSpeed","revid":379421,"updated":"2026-10-31T00:04:17Z","groups":["Object Manipulation"],"status":"ok","games":{"arma1":"1.00","arma2":"1.00","arma2oa":"1.50","tkoh":"1.00","arma3":"0.50"},"since":"arma1 1.00","arma3_since":"0.50","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.\n\n> [!IMPORTANT]\n> This has no effect on players.","syntaxes":[{"syntax":"object forceSpeed speed","params":[{"name":"object","type":"Object","type_expr":"Object"},{"name":"speed","type":"Number","description":"in metre per second","type_expr":"Number"}],"returns":{"type":"Nothing","type_expr":"Nothing"},"form":"binary","left":{"text":"object"},"right":{"text":"speed"}}],"examples":[{"code":["_helicopter forceSpeed 150;"]},{"text":"```sqf\n_vtol forceSpeed 0; // vtol stop and hover\n```","code":["_vtol forceSpeed 0; // vtol stop and hover "]},{"text":"```sqf\n_vtol forceSpeed -1; // vtol resume\n```","code":["_vtol forceSpeed -1; // vtol resume "]}],"see_also":["getForcedSpeed","forceWalk","isWalking","isForcedWalk","getSpeed","limitSpeed"],"notes":[{"user":"Donnervogel","date":"2007-03-02T16:02:00Z","text":"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."},{"user":"Kronzky","date":"2008-02-09T00:00:00Z","text":"Does not seem to do *anything* at the current time (V1.08.5163)"},{"user":"Igneous01","date":"2011-12-14T00:00:00Z","text":"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)"},{"user":"TMZulu","date":"2020-05-01T03:21:00Z","text":"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."},{"user":"Leopard20","date":"2021-11-17T06:49:26Z","text":"In the case of infantry units, it is recommended to use getSpeed for better and more accurate results:\n\n```sqf\n_unit forceSpeed (_unit getSpeed \"NORMAL\"); // force the unit to run\n```"}]}