server administration, JSON (JavaScript Object Notation) files have transitioned from secondary configuration tools to essential "blueprints" for modern server customization . While XML files traditionally handle the central loot economy, JSON files now govern core gameplay mechanics and the physical world through custom object spawning . The Core Architecture: cfggameplay.json
The cfggameplay.json file is the primary gateway for JSON-based modding. It serves as a master controller for settings that previously required complex scripting or external mods .
Gameplay Mechanics: Admins can use this file to toggle base-building damage, disable the respawn dialog, adjust stamina thresholds, and even remove the "personal light" during nighttime .
Object Spawning: Its most powerful feature is the objectSpawnersArr. This array allows the server to load external .json files that contain coordinates for custom buildings, bridges, and entirely new "Points of Interest" (POIs) created in tools like DayZ Editor . Installation & Activation Workflow
Installing JSON-based modifications follows a strict procedural sequence to ensure the server recognizes the custom data:
Installing JSON files in DayZ is primarily used for customising server spawns, mapping objects, or configuring economy settings. This report covers the standard installation process for these files. 1. Types of JSON Files in DayZ dayz json files install
Object Spawner Files: Created in tools like the DayZ Editor to place buildings, wrecks, or bases on the map.
Configuration Files: Used by server mods (like CF or Dabs Framework) to manage settings for traders, territory, or gameplay mechanics.
Central Economy (CE): Occasionally used for specific loot definitions or custom data types. 2. General Installation Steps
The process varies depending on whether you are using the in-game editor or a live server. For Server-Side Object Spawning
Generate the File: Use the Export to Object Spawner function in the DayZ Editor to save your map edits as a .json file. Step 1: Update Your start-server
Locate the Server Folder: Access your server files via FTP or a file manager.
Place the File: Most object spawners require the file to be placed in mpmissions\map_name\under_folder_name (usually defined by your specific spawning mod, like dabs-framework or BuilderItems).
Update Configs: You often need to list the new JSON file path in a config.cpp or a master init.c file so the server knows to load it at startup. For Mod Configurations
Start Server: Run the server once with the mod installed to generate the default folders.
Navigate to Profiles: Go to the Profiles (or SC) folder on your server. Step 2 – Back Up the Original File
Edit/Replace: Find the folder named after the mod and place your custom .json file inside. 3. Verification and Troubleshooting
JSON Validation: Always check your code for missing commas or brackets using a tool like JSONLint. A single syntax error will prevent the server from loading.
Verify Integrity: If you are experiencing errors after a manual install, use the Verify Integrity of Game Files option in Steam to ensure core files aren't corrupted.
Mod Repair: If a specific mod is causing issues with its JSON configs, right-click the mod in the DayZ Launcher and select Repair.
start-server.bat or Server Launch ParametersAdd the mod folder names you are using:
-mod=@CF;@DayZExpansion;@YourMod
Before installing anything new, rename the original to types_backup.xml or types_backup.json. This ensures you can revert if something breaks.
If you are installing a mod (like a weapon pack or a Trader mod), you don't manually place files. You use the CFGenTools mod.
-mod=@CFGenTools).ServerProfile folder.