{"name":"vectorAdd","operator":null,"title":"vectorAdd","type":"command","url":"https://community.bistudio.com/wiki/vectorAdd","revid":378392,"updated":"2026-04-04T07:53:40Z","groups":["Math - Vectors"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.22"}],"since":{"game":"arma3","name":"Arma 3","version":"1.22"},"arma3_since":"1.22","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Adds two arrays of numbers. Replaces BIS_fnc_vectorAdd.\n\n> [!NOTE]\n> **Since Arma 3 v2.14:** Since Arma 3 v2.14 any count of numbers is valid, if one array is larger than the other, the remaining elements are inserted without change.\n>\n> Before Arma 3 v2.14, the first argument had to be vector 3D, or Arma 3 v2.00 2D (Which still returned 3D result, with z coordinate defaulted to 0)","syntaxes":[{"syntax":"vector1 vectorAdd vector2","since":null,"effect":null,"exec":null,"params":[{"name":"vector1","type":"Array of Numbers","optional":false,"default":null,"description":"can be any size","types":["Array","Number"],"since":null,"text":"vector1: Array of Numbers - can be any size"},{"name":"vector2","type":"Array of Numbers","optional":false,"default":null,"description":"can be any size","types":["Array","Number"],"since":null,"text":"vector2: Array of Numbers - can be any size"}],"returns":{"type":"Array of Numbers","types":["Array","Number"],"description":null,"text":"Array of Numbers"},"form":"binary","operator":null,"left":{"text":"vector1","types":["Array","Number"]},"right":{"text":"vector2","types":["Array","Number"]}}],"examples":[{"text":"```sqf\nhint str (velocity unit1 vectorAdd velocity unit2);\n```","code":["hint str (velocity unit1 vectorAdd velocity unit2);"]},{"text":"```sqf\n[5, 10, 5] vectorAdd [5, 5, 10];            // returns [10, 15, 15]\n```","code":["[5, 10, 5] vectorAdd [5, 5, 10];\t\t\t// returns [10, 15, 15]"]},{"text":"```sqf\n[0, 0] vectorAdd [1, -2];                    // returns [1, -2]\n```","code":["[0, 0] vectorAdd [1, -2];\t\t\t\t\t// returns [1, -2]"]},{"text":"```sqf\n[1, 2, 3, 4, 5, 6] vectorAdd [10, 10, 10];    // returns [11, 12, 13, 4, 5, 6]\n```","code":["[1, 2, 3, 4, 5, 6] vectorAdd [10, 10, 10];\t// returns [11, 12, 13, 4, 5, 6]"]},{"text":"```sqf\n[1, 2, 3] vectorAdd [1, 2, 3];    // [2, 4, 6]\n[1, 2, 3] vectorAdd [1, 2];        // [2, 4, 3]\n[1, 2] vectorAdd [1, 2, 3];        // [2, 4, 3]\n[1, 2] vectorAdd [1, 2];        // [2, 4]\n```","code":["[1, 2, 3] vectorAdd [1, 2, 3];\t// [2, 4, 6]\n[1, 2, 3] vectorAdd [1, 2];\t\t// [2, 4, 3]\n[1, 2] vectorAdd [1, 2, 3];\t\t// [2, 4, 3]\n[1, 2] vectorAdd [1, 2];\t\t// [2, 4]"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["vectorDiff","vectorCrossProduct","vectorDotProduct","vectorCos","vectorMagnitude","vectorMagnitudeSqr","vectorMultiply","vectorDistance","vectorDistanceSqr","vectorDir","vectorUp","setVectorDir","setVectorUp","setVectorDirAndUp","matrixMultiply","matrixTranspose"],"notes":[{"user":"Lou Montana","date":"2023-11-02T17:40:30Z","text":"```sqf\n// between Arma 3 v2.00 and Arma 3 v2.14:\n[1, 2] vectorAdd [1, 2]; // [2, 4, 0]\n```"}],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Math - Vectors","Introduced with Arma 3 version 1.22","Scripting Commands"]}