> 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/helmet-camera/installation.md).

# Installation

Install ace\_helmetcam on your server.

{% stepper %}
{% step %}

### Place the resource

Copy `ace_helmetcam` into your `resources` directory. Keep the folder name, because inventory exports use it.
{% endstep %}

{% step %}

### Add it to `server.cfg`

{% code title="server.cfg" %}

```properties
ensure ace_helmetcam
```

{% endcode %}
{% endstep %}

{% step %}

### Choose commands or items

* **Commands (default):** leave `Config.AllowCommands = true`. Players use `/helmetcam 0` or `/helmetcam 1`.
* **Inventory items:** set `Config.AllowCommands = false` and set up the items below.
  {% endstep %}
  {% endstepper %}

## Inventory items (optional)

Item images are in `ace_helmetcam/_Images/`.

{% tabs %}
{% tab title="ox\_inventory" %}
{% code title="ox\_inventory/data/items.lua" %}

```lua
['acehelmetcamera'] = {
    label = 'Right Mounted Camera',
    weight = 150,
    stack = false,
    consume = 0,
    client = {
        export = 'ace_helmetcam.ActivateRightCameraPov'
    }
},

['acehelmetcamera2'] = {
    label = 'Left Mounted Camera',
    weight = 150,
    stack = false,
    consume = 0,
    client = {
        export = 'ace_helmetcam.ActivateLeftCameraPov'
    }
},
```

{% endcode %}

Copy `acehelmetcamera.png` and `acehelmetcamera2.png` to `ox_inventory/web/images/`.
{% endtab %}

{% tab title="Other inventories" %}
Register a usable item that calls one of these **client** exports:

```lua
exports['ace_helmetcam']:ActivateRightCameraPov()
exports['ace_helmetcam']:ActivateLeftCameraPov()
```

{% endtab %}
{% endtabs %}
