Skip to main content

​
Repair System

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

​
Requirements

All repairs require:
  • HelicopterRepairKit held in the player’s hands (not in inventory — must be actively held)
  • Engine must be off — or the main rotor must be destroyed (a destroyed main rotor allows repairs even if the engine is still spooling down)
  • Rotor must not be spinning — rotor spool must be below 50%
  • Helicopter must be grounded — within 5 m AGL
  • Player must be standing (not crouched or prone)

​
Proximity Requirements

All zone repairs share the same pre-conditions above. There are no additional restrictions specific to any individual zone.

​
What Gets Repaired

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

​
Progressive Repair

Zone repair is progressive — each hold action repairs one damage level. If a zone has taken heavy damage, multiple hold actions may be required to fully restore it. Each repair also restores a fraction of global HP (repair.globalHpPct).

​
Repair Settings

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

​
Battery System

​
Requirements

A HelicopterBattery must be in the HelicopterBattery inventory slot with charge greater than 0 before the engine can be started.

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