ARGH_SHAHED_DRONE

# ARGH's Shahed-136 Drone

Arma Reforger addon adding deployable Shahed launch rails, flyable Shahed drones, and a high-yield nuke variant.

## Features

- Standard Shahed launcher and drone.
- Nuke Shahed launcher and drone.
- Build-book placement flow for both variants.
- Green placement ghost before assembly.
- 20 second hold-to-assemble interaction.
- 20 second disassemble interaction that returns the build book.
- Multiplayer launch flow with host/peer drone visibility support.
- Drone flight hint when entering drone view.
- Configurable drone input actions under `ARGH Drone Controls`.
- Custom launcher/book thumbnails.
- GM/editor and faction catalog entries for CIV, FIA, US, and USSR.

## Items

### Shahed Launcher Build Book

Places a standard Shahed launcher assembly site.

1. Equip the book.
2. Place the green launcher ghost on clear ground.
3. Approach the placed site.
4. Hold `F` for 20 seconds to assemble it.
5. Load and fire the Shahed.
6. Hold the disassemble action for 20 seconds to pack it back into the book.

### Shahed Nuke Launcher Build Book

Uses the same placement and assembly flow, but builds the nuke launcher and fires the nuke Shahed variant.

## Drone Controls

Default bindings:

- `W/S`: pitch and forward/back input.
- `A/D`: bank left/right.
- `Q/E`: yaw left/right.
- `Shift`: climb and boost.
- `Ctrl`: descend.
- `R`: toggle engine.
- `LMB`: fire/detonate.
- `Num Enter`: toggle camera.
- `Alt`: freelook.
- `X` or `Space`: exit drone view.

Controls are also registered in Settings > Controls as `ARGH Drone Controls`.

## Launcher Values

Standard launcher:

- Cooldown: 60 seconds.
- Drone warhead: `Prefabs/Weapons/Warheads/DroneExpo.et`.
- Current warhead values: `ChargeWeight 570`, `TntEquivalent 10`.

Nuke launcher:

- Drone warhead: `Prefabs/Weapons/Warheads/DroneExpoNUKE.et`.
- Current warhead values: `ChargeWeight 5700`, `TntEquivalent 100`.
- Nuke effect controller: `Prefabs/Effects/ShahedNukeFX.et`.
- Nuke destruction radius: 950 m.
- Nuke core destruction radius: 95 m.

## Notes

- If control names or keybind categories do not refresh after an update, fully restart Workbench/game so config and string-table resources reload.
- The nuke effect is intentionally large and should be tested on multiplayer servers before public use.
- This addon depends on base Arma Reforger data.

## First Release

See [VERSION_1.0.0.md](VERSION_1.0.0.md) for the initial release notes.