{"name":"setOpticsMode","title":"setOpticsMode","type":"command","url":"https://community.bistudio.com/wiki/setOpticsMode","revid":377651,"updated":"2026-01-02T09:01:57Z","groups":["Object Manipulation"],"status":"ok","games":{"arma3":"2.10"},"since":"arma3 2.10","arma3_since":"2.10","description":"Sets the optic mode of the current weapon to the given class name or the index.","syntaxes":[{"syntax":"unit setOpticsMode mode","params":[{"name":"unit","type":"Object","type_expr":"Object"},{"name":"mode","type":"String, Number or Array:","description":"String, Number or Array:\n\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","type_expr":"String | Number | Array","text":"mode: String, Number or Array:\n\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","type_expr":"Nothing"},"form":"binary","left":{"text":"unit"},"right":{"text":"mode"}}],"examples":[{"code":["player setOpticsMode \"Hamr2Scope\"; // Default optic mode for optic_Hamr"]},{"code":["player setOpticsMode 0;"]},{"code":["player setOpticsMode [1, 0]; // reset the optics mode of the player's primary weapon to the default"]}],"see_also":["getOpticsMode"]}