> ## 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.

# Required Items

> Classnames for HelicopterBattery, HelicopterRepairKit, and HeliDrum — items required for normal helicopter operation.

The following items are added by the CZ Autoz Helicopter mod and need to be added to your server's loot economy for full functionality.

***

## HelicopterBattery

| Property           | Value                                                        |
| ------------------ | ------------------------------------------------------------ |
| **Classname**      | `CZ_HelicopterBattery`                                       |
| **Inventory slot** | `HelicopterBattery` (dedicated slot in helicopter inventory) |
| **Required for**   | Starting the engine                                          |

### Behaviour

* Must be in the `HelicopterBattery` slot with **charge greater than 0** before the engine can be started
* **Drains** by `battery.startDrain` units on each engine start and engine stop
* **Recharges** at `battery.chargeRate` units per second while the engine is running
* **Drains** at `battery.lightDrain` units per second while lights are on
* Battery maximum charge is **500 units**

<Tip>
  To disable the battery requirement entirely, set `battery.startDrain = 0` in the helicopter's JSON config. The engine will start without needing a charged battery in the slot.
</Tip>

***

## HelicopterRepairKit

| Property             | Value                    |
| -------------------- | ------------------------ |
| **Classname**        | `CZ_HelicopterRepairKit` |
| **Must be held**     | In the player's hands    |
| **Engine state**     | Must be off              |
| **Helicopter state** | Must be grounded         |

### What it Repairs

Repairs all 6 damage zones: Body, Engine, Chassis, Fuel, Main Rotor, Tail Rotor.

### Repair Kit Durability

A single kit can perform `repair.kitUses` repairs (default: **5**) before going ruined. Configure in `mod_config.json`.

***

***

## Helicopter Fuel Drum

| Property         | Value                                                                 |
| ---------------- | --------------------------------------------------------------------- |
| **Classname**    | `CZAutoz_HeliDrum`                                                    |
| **Parent**       | `CanisterGasoline`                                                    |
| **Capacity**     | 100,000 ml                                                            |
| **Default fill** | 50% of any helicopter tank per full drum (2 drums to fill from empty) |

A large fuel drum designed for helicopter refuelling. Holds significantly more fuel than a standard jerry can. The fill percentage and drain speed are configurable in `mod_config.json` via `refuel.drumPct` and `refuel.drumRate`.

<Tip>
  The default drain rate (`refuel.drumRate = 5.0`) is set so a full drum takes the same wall-clock time to empty as a full jerry can, despite holding 5× the fuel. Adjust `refuel.drumRate` if you want a different fill speed.
</Tip>

***

## Adding Items to Your Server

Add classnames to your server's `types.xml` to control spawn rates. Example entries:

```xml theme={null}
<type name="CZ_HelicopterBattery">
    <nominal>5</nominal>
    <lifetime>14400</lifetime>
    <restock>1800</restock>
    <min>2</min>
    <quantmin>-1</quantmin>
    <quantmax>-1</quantmax>
    <cost>100</cost>
    <flags count_in_cargo="0" count_in_hoarder="0" count_in_map="1" count_in_player="0" crafted="0" deloot="0"/>
    <category name="tools"/>
</type>

<type name="CZ_HelicopterRepairKit">
    <nominal>5</nominal>
    <lifetime>14400</lifetime>
    <restock>1800</restock>
    <min>2</min>
    <quantmin>-1</quantmin>
    <quantmax>-1</quantmax>
    <cost>100</cost>
    <flags count_in_cargo="0" count_in_hoarder="0" count_in_map="1" count_in_player="0" crafted="0" deloot="0"/>
    <category name="tools"/>
</type>

<type name="CZAutoz_HeliDrum">
    <nominal>3</nominal>
    <lifetime>14400</lifetime>
    <restock>1800</restock>
    <min>1</min>
    <quantmin>-1</quantmin>
    <quantmax>-1</quantmax>
    <cost>100</cost>
    <flags count_in_cargo="0" count_in_hoarder="0" count_in_map="1" count_in_player="0" crafted="0" deloot="0"/>
    <category name="tools"/>
</type>
```

<Note>
  Adjust `nominal`, `min`, and `lifetime` to suit your server's economy. The values above are examples only.
</Note>