$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 sections — logging, 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.
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.Extra Cargo Modules
Each extra module adds 1,000 inventory slots. Maximum 10 modules per helicopter.Repair
All repairs require aCZ_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 profiles —featuresSimple 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.Admin Access — Roles & Permissions
As of v0.2.9, admins and roles live in their own file —CZAutoz_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
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:Whitelist Log
Whitelist checks are always logged, regardless oflogging.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.