# mangoszero/server architecture

> Architecture diagram of the GitHub repository mangoszero/server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2024-12-29). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mangoszero/server
- Repository: https://github.com/mangoszero/server

## Overview

##### Main Components

**[Client] <---> [Authentication Server (realmd)] <---> [World Server (mangosd)]**

- v                                    v
- [Account Database] <------------------> [World Database]

- v
- [Character Database]

##### World Server Internal Architecture

a) Core Systems Layer:
- Game Systems (src/game/*)
- World Handlers
- Object Management
- System
- Movement System
- Combat System
- Spell System

b) Supporting Systems Layer:
- Authentication
- Database Interface
- Configuration
- Scripting Engine
- Network Layer

##### Detailed Component Relationships

**[Network Layer] --> [Session Management]**

- v
**[Packet Handlers] --> [World Update Loop]**

- v
- [Map System] <--> [Object Manager] <--> [Movement System]

- v                  v
**[Grid System] [Players/Creatures/GameObjects]**

##### Special Features

Unique components:
- Pathfinding (Recast/Detour)
- Script System (Eluna, SD3)
- Bot System
- SOAP Interface
- VMaps/MMaps Systems

##### Data Flow

Main data paths:
**[Client Request] --> [World Socket] --> [Packet Handler]**
- > [Game Logic] --> [Database] --> [Response]

##### Deployment View

- Required services (MySQL/MariaDB)
- External dependencies (ACE, OpenSSL)
- File systems (maps, vmaps, mmaps)

##### Multi-threaded nature of the server
- World update thread
- Update threads
- Database threads
- Network threads

##### Important subsystems
- Chat system
- /Guild system
- Combat system
- Spell system
- Movement/Pathfinding
- AI/Bot system

## Diagram (Mermaid)

```mermaid
graph TB
    subgraph Client
        WoWClient["World of Warcraft Client"]:::client
    end

    subgraph "Authentication Layer"
        AuthServer["Authentication Server\n(Handles login & session management)"]:::auth
        AuthDB[("Account Database\nStores user credentials\nAccount settings\nSecurity data")]:::database
        AuthSystem["Authentication System\nToken validation\nSession security\nEncryption handling"]:::auth
    end

    subgraph "World Server Layer"
        WorldServer["World Server Core\nMain game loop\nState management\nEvent processing"]:::core
        WorldDB[("World Database\nGame content\nNPCs\nQuests\nItems")]:::database
        CharDB[("Character Database\nPlayer data\nInventories\nAchievements\nStats")]:::database
    end

    subgraph "Core Systems"
        ObjectMgr["Object Management\nEntity lifecycle\nObject pools\nMemory management"]:::core
        MapSystem["Map System\nTerrain handling\nInstance management\nZone controls"]:::core
        MovementSys["Movement System\nPathfinding\nCollision detection\nSpeed handling"]:::core
        CombatSys["Combat System\nDamage calculation\nCombat logs\nPvP/PvE rules"]:::core
        SpellSys["Spell System\nSpell effects\nAura management\nCooldowns"]:::core
        
        ObjectMgr --> Players["Players\nCharacter data\nStats tracking"]:::core
        ObjectMgr --> Creatures["Creatures\nAI behaviors\nSpawn management"]:::core
        ObjectMgr --> GameObjects["GameObjects\nInteraction logic\nState tracking"]:::core
        
        MapSystem --> GridSystem["Grid System\nDynamic loading\nVisibility checks"]:::core
        MapSystem --> VMaps["VMaps\nHeight mapping\nLOS checks"]:::core
        MapSystem --> MMaps["MMaps\nNavigation mesh\nPathfinding data"]:::core
        
        MovementSys --> Pathfinding["Pathfinding (Recast/Detour)\nPath calculation\nObstacle avoidance"]:::core
        
        CombatSys --> DamageCalc["Damage Calculation\nFormulas\nModifiers"]:::core
        CombatSys --> CombatAI["Combat AI\nTarget selection\nTactic handling"]:::core
        
        SpellSys --> SpellEffects["Spell Effects\nDamage/Healing\nBuffs/Debuffs"]:::core
        SpellSys --> Auras["Aura System\nBuff stacking\nPeriodic effects"]:::core
    end

    subgraph "Supporting Systems"
        NetLayer["Network Layer\nPacket handling\nConnection management"]:::support
        DBInterface["Database Interface\nQuery handling\nConnection pooling"]:::support
        ConfigSys["Configuration System\nSettings management\nServer parameters"]:::support
        
        NetLayer --> PacketHandlers["Packet Handlers\nProtocol parsing\nData validation"]:::support
        NetLayer --> SessionMgmt["Session Management\nConnection tracking\nTimeout handling"]:::support
        
        DBInterface --> QueryHandler["Query Handler\nSQL processing\nCache management"]:::support
        DBInterface --> AsyncQueue["Async Queue\nBackground operations\nQuery batching"]:::support
        
        ScriptEngine["Script Engine\nCustom behaviors\nEvent handling"]:::support
        ScriptEngine --> Eluna["Eluna\nLua scripting\nAPI integration"]:::support
        ScriptEngine --> SD3["SD3\nC++ scripts\nCore modifications"]:::support
    end

    WoWClient <--> AuthServer
    WoWClient <--> WorldServer
    AuthServer <--> AuthDB
    AuthServer <--> AuthSystem
    AuthSystem <--> WorldServer
    WorldServer <--> WorldDB
    WorldServer <--> CharDB
    WorldServer <--> NetLayer
    WorldServer <--> DBInterface
    WorldServer <--> ConfigSys
    WorldServer <--> ScriptEngine
    WorldServer <--> ObjectMgr
    WorldServer <--> MapSystem
    WorldServer <--> MovementSys
    WorldServer <--> CombatSys
    WorldServer <--> SpellSys
    WorldDB <--> CharDB
    AuthDB <--> WorldDB

    click AuthServer "https://github.com/mangoszero/server/tree/master/src/realmd/"
    click WorldServer "https://github.com/mangoszero/server/tree/master/src/mangosd/"
    click ObjectMgr "https://github.com/mangoszero/server/tree/master/src/game/Object/"
    click MapSystem "https://github.com/mangoszero/server/tree/master/src/game/Maps/"
    click MovementSys "https://github.com/mangoszero/server/tree/master/src/game/movement/"
    click CombatSys "https://github.com/mangoszero/server/blob/master/src/game/WorldHandlers/CombatHandler.cpp"
    click SpellSys "https://github.com/mangoszero/server/blob/master/src/game/WorldHandlers/Spell.cpp"
    click NetLayer "https://github.com/mangoszero/server/blob/master/src/game/Server/WorldSocket.cpp"
    click DBInterface "https://github.com/mangoszero/server/tree/master/src/shared/Database/"
    click AuthSystem "https://github.com/mangoszero/server/tree/master/src/shared/Auth/"
    click ConfigSys "https://github.com/mangoszero/server/tree/master/src/shared/Config/"

    classDef client fill:#f9f,stroke:#333,stroke-width:2px
    classDef auth fill:#f96,stroke:#333,stroke-width:2px
    classDef core fill:#69f,stroke:#333,stroke-width:2px
    classDef support fill:#9f9,stroke:#333,stroke-width:2px
    classDef database fill:#ff9,stroke:#333,stroke-width:2px

    subgraph Legend
        Client1[Client]:::client
        Auth1[Authentication Components]:::auth
        Core1[Core Components]:::core
        Support1[Supporting Systems]:::support
        DB1[(Database)]:::database
    end
```
