Config Settings JSON Format

cfgEffectArea.json

Defines environmental effect zones such as contaminated areas and their properties including location, radius, and active effects.

Overview

The cfgEffectArea.json file defines environmental effect zones on the map, most commonly contaminated (toxic) zones. Each zone has a position, radius, and configurable trigger properties that determine how players are affected when entering the area.

This file is located in the mission folder and is loaded at server startup. Players entering these zones without proper protective equipment (NBC gear) will take damage. Effect areas work alongside cfgeventspawns.xml for dynamic toxic zone events.

JSON Structure

The file contains an array of effect area objects. Each object defines a single zone with its properties and spatial data.

{
    "Areas": [
        {
            "AreaName": "Pavlovo_ContaminatedZone",
            "Type": "ContaminatedArea_Static",
            "TriggerType": "ContaminatedTrigger",
            "Data": {
                "Pos": [1752.0, 0.0, 3797.0],
                "Radius": 200.0,
                "PosHeight": 25.0,
                "NegHeight": 25.0,
                "InnerRingRatio": 0.9,
                "OuterRingRatio": 1.0,
                "VerticalOffset": 0.0
            },
            "PlayerData": {
                "AroundPartName": "فارغ",
                "TinyPartName": "",
                "PPERequesterType": ""
            }
        }
    ]
}

Parameters

Parameter	Type	Description
AreaName	String	Unique identifier for the effect area. Used for logging and reference.
Type	String	The effect area class. Determines the type of environmental effect applied.
TriggerType	String	The trigger class that activates when a player enters the zone.
Pos	Array [x, y, z]	World position coordinates of the zone center.
Radius	Float	Horizontal radius of the effect area in meters.
PosHeight	Float	Maximum height above the center position where the effect is active.
NegHeight	Float	Maximum depth below the center position where the effect is active.
InnerRingRatio	Float (0–1)	Ratio defining the inner ring where full effect intensity is applied. Players inside this ring receive maximum effect.
OuterRingRatio	Float (0–1)	Ratio defining the outer boundary. Between inner and outer rings, effect intensity transitions gradually.
VerticalOffset	Float	Vertical offset from the defined position. Useful for elevating or lowering the zone center.

Effect Types

ContaminatedArea_Static A permanent contaminated zone that is always active. Used for fixed toxic areas like Rify or Pavlovo military base.

ContaminatedArea_Dynamic A temporary contaminated zone spawned by events. These zones appear and disappear based on event triggers defined in events.xml.

ContaminatedTrigger The default trigger type for contaminated zones. Applies gas damage and visual effects to unprotected players.

Example Configurations

Multiple Static Zones

Define several contaminated areas across the map with varying sizes.

{
    "Areas": [
        {
            "AreaName": "Rify_ContaminatedZone",
            "Type": "ContaminatedArea_Static",
            "TriggerType": "ContaminatedTrigger",
            "Data": {
                "Pos": [13450.0, 0.0, 3350.0],
                "Radius": 150.0,
                "PosHeight": 30.0,
                "NegHeight": 10.0,
                "InnerRingRatio": 0.85,
                "OuterRingRatio": 1.0,
                "VerticalOffset": 0.0
            }
        },
        {
            "AreaName": "NWAF_ContaminatedZone",
            "Type": "ContaminatedArea_Static",
            "TriggerType": "ContaminatedTrigger",
            "Data": {
                "Pos": [4500.0, 0.0, 10200.0],
                "Radius": 300.0,
                "PosHeight": 20.0,
                "NegHeight": 20.0,
                "InnerRingRatio": 0.8,
                "OuterRingRatio": 1.0,
                "VerticalOffset": 0.0
            }
        }
    ]
}

Small High-Intensity Zone

A compact zone with a high inner ring ratio for intense, concentrated contamination.

{
    "Areas": [
        {
            "AreaName": "Bunker_ToxicZone",
            "Type": "ContaminatedArea_Static",
            "TriggerType": "ContaminatedTrigger",
            "Data": {
                "Pos": [6250.0, 0.0, 7800.0],
                "Radius": 50.0,
                "PosHeight": 10.0,
                "NegHeight": 30.0,
                "InnerRingRatio": 0.95,
                "OuterRingRatio": 1.0,
                "VerticalOffset": -5.0
            }
        }
    ]
}