# lucasskrewer/dz-testbench architecture

> Architecture diagram of the GitHub repository lucasskrewer/dz-testbench, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/lucasskrewer/dz-testbench
- Repository: https://github.com/lucasskrewer/dz-testbench

## Overview

DZ-Testbench provides server-boot assertions and a report consumed by a PowerShell verdict runner. Its companion addons add client-side visual tours and an in-game placement probe. The excerpts show the test harness control flow and tour/placement behavior; runner and screenshot-capture tool details are based on README documentation, not inspected source.

Main entry points: [`addon/DZTestbench/scripts/4_World/DZT_Runner.c`](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Runner.c) (Suite runner), [`addon/DZTour/scripts/5_Mission/DZT_Tour.c`](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTour/scripts/5_Mission/DZT_Tour.c) (Tour driver), [`addon/DZTestbench/scripts/4_World/DZT_Test.c`](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Test.c) (Assertions), [`addon/DZPlace/scripts/4_World/DZ_Place.c`](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZPlace/scripts/4_World/DZ_Place.c) (Placement action)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_testing["Server Test Harness"]
  node_mission["Boot hook"]
  node_runner["Suite runner<br/>[DZT_Runner.c]"]
  node_constants["Run settings<br/>[DZT_Constants.c]"]
  node_registry["Suite registry"]
  node_builtin["Built-in suites"]
  node_suite["Suite base<br/>[DZT_Suite.c]"]
  node_test["Assertions<br/>[DZT_Test.c]"]
  node_case["Case record<br/>[DZT_CaseResult.c]"]
  node_results["Report model<br/>[DZT_Results.c]"]
  node_report["JSON report"]
end

subgraph group_tour["Visual Tour"]
  node_tourdriver["Tour driver<br/>[DZT_Tour.c]"]
  node_checkpoint["Checkpoints<br/>[DZT_Tour.c]"]
  node_screenshots["Checkpoint images"]
end

subgraph group_placement["Placement Probe"]
  node_placeaction["Placement action<br/>[DZ_Place.c]"]
  node_placelog["Placement log"]
  node_placeconstants["Probe settings"]
end

subgraph group_tools["External Test Tools"]
  node_testtool["Test runner script<br/>[run-tests.ps1]"]
  node_capturetool["Screenshot capturer<br/>[tour-capture.ps1]"]
end

node_server(("DayZ server"))
node_client(("DayZ client"))
node_player(("Player"))

node_server -->|"boots"| node_mission
node_mission -->|"creates"| node_runner
node_runner -->|"reads settings"| node_constants
node_runner -->|"collects suites"| node_registry
node_registry -->|"registers"| node_builtin
node_runner -->|"runs suites"| node_suite
node_runner -->|"creates assertions"| node_test
node_runner -->|"creates and writes"| node_results
node_results -->|"serializes"| node_report
node_test -.->|"records cases"| node_case
node_test -.->|"adds cases"| node_results
node_report -->|"read by"| node_testtool
node_testtool -->|"boots and scans"| node_server
node_client -->|"runs on connect"| node_tourdriver
node_tourdriver -->|"sets up and advances"| node_checkpoint
node_tourdriver -->|"signals by marker"| node_capturetool
node_capturetool -->|"captures"| node_screenshots
node_capturetool -->|"clears marker"| node_tourdriver
node_player -->|"triggers"| node_placeaction
node_placeaction -->|"appends coordinates"| node_placelog
node_placeaction -->|"uses paths and gate"| node_placeconstants

click node_mission "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/5_Mission/DZT_MissionServer.c"
click node_runner "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Runner.c"
click node_constants "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/3_Game/DZT_Constants.c"
click node_registry "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_SuiteRegistry.c"
click node_builtin "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Suites_Builtin.c"
click node_suite "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Suite.c"
click node_test "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Test.c"
click node_case "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_CaseResult.c"
click node_results "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Results.c"
click node_testtool "https://github.com/lucasskrewer/dz-testbench/blob/main/tools/run-tests.ps1"
click node_tourdriver "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTour/scripts/5_Mission/DZT_Tour.c"
click node_checkpoint "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTour/scripts/5_Mission/DZT_Tour.c"
click node_capturetool "https://github.com/lucasskrewer/dz-testbench/blob/main/tools/tour-capture.ps1"
click node_placeaction "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZPlace/scripts/4_World/DZ_Place.c"
click node_placeconstants "https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZPlace/scripts/3_Game/DZ_Place_Constants.c"

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_mission,node_runner,node_constants,node_registry,node_builtin,node_suite,node_test,node_case,node_results,node_report,node_client toneBlue
class node_tourdriver,node_checkpoint,node_screenshots toneAmber
class node_placeaction,node_placelog,node_placeconstants,node_server toneMint
class node_testtool,node_capturetool toneRose
class node_player toneIndigo
```

## Components

### Server Test Harness

- [Boot hook](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/5_Mission/DZT_MissionServer.c): `addon/DZTestbench/scripts/5_Mission/DZT_MissionServer.c`
- [Suite runner](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Runner.c): `addon/DZTestbench/scripts/4_World/DZT_Runner.c`
- [Run settings](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/3_Game/DZT_Constants.c): `addon/DZTestbench/scripts/3_Game/DZT_Constants.c`
- [Suite registry](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_SuiteRegistry.c): `addon/DZTestbench/scripts/4_World/DZT_SuiteRegistry.c`
- [Built-in suites](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Suites_Builtin.c): `addon/DZTestbench/scripts/4_World/DZT_Suites_Builtin.c`
- [Suite base](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Suite.c): `addon/DZTestbench/scripts/4_World/DZT_Suite.c`
- [Assertions](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Test.c): `addon/DZTestbench/scripts/4_World/DZT_Test.c`
- [Case record](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_CaseResult.c): `addon/DZTestbench/scripts/4_World/DZT_CaseResult.c`
- [Report model](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTestbench/scripts/4_World/DZT_Results.c): `addon/DZTestbench/scripts/4_World/DZT_Results.c`
- **JSON report**

### Visual Tour

- [Tour driver](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTour/scripts/5_Mission/DZT_Tour.c): `addon/DZTour/scripts/5_Mission/DZT_Tour.c`
- [Checkpoints](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZTour/scripts/5_Mission/DZT_Tour.c): `addon/DZTour/scripts/5_Mission/DZT_Tour.c`
- **Checkpoint images**

### Placement Probe

- [Placement action](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZPlace/scripts/4_World/DZ_Place.c): `addon/DZPlace/scripts/4_World/DZ_Place.c`
- **Placement log**
- [Probe settings](https://github.com/lucasskrewer/dz-testbench/blob/main/addon/DZPlace/scripts/3_Game/DZ_Place_Constants.c): `addon/DZPlace/scripts/3_Game/DZ_Place_Constants.c`

### External Test Tools

- [Test runner script](https://github.com/lucasskrewer/dz-testbench/blob/main/tools/run-tests.ps1): `tools/run-tests.ps1`
- [Screenshot capturer](https://github.com/lucasskrewer/dz-testbench/blob/main/tools/tour-capture.ps1): `tools/tour-capture.ps1`

### Other components

- **DayZ server**
- **DayZ client**
- **Player**

## Connections

- DayZ server → Boot hook: boots (evidence: `README.md`)
- Boot hook → Suite runner: creates (evidence: `addon/DZTestbench/scripts/5_Mission/DZT_MissionServer.c`)
- Suite runner → Run settings: reads settings (evidence: `addon/DZTestbench/scripts/4_World/DZT_Runner.c`)
- Suite runner → Suite registry: collects suites (evidence: `addon/DZTestbench/scripts/4_World/DZT_Runner.c`)
- Suite registry → Built-in suites: registers (evidence: `addon/DZTestbench/scripts/4_World/DZT_SuiteRegistry.c`)
- Suite runner → Suite base: runs suites (evidence: `addon/DZTestbench/scripts/4_World/DZT_Runner.c`)
- Suite runner → Assertions: creates assertions (evidence: `addon/DZTestbench/scripts/4_World/DZT_Runner.c`)
- Suite runner → Report model: creates and writes (evidence: `addon/DZTestbench/scripts/4_World/DZT_Runner.c`)
- Report model → JSON report: serializes (evidence: `addon/DZTestbench/scripts/4_World/DZT_Results.c`)
- Assertions → Case record: records cases
- Assertions → Report model: adds cases
- JSON report → Test runner script: read by (evidence: `README.md`)
- Test runner script → DayZ server: boots and scans (evidence: `README.md`)
- DayZ client → Tour driver: runs on connect (evidence: `addon/DZTour/scripts/5_Mission/DZT_Tour.c`)
- Tour driver → Checkpoints: sets up and advances (evidence: `addon/DZTour/scripts/5_Mission/DZT_Tour.c`)
- Tour driver → Screenshot capturer: signals by marker (evidence: `README.md`)
- Screenshot capturer → Checkpoint images: captures (evidence: `README.md`)
- Screenshot capturer → Tour driver: clears marker (evidence: `README.md`)
- Player → Placement action: triggers (evidence: `addon/DZPlace/scripts/4_World/DZ_Place.c`)
- Placement action → Placement log: appends coordinates (evidence: `addon/DZPlace/scripts/4_World/DZ_Place.c`)
- Placement action → Probe settings: uses paths and gate (evidence: `addon/DZPlace/scripts/4_World/DZ_Place.c`)
