cfgGameplay.json Configuration

Master the core gameplay mechanics of your DayZ server with comprehensive control over player systems, environmental conditions, and base building rules through this powerful configuration file.

Overview

The cfgGameplay.json file is a crucial configuration file that defines the fundamental gameplay mechanics and behavioral systems on your DayZ server. This JSON-formatted file provides granular control over core gameplay elements that directly impact the player experience, including:

Player stamina, movement speed, and physical performance systems
Shock and unconsciousness recovery mechanics
Environmental conditions and seasonal temperature variations
Object spawner configurations and world lighting settings
Base building placement rules and construction validation checks

File Structure

The cfgGameplay.json file follows standard JSON formatting with clearly defined sections that organize different gameplay mechanics. Below is an example configuration showing the main structural components:

{
    "PlayerData": {
        "StaminaData": {
            "sprintStaminaModifierErc": 1.0,
            "sprintStaminaModifierCro": 1.0,
            "staminaWeightLimitThreshold": 6000.0,
            "staminaMax": 100.0,
            "staminaKgToStaminaPercentPenalty": 1.75,
            "staminaMinCap": 5.0
        },
        "ShockHandlingData": {
            "shockRefillSpeedConscious": 5.0,
            "shockRefillSpeedUnconscious": 1.0,
            "allowRefillSpeedModifier": true
        },
        "MovementData": {
            "timeToStrafeJog": 0.1,
            "rotationSpeedJog": 0.3,
            "timeToSprint": 0.45,
            "timeToStrafeSprint": 0.3,
            "rotationSpeedSprint": 0.15
        }
    },
    "WorldsData": {
        "lightingConfig": 1,
        "objectSpawnersArr": [
            "territory",
            "zombie"
        ],
        "environmentMinTemps": [
            -3.0,
            -2.0,
            0.0,
            4.0,
            9.0,
            14.0,
            18.0,
            17.0,
            14.0,
            9.0,
            4.0,
            0.0
        ],
        "environmentMaxTemps": [
            3.0,
            5.0,
            7.0,
            14.0,
            19.0,
            24.0,
            26.0,
            25.0,
            21.0,
            16.0,
            10.0,
            5.0
        ]
    },
    "BaseBuildingData": {
        "HologramData": {
            "disableIsCollidingBBoxCheck": 0,
            "disableIsCollidingPlayerCheck": 0,
            "disableIsClippingRoofCheck": 0,
            "disableIsBaseViableCheck": 0,
            "disableIsCollidingGPlotCheck": 0,
            "disableIsCollidingAngleCheck": 0,
            "disableIsPlacementPermittedCheck": 0,
            "disableHeightPlacementCheck": 0,
            "disableIsUnderwaterCheck": 0,
            "disableIsInTerrainCheck": 0
        },
        "ConstructionData": {
            "disablePerformRoofCheck": 0,
            "disableIsCollidingCheck": 0,
            "disableDistanceCheck": 0
        }
    }
}

PlayerData Section

StaminaData object

Defines the stamina system parameters including maximum stamina capacity, regeneration rates for different movement states, weight-based penalties, and minimum stamina thresholds that affect player mobility.

ShockHandlingData object

Manages shock recovery mechanics, determining how quickly players regain consciousness after being knocked out, with separate rates for conscious and unconscious recovery states.

MovementData object

Configures player movement dynamics including rotation speeds during different movement states, transition timing between jogging and sprinting, and strafing movement parameters.

WorldsData Section

lightingConfig integer

Specifies the lighting configuration profile for the world, affecting ambient lighting, shadows, and overall visual atmosphere during different times of day.

objectSpawnersArr array

Determines which object spawner systems are enabled on the server, such as territorial markers and infected spawning mechanisms.

environmentMinTemps/MaxTemps array

Sets the temperature ranges for each calendar month (12 values each), controlling seasonal weather patterns that affect player survival mechanics like hypothermia and overheating.

Base Building Configuration

The BaseBuildingData section provides comprehensive control over the base building system, allowing server administrators to customize construction mechanics and placement validation rules:

HologramData: Manages pre-placement validation checks including collision detection, terrain compatibility, height restrictions, and structural integrity requirements during the hologram preview phase
ConstructionData: Controls validation checks executed during the actual building process, including final collision detection, distance requirements, and structural support verification

Important Security Notice

Setting any validation check to 1 disables that specific check, which can make base building more permissive but may introduce exploits or allow unrealistic constructions. Test thoroughly in a controlled environment before deploying to production servers.

Common Customizations

These popular configuration modifications demonstrate practical applications of the cfgGameplay.json settings to create different gameplay experiences:

Enhanced Stamina System

Create unlimited or extended stamina for PvP-focused servers:

• Set staminaMax: 10000
• Set staminaKgToStaminaPercentPenalty: 0
• Adjust staminaMinCap: 100

Accelerated Recovery

Reduce downtime from unconsciousness:

• Increase shockRefillSpeedUnconscious: 10.0
• Boost shockRefillSpeedConscious: 15.0

Relaxed Building Rules

Enable creative base building by disabling restrictions:

• disableIsCollidingBBoxCheck: 1
• disableHeightPlacementCheck: 1
• disableIsInTerrainCheck: 1

Climate Modification

Adjust seasonal temperatures for different survival challenges:

• Increase all values in environmentMinTemps
• Raise environmentMaxTemps for tropical feel
• Lower both arrays for harsh winter conditions

Complete Parameter Reference

This comprehensive reference covers all available parameters in the cfgGameplay.json file, organized by category with detailed descriptions and default values.

General Parameters

Parameter	Type	Default	Description
version	int	`119`	Tracks the configuration file version for compatibility and update purposes
objectSpawnersArr	array	`[]`	Specifies which object spawner configuration files to load for world item spawning
disablePersonalLight	bool	`false`	Removes the automatic personal lighting that illuminates nearby objects during nighttime
lightingConfig	int	`1`	Controls nighttime lighting intensity (0 = bright lighting, 1 = darker, more atmospheric lighting)

Stamina Parameters

Parameter	Type	Default	Description
staminaMax	float	`100.0`	Sets the maximum stamina capacity for players (avoid setting to 0 to prevent issues)
staminaMinCap	float	`5.0`	Defines the minimum stamina threshold that players cannot go below (avoid 0 to prevent issues)
staminaWeightLimitThreshold	float	`6000.0`	Sets the stamina threshold that's exempt from weight-based penalties (divided by 1000 for calculation)
staminaKgToStaminaPercentPenalty	float	`1.75`	Multiplier that determines how much stamina is reduced based on the weight of items carried
sprintStaminaModifierErc	float	`1.0`	Adjusts stamina consumption rate when players sprint while standing upright
sprintStaminaModifierCro	float	`1.0`	Adjusts stamina consumption rate when players sprint while crouching
meleeStaminaModifier	float	`1.0`	Controls stamina drain when players perform melee combat actions and evasive maneuvers
obstacleTraversalStaminaModifier	float	`1.0`	Controls stamina consumption when players perform movement actions like jumping, climbing, and vaulting
holdBreathStaminaModifier	float	`1.0`	Controls how quickly stamina depletes when players hold their breath (useful for aiming)

Shock Parameters

Parameter	Type	Default	Description
shockRefillSpeedConscious	float	`5.0`	Determines how quickly players recover from shock damage when awake (per second)
shockRefillSpeedUnconscious	float	`1.0`	Controls how quickly unconscious players recover from shock damage (per second)
allowRefillSpeedModifier	bool	`true`	Enables shock recovery modifiers based on ammunition type (faster recovery from specific bullet wounds)

Movement & Inertia Parameters

Parameter	Type	Default	Description
timeToStrafeJog	float	`0.1`	Sets the time required to transition into diagonal movement while jogging (minimum 0.01)
rotationSpeedJog	float	`0.15`	Controls how quickly players can turn while jogging (minimum 0.01)
timeToSprint	float	`0.45`	Sets the time required to transition from jogging to sprinting (minimum 0.01)
timeToStrafeSprint	float	`0.3`	Sets the time required to transition into diagonal movement while sprinting (minimum 0.01)
rotationSpeedSprint	float	`0.15`	Controls how quickly players can turn while sprinting (minimum 0.01)
allowStaminaAffectInertia	bool	`true`	Enables stamina levels to affect player movement responsiveness and inertia

Base Building & Object Placement Parameters

Parameter	Type	Default	Description
disableBaseDamage	bool	`false`	Disables damage caused by player-built structures and base components
disableContainerDamage	bool	`false`	Removes damage caused by storage containers like tents and barrels
disableIsCollidingBBoxCheck	bool	`false`	Bypasses collision detection with world objects during building placement
disableIsCollidingPlayerCheck	bool	`false`	Bypasses collision detection with players during building placement
disableHeightPlacementCheck	bool	`false`	Bypasses height restrictions when placing building components
disableIsUnderwaterCheck	bool	`false`	Bypasses underwater placement restrictions for building components
disableIsInTerrainCheck	bool	`false`	Bypasses terrain collision detection during building placement

Environment Parameters

Parameter	Type	Default	Description
environmentMinTemps	array	`[-3, -2, 0, 4, 9, 14, 18, 17, 12, 7, 4, 0]`	Sets minimum temperatures for each month of the year (12 values total)
environmentMaxTemps	array	`[3, 5, 7, 14, 19, 24, 26, 25, 21, 16, 10, 5]`	Sets maximum temperatures for each month of the year (12 values total)

Navigation & UI Parameters

Parameter	Type	Default	Description
use3DMap	bool	`false`	Forces the use of 3D map view and disables the standard 2D map interface
ignoreMapOwnership	bool	`false`	Allows players to access the map interface even without carrying a map item
displayPlayerPosition	bool	`false`	Displays a red marker on the map showing the player's current position and direction
disableRespawnDialog	bool	`false`	Removes the respawn selection dialog that appears when players choose to respawn
disableRespawnInUnconsciousness	bool	`false`	Prevents unconscious players from using the respawn option in the pause menu

Need Help?

For more information about gameplay configuration, check the serverDZ.cfg documentation.

Wiki Navigation