Skip to main content

​
Repair System

See Damage Zones for zone health levels, zone-specific effects, and rotor damage behaviour.

​
Requirements

All repairs require:
  • A Helicopter Repair Kit (CZ_HelicopterRepairKit) held in the player’s hands (not in inventory — must be actively held), and not ruined
  • Engine must be off — or the main rotor must be destroyed, which waives the engine-off rule for all six zones
  • Rotor must not be spinning — rotor spool must be below 50%
  • Player must be standing (not crouched or prone) and out of the helicopter — you cannot repair from a seat

​
Helicopter Height Limits

The repair actions are gated on how high the helicopter is sitting above the ground, not on how far away you are standing. A helicopter resting on the ground clears both limits; one perched on a roof or wedged high on terrain may not.
All zone repairs otherwise share the same pre-conditions above. There are no additional restrictions specific to any individual zone — in particular, the engine zone repairs like any other airframe zone and does not require a destroyed main rotor.

​
What Gets Repaired

The Helicopter Repair Kit repairs all 6 damage zones: Body, Engine, Chassis, Fuel, Main Rotor, Tail Rotor.

​
Progressive Repair — Airframe Zones Only

The four airframe zones (Body, Engine, Chassis, Fuel) repair progressively — each hold action repairs one damage level, so a critically damaged zone needs multiple holds to fully restore. The two rotor zones do not. A single rotor repair hold restores that rotor to full health and clears a sheared blade, putting the aircraft straight back into flyable condition. Each repair also restores a fraction of global HP (repair.globalHpPct).

​
What a Repair Cleans Up (v0.4.1)

Any repair that lands — repair kit, virtual garage or the Admin Panel — immediately clears the wreck fire, the engine smoke and the fuel-leak spray, and the helicopter’s visual damage state reverts to match its restored health. The Admin Panel’s Repair and Repair All go further than the kit: they restore every damage zone, every attached door and wheel, and the battery in one action — which is also the quickest way to rescue a helicopter left smoking or leaking by damage taken before v0.4.1.

​
Repair Settings

All repair settings live in the repair section of mod_config.json and apply globally.

​
Battery System

​
Requirements

A Helicopter Battery (CZ_HelicopterBattery) must be fitted in the helicopter’s HelicopterBattery inventory slot, not ruined, with charge greater than 0, before the engine can be started.
HelicopterBattery is the name of the slot, not the item. The item you fit into it is CZ_HelicopterBattery, and the repair kit is CZ_HelicopterRepairKit.

​
Battery Behaviour

Battery maximum charge is 500 units.

​
Battery Settings

To disable the battery requirement entirely, set battery.startDrain to 0. The helicopter will start without needing a battery in the slot.