> For the complete documentation index, see [llms.txt](https://acestudios.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://acestudios.gitbook.io/docs/tactical-and-military/recon-optics/configuration.md).

# Configuration

Configure ace\_reconoptics through config.lua.

All settings are in `ace_reconoptics/config.lua`.

## General

| Option                    | Type    | Default           | Description                                                                                                                                                                 |
| ------------------------- | ------- | ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `Config.EnableCommandUse` | boolean | `true`            | Lets players use the optics with commands. If `false`, set up [inventory items](/docs/tactical-and-military/recon-optics/installation.md#inventory-items-optional) instead. |
| `OpticsName`              | string  | `'Ace Optics'`    | Name used throughout the script.                                                                                                                                            |
| `BinocularCommand`        | string  | `'binoculars'`    | Command that uses the binoculars.                                                                                                                                           |
| `SpottingScopeCommand`    | string  | `'spottingscope'` | Command that deploys the spotting scope.                                                                                                                                    |
| `ClearPedTask`            | string  | `'scopereset'`    | Command that resets a player who gets stuck while using optics.                                                                                                             |
| `ScreenEffect`            | boolean | `true`            | Adds screen effects while using optics.                                                                                                                                     |

## Controls

| Option                    | Default    | Description                                             |
| ------------------------- | ---------- | ------------------------------------------------------- |
| `GetRangeButton`          | `'E'`      | Gets the range to the point you're aiming at.           |
| `ToggleThermalButton`     | `'LSHIFT'` | Toggles thermal vision.                                 |
| `ToggleNightVisionButton` | `'H'`      | Toggles night vision.                                   |
| `ThermalMode`             | `1`        | `1` = default GTA thermal, `2` = custom thermal vision. |

## Binoculars

`Config.Settings.BinocularSettings`

| Option           | Default | Description                                  |
| ---------------- | ------- | -------------------------------------------- |
| `NightVision`    | `true`  | Allows night vision.                         |
| `ThermalVision`  | `false` | Allows thermal vision.                       |
| `MaxZoomAmmount` | `6.0`   | Maximum zoom. **Lower values zoom further.** |

## Spotting scope

`Config.Settings.SpottingScopeSettings`

| Option                  | Default | Description                                                    |
| ----------------------- | ------- | -------------------------------------------------------------- |
| `NightVision`           | `true`  | Allows night vision.                                           |
| `ThermalVision`         | `true`  | Allows thermal vision.                                         |
| `MaxZoomAmmount`        | `1.0`   | Maximum zoom. **Lower values zoom further.**                   |
| `SetWayPointWhenRanged` | `true`  | Sets a map waypoint at the aimed location when range is taken. |