# electronicarts/cnc_tiberian_dawn architecture

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

- Interactive diagram: https://gitdiagram.com/electronicarts/cnc_tiberian_dawn
- Repository: https://github.com/electronicarts/cnc_tiberian_dawn

## Overview

##### Project Type and Purpose
- This is a Win32 desktop game engine (classic real-time strategy) written in C/C++ with assembly stubs.
- The README confirms it’s the original Command & Conquer engine, extended for Steam Workshop support, relying on DirectX 5, GCL (networking), and SOS (audio HMI).

##### File Structure and Architectural Layers
Files and folders into these major layers:
- Core Engine Layer
– Graphics/rendering: DISPLAY.CPP/H, TEXTBLIT.H, GSCREEN.*, GAUGE.*, FLASHER.*
– Audio: AUDIO.CPP/H, SOUNDDLG.*, SOS stubs
– Input & UI: MOUSE.CPP, KEYFRAME.CPP, DIALOG.*, CONTROL.*, GADGET.*
– Memory & Resources: HEAP.*, RAWFILE.*, MIXFILE.*, BFILE.MAK, MAKEFILE
– Assembly support: *.ASM, e.g. COORDA.ASM, IPXPROT.ASM
- Game Logic Layer
– Units & Entities: INFANTRY.*, AIRCRAFT.*, TURRET.*, UNIT.CPP/H, OBJECT.*
– Map & Pathfinding: MAP.*, FINDPATH.CPP, TERRAIN.*, CELL.*
– Combat & Simulation: COMBAT.*, BULLET.*, DAMAGE in UNIT/OBJECT
– AI/Campaign: LOGIC.CPP/H, MISSION.*, SCENARIO.*, TRIGGER.*
- Networking Layer
– IPX: IPX.CPP/H, IPX95.*, IPXMGR.*, IPXCONN.*
– TCP/IP: TCPIP.*
– Abstract comm: CONNECT.*, CONNMGR.*, GCL stubs
- UI & Tools Layer
– Dialogs/config: CONFDLG.*, NETDLG.*, VISUDLG.*, OPTIONS.*
– Level editor: MAPEDIT.*, MAPEDDLG.*
– Utilities: TOOLS/MIXFILE.EXE
- External Dependencies & Build
– DirectX 5 SDK (graphics/audio)
– GCL for network transport
– SOS HMI library for audio management
– Watcom, TASM, MASM for build toolchain

##### README Insights
- Game engine core is missing; requires Red Alert engine libs.
- Build environment: Win32, Watcom C/C++, TASM, MASM.
- No modern layering (e.g., no client-server split)—it’s a monolithic, event-driven engine.

##### Defining Components & Relationships
a. Main Components
1) Presentation Layer (UI & Input)
2) Engine Core (Rendering, Audio, Resource Management)
3) Game Logic & Simulation
4) Networking Stack
5) External Libraries & Tools
b. Interactions
– Input subsystem → Game Logic → Rendering & Audio subsystems
– Game Logic ↔ Map & Pathfinding services
– Game Logic ↔ Networking → External network (other players)
– Resource Manager → Disk I/O → Data files (mix, raw)
– Rendering & Audio → DirectX 5 SDK
c. Architectural Patterns
– Layered architecture (UI → Logic → Engine → OS)
– Component-style entity modules for units, terrain, triggers
d. Key Technologies & Libraries
– DirectX 5 for graphics and sound
– GCL (Greenleaf Communications Library) for network messaging
– SOS (Sound Operating System) for advanced audio control
– Watcom/TASM/MASM compilers for legacy build

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Presentation Layer
    subgraph "Presentation Layer (UI & Input)"
        direction TB
        DialogControls["Dialog & Controls"]:::presentation
        StandardWidgets["Standard Widgets"]:::presentation
        InputHandling["Input Handling"]:::presentation
    end

    %% Core Engine Layer
    subgraph "Core Engine (Rendering, Audio, Resource Management)"
        direction TB
        Rendering["Rendering Modules"]:::core
        Audio["Audio Modules"]:::core
        ResourceIO["Resource I/O & Memory"]:::core
    end

    %% Game Logic & Simulation
    subgraph "Game Logic & Simulation"
        direction TB
        Entities["Units & Entities"]:::logic
        MapPath["Map & Pathfinding"]:::logic
        AICampaign["AI & Campaign"]:::logic
    end

    %% Networking Stack
    subgraph "Networking Stack"
        direction TB
        IPX["IPX Protocol"]:::network
        TCPIP["TCP/IP"]:::network
        AbstractComm["Abstract Communications"]:::network
    end

    %% UI & Tools Layer
    subgraph "UI & Tools Layer"
        direction TB
        ConfigDialogs["Configuration & Dialogs"]:::ui
        LevelEditor["Level Editor"]:::ui
        UtilityTools["Utility Tools"]:::ui
    end

    %% Build & External Dependencies
    subgraph "Build & External Dependencies"
        direction TB
        BuildScripts["Build Scripts & Makefiles"]:::external
        CompilerStubs["Compiler & Assembler Stubs"]:::external
        ResourceFiles["Resource Files"]:::external
    end

    %% Main Game Loop
    GameLoop["Main Game Loop"]:::core

    %% External Libraries
    DirectX["DirectX 5 SDK"]:::external
    GCL["GCL Networking Lib"]:::external
    SOS["SOS Audio Lib"]:::external

    %% Connections
    DialogControls -->|InputEvent| GameLoop
    InputHandling -->|InputEvent| GameLoop
    GameLoop -->|update| Entities
    GameLoop -->|simulate| AICampaign
    Entities -->|query| MapPath
    AICampaign -->|pathReq| MapPath
    GameLoop -->|render| Rendering
    GameLoop -->|soundCmd| Audio
    GameLoop -->|resourceReq| ResourceIO
    GameLoop -->|sendPacket| AbstractComm
    AbstractComm -->|asyncPacket| GameLoop
    AbstractComm -->|use| IPX
    AbstractComm -->|use| TCPIP
    Rendering -->|DXAPI| DirectX
    Audio -->|DXAudio| DirectX
    Audio -->|SOSAPI| SOS
    AbstractComm -->|GCLAPI| GCL
    UtilityTools -->|mixTool| ResourceIO
    ConfigDialogs -->|config| ResourceIO
    LevelEditor -->|mapFiles| ResourceIO
    BuildScripts -->|build| CompilerStubs
    CompilerStubs -->|assemble| ResourceIO

    %% Click Events
    click DialogControls "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/DIALOG.CPP"
    click StandardWidgets "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/CHECKBOX.CPP"
    click InputHandling "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/MOUSE.CPP"
    click Rendering "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/DISPLAY.CPP"
    click Audio "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/AUDIO.CPP"
    click ResourceIO "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/HEAP.CPP"
    click Entities "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/UNIT.CPP"
    click MapPath "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/MAP.CPP"
    click AICampaign "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/LOGIC.CPP"
    click IPX "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/IPX.CPP"
    click TCPIP "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/TCPIP.CPP"
    click AbstractComm "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/CONNECT.CPP"
    click ConfigDialogs "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/CONFDLG.CPP"
    click LevelEditor "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/MAPEDIT.CPP"
    click UtilityTools "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/MIXFILE.CPP"
    click BuildScripts "https://github.com/electronicarts/cnc_tiberian_dawn/tree/main/MAKEFILE"
    click CompilerStubs "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/COORDA.ASM"
    click ResourceFiles "https://github.com/electronicarts/cnc_tiberian_dawn/blob/main/CC_ICON.RC"

    %% Styles
    classDef presentation fill:#DDA0DD,stroke:#9932CC,color:#000
    classDef core fill:#ADD8E6,stroke:#0000CD,color:#000
    classDef logic fill:#98FB98,stroke:#008000,color:#000
    classDef network fill:#FFA500,stroke:#FF8C00,color:#000
    classDef ui fill:#FFFACD,stroke:#FFD700,color:#000
    classDef external fill:#D3D3D3,stroke:#A9A9A9,color:#000
```
