# emanuelcatania/mu-linux architecture

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

- Interactive diagram: https://gitdiagram.com/emanuelcatania/mu-linux
- Repository: https://github.com/emanuelcatania/mu-linux

## Overview

Mu Linux 97K is a Mu Online client/server system with a web panel and optional data editor. The main player workflow runs from client startup and content synchronization through server connection and game simulation to client presentation; the server also persists account and game data. The README documents encrypted networking, shared content/catalog updates, server authority, and web map editing. Source excerpts confirm selected networking, database, audio, and skill behavior; links involving unsampled modules are omitted or marked unverified.

Main entry points: [`web/server.js`](https://github.com/emanuelcatania/mu-linux/blob/main/web/server.js) (Web Panel), [`server/Source/MuServer/GameServer/SkillManager.cpp`](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/GameServer/SkillManager.cpp) (Game Simulation), [`server/Source/MuServer/Common/QueryManager.cpp`](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/Common/QueryManager.cpp) (Query Manager), [`client/src/platform/ClientEntry.cpp`](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/platform/ClientEntry.cpp) (Client Startup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Game Client"]
  node_entry["Client Startup<br/>[ClientEntry.cpp]"]
  node_content["Content Sync<br/>[ContentSync.cpp]"]
  node_clientnet["Client Networking<br/>[NetChannel.cpp]"]
  node_scenes["Scene Flow<br/>[Scene_Dispatch.cpp]"]
  node_simulation["Game Simulation<br/>[Game_MainLoop.cpp]"]
  node_world["World and Entities<br/>[MapManager.cpp]"]
  node_presentation["Rendering and UI<br/>[Render_Frame.cpp]"]
  node_audio["Audio Playback<br/>[SoundManager.cpp]"]
end

subgraph group_server["Game Server"]
  node_connect["Connect Server<br/>[SocketManager.cpp]"]
  node_accounts["Account Service<br/>[AccountManager.cpp]"]
  node_gameserver["Game Simulation<br/>[SkillManager.cpp]"]
  node_guilds["Guild Data<br/>[GuildManager.cpp]"]
  node_contentcatalog["Client Content"]
end

subgraph group_web["Web Panel"]
  node_webpanel["Web Panel<br/>[server.js]"]
  node_mapeditor["Map Editor"]
end

subgraph group_data["Data Editing"]
  node_dataeditor["Data Editor<br/>[server.js]"]
end

subgraph group_infra["Platform Services"]
  node_queries["Query Manager<br/>[QueryManager.cpp]"]
  node_database[("MySQL Database")]
  node_audioengine["Audio Engine<br/>[miniaudio.h]"]
end

node_player(("Player"))
node_webuser(("Web Administrator"))

node_player -->|"starts"| node_entry
node_entry -.->|"checks content"| node_content
node_content -->|"compares and downloads"| node_contentcatalog
node_entry -.->|"dispatches scenes"| node_scenes
node_scenes -.->|"connects"| node_clientnet
node_clientnet -->|"encrypted traffic"| node_connect
node_connect -.->|"routes login"| node_accounts
node_clientnet -.->|"game packets"| node_gameserver
node_gameserver -.->|"persists data"| node_queries
node_accounts -->|"queries accounts"| node_queries
node_guilds -->|"queries guilds"| node_queries
node_queries -->|"connects and queries"| node_database
node_gameserver -->|"resolves skills"| node_gameserver
node_simulation -.->|"updates world"| node_world
node_simulation -.->|"renders frame"| node_presentation
node_world -->|"selects map music"| node_audio
node_audio -->|"plays streams"| node_audioengine
node_webuser -->|"administers"| node_webpanel
node_webpanel -->|"serves editor"| node_mapeditor
node_mapeditor -.->|"requests map data"| node_webpanel
node_webpanel -->|"forwards editor requests"| node_dataeditor
node_webpanel -->|"reads account and ranking data"| node_database

click node_entry "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/platform/ClientEntry.cpp"
click node_content "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/net/ContentSync.cpp"
click node_clientnet "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/net/NetChannel.cpp"
click node_scenes "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/scenes/Scene_Dispatch.cpp"
click node_simulation "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/game/core/Game_MainLoop.cpp"
click node_world "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/game/core/MapManager.cpp"
click node_presentation "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/render/Render_Frame.cpp"
click node_audio "https://github.com/emanuelcatania/mu-linux/blob/main/client/src/audio/SoundManager.cpp"
click node_connect "https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/ConnectServer/SocketManager.cpp"
click node_accounts "https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/JoinServer/AccountManager.cpp"
click node_gameserver "https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/GameServer/SkillManager.cpp"
click node_guilds "https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/DataServer/GuildManager.cpp"
click node_queries "https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/Common/QueryManager.cpp"
click node_webpanel "https://github.com/emanuelcatania/mu-linux/blob/main/web/server.js"
click node_mapeditor "https://github.com/emanuelcatania/mu-linux/blob/main/web/public/js/mapmanager-editor.js"
click node_contentcatalog "https://github.com/emanuelcatania/mu-linux/tree/main/server/Source/MuServer/Common"
click node_dataeditor "https://github.com/emanuelcatania/mu-linux/blob/main/editor/server.js"
click node_audioengine "https://github.com/emanuelcatania/mu-linux/blob/main/client/lib/miniaudio/miniaudio.h"

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_entry,node_content,node_clientnet,node_scenes,node_simulation,node_world,node_presentation,node_audio toneBlue
class node_connect,node_accounts,node_gameserver,node_guilds,node_contentcatalog toneAmber
class node_webpanel,node_mapeditor toneMint
class node_dataeditor toneRose
class node_queries,node_database,node_audioengine,node_player,node_webuser toneIndigo
```

## Components

### Game Client

- [Client Startup](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/platform/ClientEntry.cpp): `client/src/platform/ClientEntry.cpp`
- [Content Sync](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/net/ContentSync.cpp): `client/src/net/ContentSync.cpp`
- [Client Networking](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/net/NetChannel.cpp): `client/src/net/NetChannel.cpp`
- [Scene Flow](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/scenes/Scene_Dispatch.cpp): `client/src/scenes/Scene_Dispatch.cpp`
- [Game Simulation](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/game/core/Game_MainLoop.cpp): `client/src/game/core/Game_MainLoop.cpp`
- [World and Entities](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/game/core/MapManager.cpp): `client/src/game/core/MapManager.cpp`
- [Rendering and UI](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/render/Render_Frame.cpp): `client/src/render/Render_Frame.cpp`
- [Audio Playback](https://github.com/emanuelcatania/mu-linux/blob/main/client/src/audio/SoundManager.cpp): `client/src/audio/SoundManager.cpp`

### Game Server

- [Connect Server](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/ConnectServer/SocketManager.cpp): `server/Source/MuServer/ConnectServer/SocketManager.cpp`
- [Account Service](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/JoinServer/AccountManager.cpp): `server/Source/MuServer/JoinServer/AccountManager.cpp`
- [Game Simulation](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/GameServer/SkillManager.cpp): `server/Source/MuServer/GameServer/SkillManager.cpp`
- [Guild Data](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/DataServer/GuildManager.cpp): `server/Source/MuServer/DataServer/GuildManager.cpp`
- [Client Content](https://github.com/emanuelcatania/mu-linux/tree/main/server/Source/MuServer/Common): `server/Source/MuServer/Common`

### Web Panel

- [Web Panel](https://github.com/emanuelcatania/mu-linux/blob/main/web/server.js): `web/server.js`
- [Map Editor](https://github.com/emanuelcatania/mu-linux/blob/main/web/public/js/mapmanager-editor.js): `web/public/js/mapmanager-editor.js`

### Data Editing

- [Data Editor](https://github.com/emanuelcatania/mu-linux/blob/main/editor/server.js): `editor/server.js`

### Platform Services

- [Query Manager](https://github.com/emanuelcatania/mu-linux/blob/main/server/Source/MuServer/Common/QueryManager.cpp): `server/Source/MuServer/Common/QueryManager.cpp`
- **MySQL Database**
- [Audio Engine](https://github.com/emanuelcatania/mu-linux/blob/main/client/lib/miniaudio/miniaudio.h): `client/lib/miniaudio/miniaudio.h`

### Other components

- **Player**
- **Web Administrator**

## Connections

- Player → Client Startup: starts (evidence: `client/src/platform/ClientEntry.cpp`)
- Client Startup → Content Sync: checks content
- Content Sync → Client Content: compares and downloads
- Client Startup → Scene Flow: dispatches scenes
- Scene Flow → Client Networking: connects
- Client Networking → Connect Server: encrypted traffic
- Connect Server → Account Service: routes login
- Client Networking → Game Simulation: game packets
- Game Simulation → Query Manager: persists data
- Account Service → Query Manager: queries accounts (evidence: `server/Source/MuServer/JoinServer/AccountManager.cpp`)
- Guild Data → Query Manager: queries guilds (evidence: `server/Source/MuServer/DataServer/GuildManager.cpp`)
- Query Manager → MySQL Database: connects and queries (evidence: `server/Source/MuServer/Common/QueryManager.cpp`)
- Game Simulation → Game Simulation: resolves skills (evidence: `server/Source/MuServer/GameServer/SkillManager.cpp`)
- Game Simulation → World and Entities: updates world
- Game Simulation → Rendering and UI: renders frame
- World and Entities → Audio Playback: selects map music
- Audio Playback → Audio Engine: plays streams (evidence: `client/src/audio/SoundManager.cpp`)
- Web Administrator → Web Panel: administers
- Web Panel → Map Editor: serves editor (evidence: `web/server.js`)
- Map Editor → Web Panel: requests map data
- Web Panel → Data Editor: forwards editor requests (evidence: `web/server.js`)
- Web Panel → MySQL Database: reads account and ranking data (evidence: `web/server.js`)
