> ## Documentation Index
> Fetch the complete documentation index at: https://docs.czautoz.co.uk/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Get your server configured in minutes — where the config files are, how to edit them, and how to reset to defaults.

## Where Are the Config Files?

All config files are automatically generated on the first server start at:

```
$profile:\CZAutoz_Heli\
```

<Note>
  `$profile:` refers to your DayZ server profile directory — the folder that contains your `BattlEye`, `mpmissions`, and `.RPT` log files.
</Note>

## File List

Each helicopter **variant** gets its own JSON config file. With 19 spawnable variants across 6 helicopters, you will see 19 individual config files plus `mod_config.json` for global settings.

**MD500 Civilian**

| File                                          | Variant                  |
| --------------------------------------------- | ------------------------ |
| `MD500_Civilian_config.json`                  | MD500 Civilian White     |
| `MD500_Civilian_ClassicRedSilver_config.json` | MD500 Classic Red/Silver |
| `MD500_Civilian_BlueCharter_config.json`      | MD500 Blue Charter       |
| `MD500_Civilian_GreenTour_config.json`        | MD500 Green Tour         |

**MH-6 Little Bird**

| File                   | Variant             |
| ---------------------- | ------------------- |
| `MH6_config.json`      | MH-6 Military Olive |
| `MH6_SWAT_config.json` | MH-6 SWAT           |

**SA342M Gazelle**

| File                                         | Variant               |
| -------------------------------------------- | --------------------- |
| `SA342M_config.json`                         | SA342M Standard Olive |
| `SA342M_GreenBrownBlackWoodland_config.json` | SA342M Woodland Camo  |
| `SA342M_TigerMeet_config.json`               | SA342M Tiger Meet     |

**UH-1H Iroquois**

| File                              | Variant               |
| --------------------------------- | --------------------- |
| `UH1H_Nasa_config.json`           | UH-1H NASA White      |
| `UH1H_MilitaryPolice_config.json` | UH-1H Military Police |
| `UH1H_StealthBlack_config.json`   | UH-1H Stealth Black   |
| `UH1H_White_config.json`          | UH-1H Plain White     |

**MH-60L Blackhawk**

| File                                | Variant                     |
| ----------------------------------- | --------------------------- |
| `MH60LBlackhawk_config.json`        | MH-60L Blackhawk Olive Drab |
| `MH60LBlackhawk_Desert_config.json` | MH-60L Blackhawk Desert     |

**AW101 Merlin**

| File                                         | Variant                           |
| -------------------------------------------- | --------------------------------- |
| `AW101Merlin_RoyalAirForce_config.json`      | AW101 Merlin Royal Air Force      |
| `AW101Merlin_RoyalNavy_config.json`          | AW101 Merlin Royal Navy           |
| `AW101Merlin_CanadaRescue_config.json`       | AW101 Merlin Canada Rescue        |
| `AW101Merlin_PortugueseAirForce_config.json` | AW101 Merlin Portuguese Air Force |

**Global**

| File              | Controls                            |
| ----------------- | ----------------------------------- |
| `mod_config.json` | Global settings for all helicopters |

## How to Edit

1. Navigate to `$profile:\CZAutoz_Heli\`
2. Open the JSON file for the helicopter you want to adjust in any text editor
3. Change the values
4. **Restart the server** — direct edits to the JSON files are read on startup, so they only take effect on the next start

<Tip>
  Prefer not to restart? The in-game **Admin Panel** edits the same settings and applies them **live** (since v0.2.3) — every spawned helicopter and connected player updates instantly, no restart or reconnect. Only direct JSON file edits need a restart.
</Tip>

<Warning>
  **Per-helicopter flight values** (`flight.liftMultiplier`, `control.pitchStrength`, `control.bankStrength`, etc.) are pre-tuned by the development team and are **not recommended to change**. Modifying them can result in helicopters that are difficult or impossible to fly. Adjust at your own risk.
</Warning>

<Tip>
  The **global settings** in `mod_config.json` (cargo modules, repair, toggles, logging) are completely safe to adjust — they don't affect flight behaviour.
</Tip>

## How to Reset to Defaults

Delete the helicopter's JSON file and restart. It will be regenerated with all default values.

## Config Migration on Version Update

Since **v0.2.3**, a mod update **migrates your configs in place** — both `mod_config.json` and all per-helicopter files. New keys are added, removed keys cleaned up, and **all your custom values are kept**. This keeps your configs in sync with new and changed keys without losing your tuning.

* Your originals are **backed up first** to `$profile:\CZAutoz_Heli\Backups\v<oldversion>_<date>\` before any migration touches a file
* Custom values are **carried over** — only the schema (which keys exist) is updated, not your settings
* Only when first moving from **v0.2.2-or-earlier** onto a v0.2.3+ build might a one-time re-apply be needed

<Warning>
  The migration is triggered by the `version` field stored in `mod_config.json` changing. Do **not** manually edit it — let the mod set it.
</Warning>

## Configuration Reference

The full configuration reference lives on this documentation site — see [Global Settings](/server-config/global-settings) for `mod_config.json` and [Per-Helicopter Settings](/server-config/per-helicopter-settings) for the per-variant files.

<Note>
  The old in-game `$profile:\CZAutoz_Heli\Guide\` reference folder is **no longer generated** as of v0.2 — all configuration documentation now lives here on the docs site.
</Note>