Skip to main content

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.

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

PropertyValue
ClassnameCZ_HelicopterBattery
Inventory slotHelicopterBattery (dedicated slot in helicopter inventory)
Required forStarting 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
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.

HelicopterRepairKit

PropertyValue
ClassnameCZ_HelicopterRepairKit
Must be heldIn the player’s hands
Engine stateMust be off
Helicopter stateMust 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

PropertyValue
ClassnameCZAutoz_HeliDrum
ParentCanisterGasoline
Capacity100,000 ml
Default fill50% 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.
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.

Adding Items to Your Server

Add classnames to your server’s types.xml to control spawn rates. Example entries:
<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>
Adjust nominal, min, and lifetime to suit your server’s economy. The values above are examples only.