# Usage / Integration

### Usage

#### Items

* Use the `binoculars` item for basic functionality
* Use the `binoculars_modes` item for enhanced functionality (night vision, thermal)

#### Commands

* `/binoculars` - Toggle binoculars (if enabled in config)

#### Controls

* `MOUSE WHEEL UP/W` - Zoom in
* `MOUSE WHEEL DOWN/S` - Zoom out
* `LEFT ARROW` - Previous mode
* `RIGHT ARROW` - Next mode
* `BACKSPACE` - Exit binoculars

### Modes

1. **Default** - Standard vision mode
2. **Night Vision** - Enhanced visibility in dark areas
3. **Thermal Vision** - Heat signature detection

### Integration

#### Client Exports

```lua
-- Check if binoculars are active
exports["force-binoculars"]:IsBinocularsActive()

-- Get the current binoculars state
--- @return table { active, mode, zoom }
exports["force-binoculars"]:GetBinocularsState()

-- Toggle binoculars
exports["force-binoculars"]:ToggleBinoculars()

-- Activate binoculars
exports["force-binoculars"]:ActivateBinoculars()

-- Deactivate binoculars
exports["force-binoculars"]:DeactivateBinoculars()
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.forcedevelopments.com/free-resources/force-binoculars/usage-integration.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.