Skip to main content
Edit $profile:\CZAutoz_Heli\mod_config.json to change settings that apply to all helicopters on your server. As of v0.2.9 the file is organised into clear sectionslogging, features (universal, applies in both flight modes), featuresSimple / featuresAdvanced (per-flight-mode profiles — see Flight Mode Profiles), gameplay, repair, refuel and extraModules. Each setting below is shown by its full path (for example featuresSimple.autoHoverEnabled). Admins and roles now live in their own file — see Admin Access. Delete this file and restart to regenerate it with all default values.
These settings are safe to adjust freely — they control gameplay features like cargo, repair, fuel warnings, logging, and server-wide toggles. Unlike the per-helicopter flight physics values, there is no risk of breaking flight behaviour by changing these.
Since v0.2.3, a mod update migrates mod_config.json in place along with every other config — new keys are added, removed keys cleaned up, and all your custom values are kept (originals are still backed up first to $profile:\CZAutoz_Heli\Backups\v<oldversion>_<date>\). Only when first moving from v0.2.2-or-earlier onto a v0.2.3+ build might a one-time re-apply be needed. Since v0.3.1, Smart Config Updates apply to the per-helicopter files and the flight-mode profiles here — untouched values adopt improved defaults automatically; customised values are always kept.
Editing these settings from the in-game Admin Panel applies them live (since v0.2.3) — every spawned helicopter and connected player updates instantly, no restart or reconnect. Only direct edits to the JSON config files need a server restart, since those are read on startup.

Extra Cargo Modules

Each extra module adds 1,000 inventory slots. Maximum 10 modules per helicopter.

Repair

All repairs require a CZ_HelicopterRepairKit held in hands and the engine off — unless the main rotor is destroyed, which waives the engine-off rule for every zone. The helicopter must also be low enough: within 3 m of the ground for rotor repairs, 5 m for the airframe zones.
Zone repair is progressive — one hold repairs one damage level. Full repair of a heavily damaged zone may require multiple holds.
Clamped on load. repair.kitUses, repair.rotorRepairTime and repair.zoneRepairTime are each floored at 1 when the config is read — a 0 or negative value is raised to 1 rather than disabling the feature.

Refuelling

Controls how much fuel each container type adds and how quickly it drains during the refuel action.

Refuel Amounts

The amount of fuel added is expressed as a fraction of the helicopter’s total tank capacity — so the same setting applies consistently regardless of which helicopter is being refuelled.

Refuel Drain Speed

Controls how fast the container empties during the refuel action. Higher values drain the container faster, reducing the wall-clock time to complete a fill.
Clamped on load. Every refuel.*Pct is clamped to 0.001–1.0, and every refuel.*Rate is floored at 0.01 — so a fill can never be set to zero or to more than one full tank per container.
Fuel-station refuelling (v0.3.0) needs no container and has no config keys — land within ~12 m of a working pump, walk to the fuel cap with empty hands, and hold F for a full tank in ~100 s. See HUD & Fuel.

Thresholds & Toggles

The features block holds the universal features — they apply no matter which flight mode the server runs. Flight-feel and difficulty features live in the per-mode profiles below.

Flight Mode Profiles (Simple / Advanced)

New in v0.2.9: the flight-feel features are split into two profilesfeaturesSimple and featuresAdvanced. The server’s gameplay.flightMode picks which profile is live, so you can pre-configure two personalities once (for example: assists on and calm skies in Simple; wind, harsh VRS and no auto-hover in Advanced) and swap the whole set by flipping the flight mode — including live from the Admin Panel. On first boot after updating, both profiles are seeded automatically from your existing features values, so behaviour is unchanged until you deliberately edit one profile.
VRS, blowback and anti-torque exist only in featuresAdvanced — the flight model never applies them in Simple mode, so they have no Simple twin.
Defaults retuned in v0.3.0 (blowback 0.35 → 0.08, antiTorque 0.12 → 0.04, vrsSeverity 0.40 → 0.22) after the Advanced model’s first full flight-testing pass — and blowback and anti-torque are now hard-capped in flight at 25% of the pilot’s own control authority, so no configured value can overpower the pilot. Config migration keeps your stored values: a server that generated its config on v0.2.9 still carries the old numbers. To adopt the new tuning, reset those three rows in the Admin Panel (applies live) or edit mod_config.json and restart.

Admin Access — Roles & Permissions

As of v0.2.9, admins and roles live in their own fileCZAutoz_Heli/permissions_admins_config.json, next to mod_config.json in your server profile — so a mod-config save can never touch admin data and vice-versa. Existing admins are migrated out of mod_config.json automatically on first boot — nothing to do.
The built-in owner role always has every permission and can never be locked out; every other role has exactly the keys you grant it — including mod.config.edit and heli.config.edit if you choose to hand those out. Tabs a role can’t view are hidden; action buttons a role can’t use show a “Permission Declined” dialog naming the missing key. The full guide — every permission key, the built-in roles, creating staff roles, and the safety rails — lives on the Admin Panel & Permissions page.

Logging

All three logs are date-stamped and roll over daily — a new file is opened when the server date changes, so nothing grows without bound.

Activity Log Events

The activity log is designed as an admin tool for investigations, compensation, and dispute resolution. Every significant player interaction with a helicopter is recorded with a precise timestamp, player display name, and Steam GUID — giving you a complete, chronological picture of exactly what happened, who was involved, and when. Common admin use cases:
  • Combat logging — confirm whether a player left a helicopter mid-fight or mid-pursuit
  • Theft and griefing — identify who took a helicopter, who was flying it, and what was removed from cargo
  • Compensation requests — verify whether a crash was caused by server-side damage, a rotor shear, or pilot error before compensating
  • Dispute resolution — cross-reference a player’s account of events against the timestamped log
  • Rotor kills — confirm who was piloting when a player was killed by a rotor disc, including both victim and pilot GUIDs
When logging.CZAutoz_logActivity = 1, every event is recorded with a timestamp, the helicopter classname, and the player’s display name and Steam GUID where applicable. All seat, engine, and physics events also include the helicopter’s world position (X/Z coordinates) at the time of the event.

Helicopter Presence

Engine

Seats

Cabin Mode

PvP Kill Detection

Combat & Damage

Flight Systems

Maintenance & Repairs

Lights & Controls

Admin & Spawning

Every Admin Panel action is logged with the acting admin’s name and GUID:
We strongly recommend enabling activity logging on all servers. It has no meaningful performance impact and gives you the full picture you need to handle compensation requests, combat log reports, theft disputes, and any helicopter-related staff situation confidently and fairly. Without it, you are relying entirely on player accounts of what happened.This mod logs all helicopter-specific interactions, but it does not cover general server-wide PvP kills. For complete kill accountability — including who shot who, with what weapon, and when — we recommend also running a dedicated PvP logging mod alongside this one. The two logs complement each other: helicopter activity records the context, a PvP logger records the kill chain.

Whitelist Log

Whitelist checks are always logged, regardless of logging.CZAutoz_logActivity — since v0.3.0 into the shared fleet whitelist log, the same date-stamped file the CZ Autoz vehicle mods write to: See Common Issues for how to use it when troubleshooting.