# scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console architecture

> Architecture diagram of the GitHub repository scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-05-25). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console
- Repository: https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console

## Overview

1. This repository is not an application codebase; it is a DayZ map-content package. Its purpose is to define and deploy a custom underground bunker into a Chernarus server.

2. There are two main artifacts:
   - `ZAPADbunker.json`: the deployable server-side object spawner definition.
   - `ZAPADbunkerproject.dze`: the editable DayZ Editor project/source file used to modify the bunker layout visually.

3. The runtime boundary is the DayZ server. The server does not run custom logic from this repo; it reads the JSON as static world-geometry/object-spawn data through `cfggameplay.json`.

4. The configuration flow is:
   - Edit the bunker in DayZ Editor using the `.dze` file.
   - Export or place the resulting JSON into the server mission’s `custom/` folder.
   - Reference that JSON in `cfggameplay.json` via `objectSpawnersArr`.

5. The repo’s content is therefore split between authoring and deployment:
   - `.dze` = source asset for map editing.
   - `.json` = production asset consumed by the game server.

6. The main functional payload is a structure spawn at fixed world coordinates near West of Myshinko on Chernarus, specifically around `584.66 / 8094.18`. That makes the bunker location part of the data model, not dynamic gameplay logic.

7. The server integration boundary is important:
   - On PC, `enableCfgGameplayFile = 1;` must be enabled in `serverDZ.cfg`.
   - On console/Nitrado, `cfggameplay.json` must be enabled through server settings.
   This repo depends on that external server configuration being active.

8. The repo assumes a mission-folder based content pipeline. The JSON is not meant to be loaded directly from the repository; it must be copied into the server’s mission `custom/` directory and then referenced from gameplay config.

9. The architecture is intentionally minimal: there are no scripts, binaries, or dependencies in the repo itself. All behavior is driven by DayZ engine support for object spawners and editor-importable map data.

10. Operationally, the bunker has a couple of gameplay constraints noted in the README that affect testing and placement expectations:
   - players cannot climb out normally and must relog to surface,
   - dropped items may disappear from the bunker space.
   These are runtime effects of the placed geometry rather than separate code paths.

11. The external tooling boundary is DayZ Editor, which is used to author or revise the structure. The repo serves as a portable distribution of that authored content, not as a mod framework.

12. For an architecture diagram, the key nodes are: authoring tool (`.dze`), deployable content (`.json`), DayZ mission config (`cfggameplay.json` / `serverDZ.cfg`), and the DayZ server/runtime that instantiates the bunker in the world.

Main entry points: [`readme.txt`](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/readme.txt) (README), [`ZAPADbunkerproject.dze`](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunkerproject.dze) (Bunker project), [`ZAPADbunker.json`](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunker.json) (Bunker JSON)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Authoring"]
  node_dayz_editor["DayZ Editor<br/>external tool"]
  node_dze_source["Bunker project<br/>editor source"]
end

subgraph group_deployment["Deployment"]
  node_bunker_json["Bunker JSON<br/>spawn data<br/>[ZAPADbunker.json]"]
  node_mission_custom[("custom folder<br/>mission content")]
  node_cfg_gameplay["Gameplay cfg<br/>server config"]
  node_server_cfg["Server cfg<br/>server config"]
  node_readme["README<br/>usage notes<br/>[readme.txt]"]
end

subgraph group_runtime["Runtime"]
  node_dayz_server["DayZ server<br/>runtime"]
  node_world_bunker{{"Bunker build<br/>placed geometry"}}
end

node_dayz_editor -->|"edits"| node_dze_source
node_dze_source -->|"exports"| node_bunker_json
node_bunker_json -->|"copy to"| node_mission_custom
node_mission_custom -->|"referenced by"| node_cfg_gameplay
node_server_cfg -->|"enables"| node_cfg_gameplay
node_cfg_gameplay -->|"loads"| node_dayz_server
node_dayz_server -->|"spawns"| node_world_bunker
node_readme -->|"documents"| node_dayz_editor
node_readme -->|"documents"| node_cfg_gameplay
node_readme -->|"documents"| node_server_cfg
node_world_bunker -->|"lives in"| node_dayz_server

click node_dze_source "https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunkerproject.dze"
click node_bunker_json "https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunker.json"
click node_readme "https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/readme.txt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_dayz_editor,node_dze_source toneBlue
class node_bunker_json,node_mission_custom,node_cfg_gameplay,node_server_cfg,node_readme toneAmber
class node_dayz_server,node_world_bunker toneMint
```

## Components

### Authoring

Editable source content used to place and revise the bunker layout

- **DayZ Editor**: external tool · Visual editor used to author and revise the bunker layout
- [Bunker project](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunkerproject.dze): editor source · Editable DayZ Editor project file for the bunker layout · `ZAPADbunkerproject.dze`

### Deployment

Server-side content packaging and config wiring

- [Bunker JSON](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/ZAPADbunker.json): spawn data · Deployable object-spawner definition for the underground bunker · `ZAPADbunker.json`
- **custom folder**: mission content · Mission-folder location where the JSON is copied for server use
- **Gameplay cfg**: server config · cfggameplay.json entry point that references object spawner definitions
- **Server cfg**: server config · Enables cfgGameplay loading on PC via serverDZ.cfg
- [README](https://github.com/scalespeeder/dayz-chernaurus-zapad-underground-bunker-custom-json-file-for-pc-and-console/blob/main/readme.txt): usage notes · Operational notes covering deployment, editor workflow, and runtime constraints · `readme.txt`

### Runtime

DayZ engine and server-side world instantiation

- **DayZ server**: runtime · Game server/runtime that reads the object spawner data and places the bunker
- **Bunker build**: placed geometry · Static underground bunker structure instantiated in Chernarus near Myshinko

## Connections

- DayZ Editor → Bunker project: edits · The bunker is authored visually in DayZ Editor through the project file
- Bunker project → Bunker JSON: exports · The editor project is exported into the deployable object-spawner JSON
- Bunker JSON → custom folder: copy to · The JSON must be placed in the mission custom folder on the server
- custom folder → Gameplay cfg: referenced by · cfggameplay.json points at the deployed object spawner definition
- Server cfg → Gameplay cfg: enables · serverDZ.cfg must allow cfgGameplay loading on PC
- Gameplay cfg → DayZ server: loads · The DayZ server reads the configured object spawners at startup
- DayZ server → Bunker build: spawns · The runtime instantiates the bunker as static world geometry
- README → DayZ Editor: documents · The README explains the authoring workflow and external tooling
- README → Gameplay cfg: documents · The README describes the gameplay config integration path
- README → Server cfg: documents · The README notes the server setting required to activate cfgGameplay
- Bunker build → DayZ server: lives in · The bunker exists as a runtime placement managed by the server
