Wiki Navigation

cfgEffectArea.json Configuration

Configure contaminated areas and special effect zones in your DayZ server. This file defines static and dynamic contamination zones that affect player health and gameplay.

Overview

The cfgEffectArea.json file defines contaminated areas and special effect zones in your DayZ server. These areas can include:

  • Static contamination zones with permanent gas effects
  • Dynamic contamination zones with temporary effects
  • Custom environmental effects and area triggers

File Structure

The cfgEffectArea.json file uses JSON format to define effect areas:

{
    "staticEffectArea": [
        {
            "type": "ContaminatedArea_Static",
            "position": [7650, 0, 13300],
            "radius": 100,
            "innerRingCount": 10,
            "innerRingDist": 10.0,
            "outerRingToggle": 1,
            "outerRingDist": 120.0,
            "color": [0.0, 1.0, 0.0, 1.0],
            "duration": -1,
            "particleDensity": 0.5,
            "particleSize": 1.0,
            "particleSpeed": 0.1,
            "damagePerSecond": 5,
            "damageType": "chemical"
        }
    ],
    "dynamicEffectArea": [
        {
            "type": "ContaminatedArea_Dynamic",
            "position": [5600, 0, 8400],
            "radius": 80,
            "innerRingCount": 8,
            "innerRingDist": 10.0,
            "outerRingToggle": 1,
            "outerRingDist": 100.0,
            "color": [1.0, 0.0, 0.0, 0.8],
            "duration": 900,
            "particleDensity": 0.8,
            "particleSize": 1.5,
            "particleSpeed": 0.2,
            "damagePerSecond": 10,
            "damageType": "chemical",
            "spawnChance": 0.7,
            "respawnTime": 300
        }
    ]
}

Static Effect Area Parameters

type string

The type of effect area. Use "ContaminatedArea_Static" for permanent contamination zones.

position array

The [x, y, z] coordinates of the effect area center. Y is typically 0 for ground level.

radius integer

The radius of the effect area in meters. This defines the contaminated zone size.

innerRingCount integer

Number of inner rings in the effect visualization. Controls the visual density of the contamination effect.

innerRingDist float

Distance between inner rings in meters. Controls the spacing of visual effects.

outerRingToggle integer

Enable (1) or disable (0) outer ring visualization. Creates a warning zone around the contaminated area.

outerRingDist float

Distance of the outer ring from the center in meters. Creates a warning zone.

color array

The [r, g, b, a] color values for the effect visualization. Alpha controls transparency.

duration integer

Duration of the effect in seconds. Use -1 for permanent static areas.

damagePerSecond integer

Amount of damage dealt to players per second while in the contaminated area.

Dynamic Effect Area Parameters

type string

The type of effect area. Use "ContaminatedArea_Dynamic" for temporary contamination zones.

spawnChance float

Probability (0.0 to 1.0) of the dynamic area spawning when triggered.

respawnTime integer

Time in seconds before the dynamic area can respawn after being triggered.

particleDensity float

Density of particle effects (0.0 to 1.0). Controls the visual intensity of the contamination.

particleSize float

Size of particle effects. Larger values create more visible contamination effects.

particleSpeed float

Speed of particle movement. Controls how fast the contamination effects move.

damageType string

Type of damage dealt. Use "chemical" for contamination damage that requires specific medical treatment.

position array

The [x, y, z] coordinates where the dynamic area can spawn when triggered.

radius integer

The radius of the dynamic effect area in meters when spawned.

duration integer

Duration of the dynamic effect in seconds. After this time, the area disappears.

Color Configuration Examples

Green Gas

[0.0, 1.0, 0.0, 1.0]

Standard contamination gas

Red Gas

[1.0, 0.0, 0.0, 0.8]

High-intensity contamination

Yellow Gas

[1.0, 1.0, 0.0, 0.9]

Warning zone gas

Blue Gas

[0.0, 0.0, 1.0, 0.7]

Chemical contamination

Purple Gas

[1.0, 0.0, 1.0, 0.6]

Radiation-like effects

Orange Gas

[1.0, 0.5, 0.0, 0.8]

Toxic waste contamination

Best Practices

When configuring contaminated areas, consider the following best practices:

  • Place static contamination zones in strategic locations like military bases, hospitals, or industrial areas
  • Balance the risk vs. reward by placing valuable loot in contaminated areas
  • Use dynamic effect areas sparingly to avoid performance issues and server lag
  • Configure appropriate damage values that challenge players without being overwhelming
  • Use different colors to indicate different types of contamination and their severity
  • Test contamination zones thoroughly to ensure they don't interfere with essential gameplay areas

Common Issues & Solutions

Performance Issues

Too many dynamic areas or high particle density can cause server lag. Reduce particleDensity and limit dynamic areas.

Invalid JSON Format

Ensure all brackets, commas, and quotes are properly formatted. Use a JSON validator to check syntax.

Coordinates Out of Bounds

Ensure position coordinates are within the map boundaries. Use DayZ map tools to verify coordinates.

Need Help?

For more information about configuring contaminated areas, check the official DayZ documentation.