# black-tek/blacktek-server architecture

> Architecture diagram of the GitHub repository black-tek/blacktek-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-01-11). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/black-tek/blacktek-server
- Repository: https://github.com/black-tek/blacktek-server

## Overview

##### Main Components Identification

The system should be divided into these major components:

a) Core Server Components:
- Network Layer (protocols, connections, messages)
- Game Engine (game logic, combat, movement)
- Script Engine (Lua scripting system)
- Database Layer (MySQL integration)

b) Game Logic Components:
- Player Management
- Monster/NPC Systems
- Combat System
- Item/Inventory System
- /World Management
- Quest/Event System

**[Client Layer]**
- ↕
**[Network Layer]**
- Protocol Handlers
- Connection Management
- ↕
**[Game Engine Layer]**
- Game Logic
- Combat System
- Movement System
- Event System
- ↕
**[Script Engine Layer]**
- Lua Script Interface
- Event Handlers
- ↕
**[Data Layer]**
- Database Management
- File System (XML/JSON)

##### Component Relationships

Key interactions:
- Protocol flow between client and server
- Data flow between game engine and database
- Script engine integration points
- Event system connections

##### Specific Implementation Details

Project-specific elements:
- Lua scripting system integration
- XML-based configuration system
- Monster/NPC AI systems
- Combat and spell systems
- And world management

##### External Dependencies

Integrations:
- MySQL database
- Lua scripting engine
- XML parsing libraries
- Network libraries

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph "Network Layer"
        CL[Game Client]
        NP["Protocol Handlers"]:::network
        NC["Connection Management"]:::network
    end

    subgraph "Core Layer"
        GE["Game Engine Core"]:::engine
        ES["Event System"]:::engine
    end

    subgraph "Game Systems"
        PM["Player Management"]:::logic
        MN["Monster/NPC System"]:::logic
        CS["Combat System"]:::logic
        MS["Movement System"]:::engine
        IS["Item System"]:::logic
        WM["World Manager"]:::logic
        QS["Quest System"]:::logic
    end

    subgraph "Script Engine"
        SE["Lua Interface"]:::script
        SC["Script Content"]:::script
    end

    subgraph "Data Storage"
        DB["MySQL"]:::data
        FS["File System"]:::data
        XML["XML Config"]:::data
    end

    %% Optimized Connections
    CL --> NP --> NC --> GE
    GE --> ES
    
    ES --> PM & MN & CS & MS & IS & WM & QS
    
    GE <--> SE
    SE --> SC
    
    GE --> DB & FS & XML

    %% Click events
    click NP "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/protocol.cpp"
    click GE "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/game.cpp"
    click SE "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/luascript.cpp"
    click DB "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/database.cpp"
    click PM "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/player.cpp"
    click MN "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/monster.cpp"
    click CS "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/combat.cpp"
    click IS "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/item.cpp"
    click WM "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/map.cpp"
    click QS "https://github.com/Black-Tek/BlackTek-Server/blob/master/src/quests.cpp"
    click SC "https://github.com/Black-Tek/BlackTek-Server/tree/master/data/scripts/"
    click XML "https://github.com/Black-Tek/BlackTek-Server/tree/master/data/XML/"

    %% Styles
    classDef network fill:#1E88E5,color:white
    classDef engine fill:#004D40,color:white
    classDef logic fill:#2E7D32,color:white
    classDef script fill:#FDD835,color:black
    classDef data fill:#6D4C41,color:white
```
