# loanx/vanganthextender architecture

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

- Interactive diagram: https://gitdiagram.com/loanx/vanganthextender
- Repository: https://github.com/loanx/vanganthextender

## Overview

VanganthExtender is an Interlude game-server/client extension pack. Its principal client path receives custom network packets, dispatches opcode handlers, and can enqueue background jobs; server-side modules add gameplay and administration features through hooks. The tree also shows separate cached-server and NPC extensions plus a key-generation utility. The README gives no capability detail, and several server subsystems were not sampled, so their scope follows module names and their connections are omitted unless visible in excerpts.

Main entry points: [`CliExt/NetworkHandler.cpp`](https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/NetworkHandler.cpp) (Network handler), [`L2Ext/L2Ext.cpp`](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/L2Ext.cpp) (Server extension runtime), [`CachedExt/CachedExt/CachedExt.cpp`](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/CachedExt.cpp) (Cached extension), [`CachedExt/CachedExt/PacketHandler.cpp`](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/PacketHandler.cpp) (Game packets)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Client extension"]
  node_network["Network handler<br/>[NetworkHandler.cpp]"]
  node_packet["Packet codec<br/>[Packet.h]"]
  node_hwid["Hardware identity<br/>[HWID.h]"]
  node_client_jobs["Client jobs<br/>[JobHandler.cpp]"]
end

subgraph group_server["Game server"]
  node_server_ext["Server extension runtime<br/>[L2Ext.cpp]"]
  node_player_gameplay["Player gameplay<br/>[PlayerAction.cpp]"]
  node_class_manager["Class progression<br/>[ClassManager.cpp]"]
  node_html_cache["HTML cache<br/>[HTMLCacheManager.h]"]
  node_chat["Chat moderation<br/>[ChatManager.cpp]"]
  node_db[("Database access<br/>[DB.h]")]
  node_key_engine["License validation<br/>[KeyEngine.cpp]"]
end

subgraph group_npc["NPC server"]
  node_lottery["Lottery manager<br/>[LotteryManager.cpp]"]
  node_npc_runtime["NPC extension runtime<br/>[NpcExt.cpp]"]
end

subgraph group_cached["Cached server"]
  node_cached_runtime["Cached extension<br/>[CachedExt.cpp]"]
  node_admin_packets["Admin packets"]
  node_cached_packets["Game packets<br/>[PacketHandler.cpp]"]
  node_query["Query builder<br/>[Query.cpp]"]
end

node_client_actor(("Game client"))
node_server_actor(("Game server"))
node_npc_actor(("NPC server"))

node_client_actor -->|"sends packets"| node_network
node_network -->|"decodes packets"| node_packet
node_network -->|"reads identity"| node_hwid
node_network -->|"enqueues jobs"| node_client_jobs
node_server_actor -.->|"hosts extension"| node_server_ext
node_class_manager -->|"loads pages"| node_html_cache
node_server_ext -.->|"extends gameplay"| node_player_gameplay
node_server_ext -.->|"extends chat"| node_chat
node_server_ext -.->|"checks license"| node_key_engine
node_npc_actor -->|"lottery hooks"| node_lottery
node_npc_actor -.->|"hosts extension"| node_npc_runtime
node_cached_runtime -.->|"registers handlers"| node_admin_packets
node_cached_runtime -.->|"registers handlers"| node_cached_packets
node_cached_packets -.->|"uses queries"| node_query

click node_network "https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/NetworkHandler.cpp"
click node_packet "https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/Packet.h"
click node_hwid "https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/HWID.h"
click node_client_jobs "https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/JobHandler.cpp"
click node_server_ext "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/L2Ext.cpp"
click node_player_gameplay "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/PlayerAction.cpp"
click node_class_manager "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/ClassManager.cpp"
click node_html_cache "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/HTMLCacheManager.h"
click node_chat "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/ChatManager.cpp"
click node_db "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/DB.h"
click node_key_engine "https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/KeyEngine.cpp"
click node_lottery "https://github.com/loanx/vanganthextender/blob/Experimental/NpcExt/LotteryManager.cpp"
click node_npc_runtime "https://github.com/loanx/vanganthextender/blob/Experimental/NpcExt/NpcExt.cpp"
click node_cached_runtime "https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/CachedExt.cpp"
click node_admin_packets "https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/AdminPacketHandler.cpp"
click node_cached_packets "https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/PacketHandler.cpp"
click node_query "https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/Query.cpp"

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_network,node_packet,node_hwid,node_client_jobs,node_client_actor toneBlue
class node_server_ext,node_player_gameplay,node_class_manager,node_html_cache,node_chat,node_db,node_key_engine toneAmber
class node_lottery,node_npc_runtime,node_server_actor,node_npc_actor toneMint
class node_cached_runtime,node_admin_packets,node_cached_packets,node_query toneRose
```

## Components

### Client extension

- [Network handler](https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/NetworkHandler.cpp): `CliExt/NetworkHandler.cpp`
- [Packet codec](https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/Packet.h): `CliExt/Packet.h`
- [Hardware identity](https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/HWID.h): `CliExt/HWID.h`
- [Client jobs](https://github.com/loanx/vanganthextender/blob/Experimental/CliExt/JobHandler.cpp): `CliExt/JobHandler.cpp`

### Game server

- [Server extension runtime](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/L2Ext.cpp): `L2Ext/L2Ext.cpp`
- [Player gameplay](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/PlayerAction.cpp): `L2Ext/PlayerAction.cpp`
- [Class progression](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/ClassManager.cpp): `L2Ext/ClassManager.cpp`
- [HTML cache](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/HTMLCacheManager.h): `L2Ext/HTMLCacheManager.h`
- [Chat moderation](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/ChatManager.cpp): `L2Ext/ChatManager.cpp`
- [Database access](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/DB.h): `L2Ext/DB.h`
- [License validation](https://github.com/loanx/vanganthextender/blob/Experimental/L2Ext/KeyEngine.cpp): `L2Ext/KeyEngine.cpp`

### NPC server

- [Lottery manager](https://github.com/loanx/vanganthextender/blob/Experimental/NpcExt/LotteryManager.cpp): `NpcExt/LotteryManager.cpp`
- [NPC extension runtime](https://github.com/loanx/vanganthextender/blob/Experimental/NpcExt/NpcExt.cpp): `NpcExt/NpcExt.cpp`

### Cached server

- [Cached extension](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/CachedExt.cpp): `CachedExt/CachedExt/CachedExt.cpp`
- [Admin packets](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/AdminPacketHandler.cpp): `CachedExt/CachedExt/AdminPacketHandler.cpp`
- [Game packets](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/PacketHandler.cpp): `CachedExt/CachedExt/PacketHandler.cpp`
- [Query builder](https://github.com/loanx/vanganthextender/blob/Experimental/CachedExt/CachedExt/Query.cpp): `CachedExt/CachedExt/Query.cpp`

### Other components

- **Game client**
- **Game server**
- **NPC server**

## Connections

- Game client → Network handler: sends packets (evidence: `CliExt/NetworkHandler.cpp`)
- Network handler → Packet codec: decodes packets (evidence: `CliExt/NetworkHandler.cpp`)
- Network handler → Hardware identity: reads identity (evidence: `CliExt/NetworkHandler.cpp`)
- Network handler → Client jobs: enqueues jobs (evidence: `CliExt/NetworkHandler.cpp`)
- Game server → Server extension runtime: hosts extension
- Class progression → HTML cache: loads pages (evidence: `L2Ext/ClassManager.cpp`)
- Server extension runtime → Player gameplay: extends gameplay
- Server extension runtime → Chat moderation: extends chat
- Server extension runtime → License validation: checks license
- NPC server → Lottery manager: lottery hooks (evidence: `NpcExt/LotteryManager.cpp`)
- NPC server → NPC extension runtime: hosts extension
- Cached extension → Admin packets: registers handlers
- Cached extension → Game packets: registers handlers
- Game packets → Query builder: uses queries
