# byraizo/dev-dayz-launcher architecture

> Architecture diagram of the GitHub repository byraizo/dev-dayz-launcher, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-06). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/byraizo/dev-dayz-launcher
- Repository: https://github.com/byraizo/dev-dayz-launcher

## Overview

##### Project type and purpose
- This is a Visual Studio Code extension written in TypeScript (“Dev DayZ Launcher”) that provides a custom UI panel and commands to start/stop a DayZ server and client via the external dev-server-scripts tool.

##### File structure
- Top-level:
- .github/workflows/publish.yml – CI/CD to publish the extension
- package.json / package-lock.json – extension metadata, dependencies, VSCode “contributes”
- tsconfig.json – TypeScript compiler configuration
- src/extension.ts – extension entry point implementing VSCode Activation and command registration
- out/extension.js(.map) – transpiled JS output consumed by VSCode at runtime
- images/ – screenshots for README
- No separate frontend folder; the UI is built using VSCode’s Extension API (TreeView or Webview).

##### README for additional insights
- The extension relies on an external CLI library (dev-server-scripts) to actually launch/stop DayZ processes.
- Users must configure the paths to dev-server-scripts’ executables and a config.json file.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% VSCode Environment
    subgraph "VSCode IDE"
        direction TB
        VSEditor["VSCode Editor"]:::vscode
        ExtHost["Extension Host (Node.js)"]:::vscode
    end

    VSEditor -->|"activate onCommand"| ExtHost
    ExtHost -->|"load extension"| DevExt

    %% Extension Runtime
    DevExt["Dev DayZ Launcher Extension\n(out/extension.js)"]:::vscode
    click DevExt "https://github.com/byraizo/dev-dayz-launcher/blob/main/out/extension.js"

    %% External CLI and Processes
    CLI["dev-server-scripts CLI"]:::cli
    Config["config.json"]:::artifact
    ServerProc["DayZ Server Process"]:::process
    ClientProc["DayZ Client Process"]:::process

    DevExt -->|"spawn('start-server') / spawn('start-client')"| CLI
    DevExt -->|"readConfig()"| Config
    CLI -->|"reads config.json"| Config
    CLI -->|"launches"| ServerProc
    CLI -->|"launches"| ClientProc
    ServerProc -->|"stdout/stderr"| DevExt
    DevExt -->|"logs"| VSEditor

    %% Project Files
    subgraph "Project Files"
        direction TB
        Metadata["package.json"]:::vscode
        click Metadata "https://github.com/byraizo/dev-dayz-launcher/blob/main/package.json"
        TSConfig["tsconfig.json"]:::vscode
        click TSConfig "https://github.com/byraizo/dev-dayz-launcher/blob/main/tsconfig.json"
        CI[".github/workflows/publish.yml"]:::vscode
        click CI "https://github.com/byraizo/dev-dayz-launcher/blob/main/.github/workflows/publish.yml"
        Readme["README.md"]:::vscode
        click Readme "https://github.com/byraizo/dev-dayz-launcher/blob/main/README.md"
        Images["images/"]:::vscode
        click Images "https://github.com/byraizo/dev-dayz-launcher/tree/main/images/"
        Runtime["out/extension.js"]:::vscode
        click Runtime "https://github.com/byraizo/dev-dayz-launcher/blob/main/out/extension.js"
        Maps["out/extension.js.map"]:::vscode
        click Maps "https://github.com/byraizo/dev-dayz-launcher/blob/main/out/extension.js.map"
        Lock["package-lock.json"]:::vscode
        click Lock "https://github.com/byraizo/dev-dayz-launcher/blob/main/package-lock.json"
        GitIgnore[".gitignore"]:::vscode
        click GitIgnore "https://github.com/byraizo/dev-dayz-launcher/blob/main/.gitignore"
        License["LICENSE"]:::vscode
        click License "https://github.com/byraizo/dev-dayz-launcher/tree/main/LICENSE"
    end

    %% Styles
    classDef vscode fill:#cfe2f3,stroke:#6ea8fe,color:#000;
    classDef cli fill:#d9ead3,stroke:#6aa84f,color:#000;
    classDef process fill:#fce5cd,stroke:#e69138,color:#000;
    classDef artifact fill:#f3f3f3,stroke-dasharray: 5 5,stroke:#999,color:#000;
```
