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

# Troubleshooting & FAQ

Common problems and questions for ace\_armorcams.

## Troubleshooting

<details>

<summary>Nothing happens when I enter the vehicle</summary>

* Check that the vehicle's **spawn name** is a key in `Config.Vehicles`.
* Check that you're in a seat set in the vehicle's entry. Seats set to `false` are turned off. Use `/SeatID` to confirm your seat number.
* Check that `HudPreset` matches a key in `Config.HudPresets` exactly (case-sensitive).
* Make sure the folder is named `ace_armorcams`.

</details>

<details>

<summary>The overlay is missing or shows a blank texture</summary>

* Check `gunnertexture` and `commandertexture` against the texture names inside `stream/ace_armorcamstxd.ytd`.
* For commander zoom, every zoom level needs a texture with the level number appended, and `commandertexture` must **not** include the number.

</details>

<details>

<summary>Commander zoom stops early or shows the wrong overlay</summary>

`MaxZoomLevel` must not be higher than the number of commander textures you added for that preset.

</details>

<details>

<summary>No sound effects</summary>

The sound NUI loads Howler.js from `cdnjs.cloudflare.com`. Check the client F8 console for blocked requests.

</details>

## FAQ

<details>

<summary>Can one player drive and shoot?</summary>

Yes. Set `DriverControlsWeapon = true` and `GunnerSeat = false`. The driver switches views with `SwitchViewKey` (default <kbd>E</kbd>). Add `DisableDriveWhileInGunnerMode = true` to stop them driving while aiming.

</details>

<details>

<summary>Does it work with addon vehicles?</summary>

Add the addon vehicle's spawn name to `Config.Vehicles` with its seat IDs and camera offsets.

</details>

<details>

<summary>Does it need a framework?</summary>

No. The resource has no framework, inventory or database dependency.

</details>