> 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/tactical-hud.md).

# Tactical HUD (Armor Cams)

Tactical camera HUDs for tanks, APCs and other armored vehicles.

**Tactical HUD** (`ace_armorcams`) adds seat-based camera views to armored vehicles. Gunners get a sight overlay, commanders get a zoomable overlay, and both see an on-screen range readout. Every vehicle is set up in the config, so you can add any tank, IFV or APC.

|                   |                                             |
| ----------------- | ------------------------------------------- |
| **Resource name** | `ace_armorcams`                             |
| **Version**       | 2.0.0                                       |
| **Frameworks**    | Framework-independent (no framework needed) |
| **Dependencies**  | None besides FiveM Asset Escrow             |
| **Database**      | Not used                                    |

## Features

* **HUD presets.** Pair a gunner overlay texture with a commander overlay texture. Two presets ship ready to use: `TANK` and `IFV`.
* **Per-vehicle seat mapping.** Choose which seat is driver, gunner and commander, or turn a seat off.
* **Driver-controlled weapons.** One seat can switch between driver view and gunner view with a key.
* **Commander zoom** with up to `MaxZoomLevel` zoom steps, each with its own overlay texture.
* **Range readout** shown at a configurable screen position.
* **Optional safety options.** Block driving while in gunner view, and lock the commander camera's rotation.
* **Sound effects** for clicks and seat switching (NUI audio).
* **Seat ID debug command** to find seat numbers for new vehicles.
* Preconfigured for the `rhino`, `apc` and `khanjali`.

## Pre-configured vehicles

| Vehicle    | HUD preset | Driver controls weapon | Driver seat | Gunner seat | Commander seat |
| ---------- | ---------- | :--------------------: | :---------: | :---------: | :------------: |
| `rhino`    | `TANK`     |            ✅           |     `-1`    |     Off     |       `0`      |
| `apc`      | `IFV`      |            —           |     `-1`    |     `0`     |       `1`      |
| `khanjali` | `IFV`      |            ✅           |     `-1`    |     Off     |       `0`      |

## Default controls

| Key          | Action                                                                     | Config option      |
| ------------ | -------------------------------------------------------------------------- | ------------------ |
| <kbd>Q</kbd> | Toggle zoom in the commander camera                                        | `ToggleZoomButton` |
| <kbd>E</kbd> | Switch between driver and gunner view (when `DriverControlsWeapon = true`) | `SwitchViewKey`    |

## Commands

| Command   | Available when              | Description                                                           |
| --------- | --------------------------- | --------------------------------------------------------------------- |
| `/SeatID` | `DebugCommandActive = true` | Shows the seat ID you're sitting in. Use it when adding new vehicles. |

{% content-ref url="/pages/RlAjqYgdmOyJ9GF4nLnq" %}
[Installation](/docs/tactical-and-military/tactical-hud/installation.md)
{% endcontent-ref %}

{% content-ref url="/pages/HN8QrD74hpbYtCWxhsnz" %}
[Configuration](/docs/tactical-and-military/tactical-hud/configuration.md)
{% endcontent-ref %}