{"name":"velocityModelSpace","title":"velocityModelSpace","type":"command","url":"https://community.bistudio.com/wiki/velocityModelSpace","revid":377109,"updated":"2026-01-01T10:06:22Z","groups":["Object Manipulation"],"status":"ok","games":{"arma3":"0.50"},"since":"arma3 0.50","arma3_since":"0.50","description":"Returns the velocity (speed vector) of the vehicle as an array with format [x, y, z] in metre per second. Vector is in model space.","syntaxes":[{"syntax":"velocityModelSpace vehicle","params":[{"name":"vehicle","type":"Object","type_expr":"Object"}],"returns":{"type":"Vector3D","type_expr":"Vector3D"},"form":"unary","right":{"text":"vehicle"}}],"examples":[{"code":["velocityModelSpace _chopper; // returns [X (left(-) right(+)), Y (backward(-) forward(+)), Z (down(-) up(+))]"]}],"see_also":["setVelocityModelSpace","velocity","speed","setVelocity","setVelocityTransformation"],"notes":[{"user":"Pierre MGI","date":"2014-12-11T02:55:00Z","text":"This function is useful for helicopters as it returns Z vector like an indicator of thrust/load ratio. More or less climb (+) or descent (-) tendency but:\nAs X,Y,Z vectors are relative to vehicle attitude, this function doesn't return a climb or descend rate (as the attitude of the vehicle can be far from horizontal).\nYou can get negative Z vector, in jets, while climbing fast, peeling off in the sky!\nMore or less, you can use as a Z accelerometer factor but invert the sign: +G acceleration (negative vector below the jet) is -Z here.\nIf not \"physically\" correct, the behavior is sufficient enough for Arma flight model."},{"user":"K.J.","date":"2015-06-21T02:36:00Z","text":"Previous note is physically incorrect. Velocity can not be used to give information about Thrust/Load ratio or G-Forces/acceleration.\nTo get acceleration you have to create the derivative of velocity after time dv/dt -> the difference of velocity between 2 timesteps divided by the time that passed between the 2 steps."}]}