{"name":"playerTargetLock","operator":null,"title":"playerTargetLock","type":"command","url":"https://community.bistudio.com/wiki/playerTargetLock","revid":377647,"updated":"2026-01-02T09:01:49Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.18"}],"since":{"game":"arma3","name":"Arma 3","version":"2.18"},"arma3_since":"2.18","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Get the local player's current locked target (with weapons that can lock on).","syntaxes":[{"syntax":"playerTargetLock","since":null,"effect":null,"exec":null,"params":[],"returns":{"type":"Array with [target, lockValue, config]","types":["Array"],"description":"target: Object - the locked object - lockValue: Number - in range 0..1 where 1 is fully locked - config: Config - used weapon's `CfgWeapons` config","text":"Array with [target, lockValue, config]\n- target: Object - the locked object\n- lockValue: Number - in range 0..1 where 1 is fully locked\n- config: Config - used weapon's `CfgWeapons` config"},"form":"nullary","operator":null,"left":null,"right":null}],"examples":[{"text":"```sqf\nplayerTargetLock params [\"_target\", \"_lock\", \"_cfg\"];\nif (_lock == 1) then\n{\n    hint format [\"%1 locked %2\", getText (_cfg >> \"displayName\"), getText (configOf _target >> \"displayName\")];\n};\n```","code":["playerTargetLock params [\"_target\", \"_lock\", \"_cfg\"];\nif (_lock == 1) then\n{\n\thint format [\"%1 locked %2\", getText (_cfg >> \"displayName\"), getText (configOf _target >> \"displayName\")];\n};"]},{"text":"```sqf\nplayerTargetLock; // returns [objNull, 0, configNull] if no lock is being done\n```","code":["playerTargetLock; // returns [objNull, 0, configNull] if no lock is being done"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["cursorTarget"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Arma 3 version 2.18","Scripting Commands"]}