Required Items

The mod adds four everyday items (battery, repair kit, flip wrench and fuel drum), plus two Barrel Helicopter build tools and the optional tracker set and Handheld Radar (Types & Events). Add the four everyday items to your server’s loot economy so players can fit a battery, repair a damaged aircraft, stand a tipped one back up and refuel it.

Helicopter Battery

Property	Value
Classname	`CZ_HelicopterBattery`
Where it goes	The `HelicopterBattery` slot in the helicopter’s inventory
Needed for	Starting the engine, and switching on the lights while the engine is off

Behaviour

Before the engine will start, a battery must be fitted in the HelicopterBattery slot, must not be ruined, and must have some charge left
Loses battery.startDrain charge every time the engine is started. Stopping it costs nothing
Gains battery.chargeRate charge every second the engine is running
Loses battery.lightDrain charge every second the lights are on
A new battery holds 500 charge. A damaged battery holds less, so a battered one runs flat sooner

You cannot switch the battery requirement off. Setting battery.startDrain to 0 only stops the battery from draining — it does not remove the need for one. The check is always made: a CZ_HelicopterBattery has to be fitted, unruined and holding some charge, or the Start Engine option simply will not appear. There is no setting that changes this, so make sure batteries are findable on your server.

Helicopter Repair Kit

Property	Value
Classname	`CZ_HelicopterRepairKit`
How to use it	Held in the player’s hands
Engine	Must be switched off, unless the main rotor is destroyed (on the Chinooks and Ospreys, both rotors)
Height	The helicopter must be within 3 m of the ground for a rotor, or 5 m for anything else. The ground is whatever it stands on — a helipad, an Editor object or a base floor counts

What it Repairs

It repairs all six parts of the helicopter: the body, the engine, the skids, the fuel tank, the main rotor and the tail rotor. On the two Chinooks the rotor repairs read Repair Front Rotor and Repair Rear Rotor, and on the two Ospreys Repair Left Rotor and Repair Right Rotor. Repairs happen in stages — one hold moves a part up one damage level, so a badly damaged part takes several holds. A rotor is fully repaired in a single hold.

Repair Kit Durability

One kit does repair.kitUses repairs before it is worn out, five by default. Change it in mod_config.json; set it to 0 and kits never wear out. How long each repair takes is set there too, by repair.rotorRepairTime and repair.zoneRepairTime.

Helicopter Flip Wrench

Property	Value
Classname	`CZ_HelicopterFlipWrench`
Parent	`LugWrench`
How to use it	Held in the player’s hands, beside the helicopter — hold the Flip Upright action for 8 seconds
Uses	Four recoveries to a new wrench

Stands a helicopter back on its gear after a crash leaves it lying on its side. The action shows when the aircraft is tipped past roughly 70°, has all but stopped and its lowest part is within about 3 m of something solid, so tall aircraft lying on their backs, such as the Ospreys and Chinooks, can be stood up too. It won’t stand up a destroyed wreck.

It uses the same placement as the pilot’s X flip: the aircraft is stood up on whatever it is actually lying on — the ground, or a player-built floor — and if the upright helicopter would have no room there (a roof above, an overhang) it refuses and moves nothing, so a roof is never a way into a base
The engine is left as it is, and anyone still in a seat stays in it
It is not tied to groundFlipRecovery: the wrench is an item you choose to hand out. If crashes on your server should be final, leave it out of your loot and traders
Every use is written to the activity log as FLIP_WRENCH

Helicopter Fuel Drum

Property	Value
Classname	`CZ_HeliDrum`
Parent	`CanisterGasoline`
Capacity	100,000 ml
Default fill	Half a tank per full drum, on any helicopter — so two drums fill anything from empty

A big fuel drum meant for helicopters. It holds five times as much as a jerry can. How much of the tank it fills and how fast it pours are both set in mod_config.json, by refuel.drumPct and refuel.drumRate.

The old classname CZAutoz_HeliDrum still works, so nobody’s existing types.xml or trader files break. It is only kept for that reason — move over to CZ_HeliDrum, because the old name will be removed in a future release.

The default refuel.drumRate of 5.0 means a full drum takes about as long to pour as a full jerry can, even though it holds five times as much. Change it if you want drums to be slower or faster.

Barrel Helicopter Tools

Two tools exist only to build the Barrel Helicopter. Neither does anything to any other aircraft.

Property	Barrel Cutting Torch	Airframe Assembly Wrench
Classname	`CZ_BarrelHeli_CuttingTorch`	`CZ_BarrelHeli_AssemblyWrench`
Parent	`Blowtorch`	`LugWrench`
What it does	Cuts a fuel drum open into a bare frame	Builds and dismantles every part, and signs the finished aircraft off
Jobs per tool	`barrelHeli.torchUses`, 8 by default	`barrelHeli.wrenchUses`, 40 by default

The torch runs on gas, so it needs a charged canister, and its flame is visible to everyone while it cuts. Both tools spawn in Industrial alongside the thirteen build parts.

New Items in v0.4.7

Four optional items arrived in v0.4.7. None of them is needed to fly.

Item	Classname	Page
GPS Tracker	`CZ_HeliTracker`	Helicopter Tracker
Tracker Receiver	`CZ_HeliTrackerReceiver`	Helicopter Tracker
Signal Scanner	`CZ_HeliSignalScanner`	Helicopter Tracker
Handheld Radar	`CZ_HandheldRadar`	Handheld Radar

Example types.xml entries for all four are on the types.xml & events.xml page.

Helicopter Parts

From v0.4.8 a helicopter needs more than a battery. Four parts are fitted in the helicopter’s Engine attachments, next to the battery: the igniter plug, the hydraulic hoses, the avionics computer and (only on helicopters with a chin camera) the camera pod. Two fluids, turbine oil and hydraulic fluid, are poured in from their cans like fuel, and the helicopter keeps their level. The Barrel Helicopter needs none of them.

Part	Classname	How it goes in	What happens without it
Igniter Plug	`CZ_HeliIgniterPlug`	Slot `HeliIgniterPlug`	The engine will not start. Every start wears the plug a little; a damaged plug sometimes fails to light the engine (the starter still costs battery charge), and a badly damaged one fails about half the time
Turbine Oil (1 L)	`CZ_HeliTurbineOil`	Poured in	The engine will not start with none. One full can fills the helicopter. The engine burns it slowly while it runs; below 20% the engine loses some power, and when it runs dry in flight it loses a lot of power and wears itself out in about five minutes
Hydraulic Hoses	`CZ_HeliHydraulicHoses`	Slot `HeliHydraulicHoses`	The controls become very heavy and the hydraulic fluid drains away while the rotor turns. Damaged hoses leak fluid
Hydraulic Fluid (1 L)	`CZ_HeliHydraulicFluid`	Poured in	One full can fills the helicopter. Below a quarter the controls get heavy; empty, they are very heavy
Avionics Computer	`CZ_HeliAvionicsComputer`	Slot `HeliAvionics`	Autopilot, Auto Hover (including the hold when the pilot gets out), radar (HUD and cockpit radar screen), terrain warning, GPS (Pilot Panel map and cockpit GPS screen), chin camera, the bottom-left HUD, and the radar altimeter and navigation needles on the cockpit instruments all stay off. The other cockpit gauges and the warning lights keep working. The helicopter can still be flown by hand, and the damage panel still shows
Camera Pod	`CZ_HeliCameraPod`	Slot `HeliCameraPod`	The chin camera does not work, and on the helicopters with a visible camera ball the ball disappears. Only on helicopters that have a chin camera

Good to know

Each part can be switched off. The parts section of mod_config.json (or the Helicopter Parts group in the Admin Panel) has one switch per part. A part that is switched off is never needed, and its slot is simply spare. See Global settings.
Helicopters already on your server get the parts once. The first time each saved helicopter loads after the update, any part it is missing is fitted for free and both fluids are full, so nobody logs in to a dead aircraft. Turn parts.fitExistingEnabled off before updating if you would rather players found the parts themselves.
Newly spawned helicopters arrive without parts, the same as the battery, but with both fluids full. Add the six items to your loot (examples on the types.xml & events.xml page), or give spawned helicopters their parts with cfgspawnabletypes.xml.
Pouring: hold the can, stand at the helicopter’s refuel point with the rotor stopped, and hold Pour turbine oil or Pour hydraulic fluid. A can pours in about ten seconds, only as much as there is room for goes in, and the new level is shown when you finish.
Checking: at the same refuel point, Check fluids and parts shows both fluid levels and the state of every fitted part (OK, worn, damaged, badly damaged, ruined or missing).
Wear and repair: hits and crashes on the engine wear the igniter plug and the hoses, and hits on the body wear the avionics computer and the camera pod, at about the same rate as the part of the helicopter they sit in. Mend the hoses with duct tape, and the igniter plug, avionics computer and camera pod with an electronic repair kit.
The Admin Panel’s Repair and Repair All now also fit any missing part and fill both fluids.
Parts come out only with the engine off, like the battery, and not while the helicopter is locked.
The damage panel (top left) shows OIL and HYD levels in every panel style, and a caution line (for example “OIL LOW / NO HOSES / AVIONICS OUT”) whenever a part or fluid is missing, low or failed. On the UH-1H the cockpit oil pressure and temperature gauges follow the oil level too.
The pilot sees which part is stopping a start on the left-hand key prompts (for example “Igniter plug missing — can’t start”), and gets a message the moment the hydraulics, the oil or the avionics fail in flight.
The cans show how much is left in them, so a part-used can can be poured into another helicopter.

Adding Items to Your Server

Add these classnames to your server’s types.xml to control how often they spawn. Ready-made entries for these four and every helicopter part are also on the types.xml & events.xml page. 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="CZ_HelicopterFlipWrench">
    <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>

<type name="CZ_HeliDrum">
    <nominal>4</nominal>
    <lifetime>14400</lifetime>
    <restock>1800</restock>
    <min>1</min>
    <quantmin>20</quantmin>
    <quantmax>70</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>

These numbers are examples only. Change nominal, min and lifetime to suit your own server.

Getting Started

The Fleet

Features

Server Configuration

More

Helicopter Battery

Behaviour

Helicopter Repair Kit

What it Repairs

Repair Kit Durability

Helicopter Flip Wrench

Helicopter Fuel Drum

Barrel Helicopter Tools

New Items in v0.4.7

Helicopter Parts

Good to know

Adding Items to Your Server

​Helicopter Battery

​Behaviour

​Helicopter Repair Kit

​What it Repairs

​Repair Kit Durability

​Helicopter Flip Wrench

​Helicopter Fuel Drum

​Barrel Helicopter Tools

​New Items in v0.4.7

​Helicopter Parts

​Good to know

​Adding Items to Your Server

Helicopter Battery

Behaviour

Helicopter Repair Kit

What it Repairs

Repair Kit Durability

Helicopter Flip Wrench

Helicopter Fuel Drum

Barrel Helicopter Tools

New Items in v0.4.7

Helicopter Parts

Good to know

Adding Items to Your Server