{"name":"addPlayerScores","operator":null,"title":"addPlayerScores","type":"command","url":"https://community.bistudio.com/wiki/addPlayerScores","revid":376997,"updated":"2026-01-01T08:05:12Z","groups":["Object Manipulation","Multiplayer"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"1.62"}],"since":{"game":"arma3","name":"Arma 3","version":"1.62"},"arma3_since":"1.62","branch":null,"locality":{"argument":null,"effect":null,"server_exec":true},"exec":null,"description":"MP server only: Adds player score.\n\n|  |  |  |  |  |  |\n|---|---|---|---|---|---|\n| Kill Type | infantry | soft | armor | air | killed |\n| Score Points | 1 | 2 | 3 | 5 | -1 |","syntaxes":[{"syntax":"unit addPlayerScores values","since":null,"effect":null,"exec":null,"params":[{"name":"unit","type":"Object","optional":false,"default":null,"description":null,"types":["Object"],"since":null,"text":"unit: Object"},{"name":"values","type":"Array with [killsInfantry, killsSoft, killsArmor, killsAir, score]","optional":false,"default":null,"description":"Array with [killsInfantry, killsSoft, killsArmor, killsAir, score]\n- killsInfantry: Number - number of infantry units killed\n- killsSoft: Number - number of soft vehicles killed\n- killsArmor: Number - number of armored vehicles killed\n- killsAir: Number - number of air vehicles killed\n- score: Number - total score","types":["Array"],"since":null,"text":"values: Array with [killsInfantry, killsSoft, killsArmor, killsAir, score]\n- killsInfantry: Number - number of infantry units killed\n- killsSoft: Number - number of soft vehicles killed\n- killsArmor: Number - number of armored vehicles killed\n- killsAir: Number - number of air vehicles killed\n- score: Number - total score"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"unit","types":["Object"]},"right":{"text":"values","types":["Array"]}}],"examples":[{"text":"```sqf\nplayer addPlayerScores [0, 1, 0, 0, 1];\n```","code":["player addPlayerScores [0, 1, 0, 0, 1];"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["addScore","addScoreSide","getPlayerScores","score","scoreSide"],"notes":[{"user":"Beno 83au","date":"2017-05-02T01:48:00Z","text":"As this command will add the given number to a player's score, a little bit of thought needs to be given to friendly-fire if it is for something like a deathmatch or a FFA, due to friendly-fire incurring negative points.\nSo to counter this just add 2 points every time a player kills a unit from the same side:\n\n```sqf\nplayer addPlayerScores [2, 0, 0, 0, 0];\n```\n\nThe 2 points will add 1 point to counter the negative friendly-fire point and 1 point to add correctly to the score."}],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Multiplayer","Command Group: Object Manipulation","Introduced with Arma 3 version 1.62","Scripting Commands","Scripting Commands: Server Execution"]}