{"name":"setMass","operator":null,"title":"setMass","type":"command","url":"https://community.bistudio.com/wiki/setMass","revid":373893,"updated":"2025-06-26T11:00:29Z","groups":["PhysX"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.02"}],"since":{"game":"arma3","name":"Arma 3","version":"1.02"},"arma3_since":"1.02","branch":null,"locality":{"argument":"local","effect":"global","server_exec":false},"exec":null,"description":"Changes the mass of a PhysX object. When using the alternative syntax the mass change is gradual during the given time. A time of zero means immediate change.\n\n> [!IMPORTANT]\n> When main syntax is used on local vehicle, the change is global. When alternative syntax is used with time transition on local vehicle, the gradual mass change doesn't happen on remote clients, only final mass is applied after the given time. If you need gradual change on remote clients too, remote execute setMass globally.","syntaxes":[{"syntax":"myObject setMass mass","since":null,"effect":null,"exec":null,"params":[{"name":"myObject","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"myObject: Object"},{"name":"mass","type":"Number","optional":false,"default":null,"description":null,"types":["Number"],"since":null,"text":"mass: Number"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"myObject","types":["Object"]},"right":{"text":"mass","types":["Number"]}},{"syntax":"myObject setMass [mass, time]","since":null,"effect":null,"exec":null,"params":[{"name":"myObject","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"myObject: Object"},{"name":"mass","type":"Number","optional":false,"default":null,"description":null,"types":["Number"],"since":null,"text":"mass: Number"},{"name":"time","type":"Number","optional":false,"default":null,"description":null,"types":["Number"],"since":null,"text":"time: Number"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"myObject","types":["Object"]},"right":{"text":"[mass, time]","types":["Array"]}}],"examples":[{"text":"```sqf\nmyObject setMass [10, 0.5];\n```","code":["myObject setMass [10, 0.5];"]},{"text":"```sqf\nmyObject setMass 10;\n```","code":["myObject setMass 10;"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["getMass","setCenterOfMass","getCenterOfMass"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: PhysX","Introduced with Arma 3 version 1.02","Scripting Commands","Scripting Commands: Global Effect"]}