{"name":"setOpticsMode","operator":null,"title":"setOpticsMode","type":"command","url":"https://community.bistudio.com/wiki/setOpticsMode","revid":377651,"updated":"2026-01-02T09:01:57Z","groups":["Object Manipulation"],"status":"ok","replaced_by":[],"games":[{"game":"arma3","name":"Arma 3","version":"2.10"}],"since":{"game":"arma3","name":"Arma 3","version":"2.10"},"arma3_since":"2.10","branch":null,"locality":{"argument":null,"effect":null,"server_exec":false},"exec":null,"description":"Sets the optic mode of the current weapon to the given class name or the index.","syntaxes":[{"syntax":"unit setOpticsMode mode","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":"mode","type":"String, Number or Array:","optional":false,"default":null,"description":"String, Number or Array:\n- String - class name defined in the optic's `OpticsModes` config class\n- Number - 0-based index of the optic mode with 0 being the default optic mode\n- Array with [slotIndex, opticsModeIndexOrClassName]\n  - slotIndex: Number, can be one of:\n    - 0 - Current weapon\n    - 1 - Primary weapon\n    - 2 - Secondary weapon\n    - 3 - Handgun\n  - opticsModeIndexOrClassName: String or Number as above","types":["String","Number","Array"],"since":null,"text":"mode: String, Number or Array:\n- String - class name defined in the optic's `OpticsModes` config class\n- Number - 0-based index of the optic mode with 0 being the default optic mode\n- Array with [slotIndex, opticsModeIndexOrClassName]\n  - slotIndex: Number, can be one of:\n    - 0 - Current weapon\n    - 1 - Primary weapon\n    - 2 - Secondary weapon\n    - 3 - Handgun\n  - opticsModeIndexOrClassName: String or Number as above"}],"returns":{"type":"Nothing","types":["Nothing"],"description":null,"text":"Nothing"},"form":"binary","operator":null,"left":{"text":"unit","types":["Object"]},"right":{"text":"mode","types":["String","Number","Array"]}}],"examples":[{"text":"```sqf\nplayer setOpticsMode \"Hamr2Scope\"; // Default optic mode for optic_Hamr\n```","code":["player setOpticsMode \"Hamr2Scope\"; // Default optic mode for optic_Hamr"]},{"text":"```sqf\nplayer setOpticsMode 0;\n```","code":["player setOpticsMode 0;"]},{"text":"```sqf\nplayer setOpticsMode [1, 0]; // reset the optics mode of the player's primary weapon to the default\n```","code":["player setOpticsMode [1, 0]; // reset the optics mode of the player's primary weapon to the default"]}],"multiplayer":null,"problems":null,"aliases":[],"see_also":["getOpticsMode"],"notes":[],"categories":["Arma 3: New Scripting Commands","Arma 3: Scripting Commands","Command Group: Object Manipulation","Introduced with Arma 3 version 2.10","Scripting Commands"]}