Skip to main content
Before troubleshooting, always check your server’s .RPT log file for error messages. Enable debug logging (CZH_debugLogging = 1 in mod_config.json) for more detailed output when investigating issues.

​
Installation & Whitelisting

The most common cause is an IP not being whitelisted.
  • Make sure you have submitted your server’s public IP in the #ip-whitelisting channel via the CZ Autoz Bot
  • Verify the IP submitted matches your server’s current public IP exactly — a single digit error will cause restricted operation
  • If your server IP has changed (e.g. new host, new instance), you must re-whitelist the new IP
  • After whitelisting, restart the server for changes to take effect
Config files are written to $profile:\CZAutoz_Heli\ on the first server start after the mod is loaded.
  • Confirm the mod is correctly added to your server’s -mod= startup parameter
  • Confirm the mod is loading successfully — check your RPT log for any mod load errors
  • Make sure the server profile directory is writable
  • Try a full server restart (not a crash recovery restart)
Helicopters are not added to loot automatically — you need to add them to your server’s economy:
  • Add helicopter classnames to your types.xml, trader config, or event spawner
  • All spawnable classnames are listed on the Helicopter Overview page
  • After editing types.xml, restart the server for changes to take effect

​
Engine & Battery

The engine start action requires a charged HelicopterBattery in the helicopter’s battery slot.
  • Check the helicopter’s inventory for a HelicopterBattery item in the dedicated battery slot
  • If the battery is present but has zero charge, it needs to be recharged or replaced
  • If no battery is present at all, add HelicopterBattery to your types.xml so it can spawn
  • To disable the battery requirement entirely: set CZH_batteryStartDrain = 0 in the helicopter’s JSON config
Battery drain is controlled by three settings in the helicopter’s JSON config:
SettingEffect
CZH_batteryStartDrainDrained per engine start/stop (default: 10)
CZH_batteryLightDrainDrained per second with lights on (default: 2.0)
CZH_batteryChargeRateRecharged per second while engine running (default: 5.0)
Battery max charge is 500 units. Increase CZH_batteryChargeRate or reduce drain values to extend battery life.
  • Confirm the battery is in the correct HelicopterBattery slot (not general cargo)
  • Make sure the battery charge is greater than 0 — a battery at exactly 0 charge will not work
  • Check your RPT log for any error messages related to engine start

​
Flight & Physics

Increase CZH_liftMultiplier in the helicopter’s JSON config. Each helicopter has a different default:
HelicopterDefault Lift
MD500 Civilian2.6
MH-6 Little Bird2.8
SA342M Gazelle2.7
UH-1H Iroquois3.3
MH-60L Blackhawk4.3
AW101 Merlin4.3
Try increasing by 0.2–0.5 increments and restarting the server to test.
Increase CZH_inputSmoothRate for snappier control response. Lower values = smoother/more sluggish, higher = more direct.Also check CZH_pitchStrength, CZH_bankStrength, and CZH_yawStrength — these can all be increased independently.
This is intentional behaviour when the tail rotor is destroyed. To reduce the severity:
  • Lower CZH_tailRotorSpinRate (degrees per second of uncontrolled yaw)
  • Lower CZH_tailRotorDescentRate (forced descent rate in m/s²)
  • Or disable tail rotor damage entirely: set CZH_dmgZoneRotor2 = 0
Check CZH_autoPilotEnabled in mod_config.json — if this is set to 0, autopilot is disabled server-wide. Set it to 1 and restart.

​
Repair & Damage

All repairs require:
  1. HelicopterRepairKit held in the player’s hands (not in inventory — must be in hands)
  2. Engine must be off
  3. Helicopter must be grounded
If all three conditions are met and the repair action still doesn’t appear, check that HelicopterRepairKit is in your types.xml and is spawning correctly.
Adjust these settings in the helicopter’s JSON config:
SettingEffect
CZH_dmgContactCoefLower = tougher airframe (less damage per impact)
CZH_crashThresholdHigher = harder hits needed before heavy damage occurs
To make a helicopter completely invincible, set all damage zones to 0:
"CZH_dmgZoneChassis": 0,
"CZH_dmgZoneBody": 0,
"CZH_dmgZoneEngine": 0,
"CZH_dmgZoneFuel": 0,
"CZH_dmgZoneRotor1": 0,
"CZH_dmgZoneRotor2": 0

​
Interior Walk

  • Interior Walk is only available on the UH-1H Iroquois and MH-60L Blackhawk
  • You must be seated as pilot or co-pilot — cabin passengers do not have this action
  • Check that CZH_cabinModeEnabled is set to 1 in mod_config.json
Set CZH_cabinModeEnabled = 1 in mod_config.json and restart the server.

​
Configuration

All config changes require a full server restart — changes are only read on startup. There is no hot-reload.
This usually happens if the CZH_version field in a JSON config was manually changed. The mod detects a version mismatch and resets that config file.
  • Do not manually edit CZH_version in any JSON config
  • Your old values are backed up to $profile:\CZAutoz_Heli\backup\ before any reset
New keys are added automatically on the next server start — you do not need to do anything. If they are still missing after a restart, check your RPT log for errors during config loading.

​
Logging & Diagnostics

Enable debug logging for detailed output when investigating an issue:
  1. Open $profile:\CZAutoz_Heli\mod_config.json
  2. Set "CZH_debugLogging": 1
  3. Restart the server
  4. Reproduce the issue
  5. Check $profile:\CZAutoz_Heli_debug.log for detailed output
Always set CZH_debugLogging back to 0 after troubleshooting. Leaving it enabled on a live server will generate large log files and may impact performance.

​
Still Need Help?

If your issue isn’t covered here, visit the CZ Autoz Discord for community support.

CZ Autoz Discord

Get help from the community and the development team