cfgundergroundtriggers.json
Controls underground trigger areas that change character state, lighting behavior, and environment rules below terrain.
Overview
cfgundergroundtriggers.json defines volumes used by the engine to detect underground areas. These triggers can alter environment behavior, lighting, character state, and underground-specific rules.
Most servers only edit this file for custom terrains, bunker changes, or map conversions. Treat it as a map-geometry file rather than a gameplay tuning file.
Quick Facts
| File | cfgundergroundtriggers.json |
|---|---|
| Format | JSON |
| Best for | Custom underground areas, bunkers, and terrain-specific trigger volumes |
What It Controls
Trigger Volumes
Defined spaces where players are treated as being underground.
Environment Rules
Can affect lighting, weather exposure, and underground behavior.
Map Fit
Coordinates and dimensions must match the active terrain and bunker layout.
Custom Areas
Useful when adding or moving underground structures on a custom mission.
Editing Guidance
Back up the vanilla file before making custom changes. Trigger files are sensitive to coordinate mistakes because the failure may only be visible after walking into a specific area.
After editing, test entry, exit, edge cases, and server restart behavior. Players should not flicker between underground and above-ground states around trigger boundaries.