Wiki Navigation

Configuration File
JSON Format

cfgGameplay.json Configuration

Master core gameplay mechanics including player stamina, movement, shock recovery, environmental conditions, and base building rules through this powerful configuration file.

Overview

The cfgGameplay.json file defines fundamental gameplay mechanics. It controls player stamina and movement, shock and unconsciousness recovery, environmental temperatures, and base building placement rules.

File Structure

The file uses JSON format with clearly defined sections for different gameplay systems.

{
    "PlayerData": {
        "StaminaData": {
            "staminaMax": 100.0,
            "staminaMinCap": 5.0,
            "staminaKgToStaminaPercentPenalty": 1.75
        },
        "ShockHandlingData": {
            "shockRefillSpeedConscious": 5.0,
            "shockRefillSpeedUnconscious": 1.0
        }
    },
    "WorldsData": {
        "lightingConfig": 1,
        "environmentMinTemps": [-3, -2, 0, 4, 9, 14, 18, 17, 14, 9, 4, 0],
        "environmentMaxTemps": [3, 5, 7, 14, 19, 24, 26, 25, 21, 16, 10, 5]
    },
    "BaseBuildingData": {
        "HologramData": {
            "disableIsCollidingBBoxCheck": 0,
            "disableHeightPlacementCheck": 0
        }
    }
}

PlayerData Section

StaminaData object

Defines stamina system parameters including maximum capacity, regeneration rates, weight-based penalties, and minimum thresholds affecting player mobility.

ShockHandlingData object

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

MovementData object

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

WorldsData Section

lightingConfig integer

Controls nighttime lighting intensity. 0 = bright lighting, 1 = darker atmospheric lighting. Affects ambient light, shadows, and overall visual atmosphere.

objectSpawnersArr array

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

environmentTemps array

Sets temperature ranges for each month (12 values). Controls seasonal weather affecting survival mechanics like hypothermia and overheating.

Stamina Parameters

staminaMax float

Maximum stamina capacity. Default: 100.0. Avoid setting to 0 to prevent issues. Higher values allow longer sprinting.

staminaMinCap float

Minimum stamina threshold players cannot go below. Default: 5.0. Prevents complete stamina depletion.

staminaWeightLimitThreshold float

Weight threshold exempt from penalties. Default: 6000.0 (6kg). Weight above this reduces stamina capacity.

staminaKgToStaminaPercentPenalty float

Multiplier for weight-based stamina reduction. Default: 1.75. Set to 0 to disable weight penalties entirely.

sprintStaminaModifierErc float

Stamina consumption rate when sprinting upright. Default: 1.0. Lower values reduce stamina drain.

sprintStaminaModifierCro float

Stamina consumption rate when sprinting crouched. Default: 1.0. Typically higher than standing sprint.

Base Building Parameters

The BaseBuildingData section controls construction mechanics and placement validation. Setting any check to 1 disables that validation, making building more permissive but potentially allowing exploits.

disableIsCollidingBBoxCheck boolean

Disables bounding box collision detection. Allows placing objects inside other objects.

disableIsCollidingPlayerCheck boolean

Disables player collision check. Allows placing objects where players are standing.

disableHeightPlacementCheck boolean

Disables height restrictions. Allows building at any elevation without limits.

disableIsInTerrainCheck boolean

Disables terrain clipping check. Allows placing objects partially inside terrain.

disableIsUnderwaterCheck boolean

Disables underwater placement check. Allows building in water and underwater.

disableIsCollidingAngleCheck boolean

Disables angle collision check. Allows building on steep slopes and angled surfaces.

Common Customizations

Unlimited Stamina (PvP)

For PvP-focused servers with extended stamina:

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

Fast Recovery

Reduce downtime from unconsciousness:

  • shockRefillSpeedUnconscious: 10.0
  • shockRefillSpeedConscious: 15.0

Creative Building

Relaxed building restrictions:

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

Harsh Winter

Lower temperatures for survival challenge:

  • environmentMinTemps: [-10, -8, -5, ...]
  • environmentMaxTemps: [-2, 0, 3, ...]

Best Practices

Recommended

  • Test changes on a development server before production
  • Backup your configuration before making changes
  • Validate JSON syntax after editing
  • Document your customizations for future reference

Avoid

  • Setting staminaMax or staminaMinCap to 0
  • Disabling all building checks without testing
  • Extreme temperature values that break gameplay
  • Invalid JSON syntax (missing commas, brackets)

Pro Tips

The temperature arrays contain 12 values representing each month (January through December). Adjust both min and max arrays together to maintain realistic temperature ranges. For PvP servers, consider disabling personal light (disablePersonalLight: true) for darker nights.