# skyrim-multiplayer/skymp architecture

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

- Interactive diagram: https://gitdiagram.com/skyrim-multiplayer/skymp
- Repository: https://github.com/skyrim-multiplayer/skymp

## Overview

SkyMP is a Skyrim multiplayer mod built on SkyrimPlatform. The principal workflow is a player using the in-game client to send multiplayer actions to a server, where server systems coordinate the session and synchronize results back to players. The repository also includes a browser-based UI, game-data and save-file handling, and a Papyrus virtual machine. The README establishes the product and platform relationship; source-index references and excerpts support the specific module links below. Some cross-runtime flow is therefore shown as unverified.

Main entry points: [`skymp5-server/ts/index.ts`](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/index.ts) (Server Runtime), [`skymp5-client/src/services/services/clientListener.ts`](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/clientListener.ts) (Client Services), [`skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp`](https://github.com/skyrim-multiplayer/skymp/blob/main/skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp) (SkyrimPlatform), [`viet/include/save_storages/AsyncSaveStorage.h`](https://github.com/skyrim-multiplayer/skymp/blob/main/viet/include/save_storages/AsyncSaveStorage.h) (Async Save Storage)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_platform["Game Platform"]
  node_skyrim["SkyrimPlatform<br/>[JsEngine.cpp]"]
end

subgraph group_client["Player Client"]
  node_client["Client Services<br/>[clientListener.ts]"]
  node_cliententry["Client Entrypoint<br/>[index.ts]"]
  node_networking["Client Networking"]
  node_sweetpie["Skill Menu Trigger"]
end

subgraph group_server["Multiplayer Server"]
  node_serverentry["Server Runtime<br/>[index.ts]"]
  node_serversystems["Server Systems<br/>[system.ts]"]
  node_login["Login<br/>[login.ts]"]
  node_spawn["Player Spawn<br/>[spawn.ts]"]
  node_master["Master Service<br/>[masterClient.ts]"]
  node_native["Native Server<br/>[scampNative.ts]"]
  node_cppclient["Native Client<br/>[main.cpp]"]
  node_ids["ID Management<br/>[IdManager.cpp]"]
end

subgraph group_ui["Game Interface"]
  node_frontend["UI Application<br/>[App.js]"]
  node_chat["Chat UI<br/>[index.js]"]
  node_skills["Skills Menu<br/>[index.tsx]"]
end

subgraph group_libraries["Runtime Libraries"]
  node_gameforms["Game Data Records<br/>[Loader.cpp]"]
  node_savefile["Save Files<br/>[SFReader.cpp]"]
  node_papyrus["Papyrus VM<br/>[VirtualMachine.cpp]"]
  node_saves[("Async Save Storage<br/>[AsyncSaveStorage.h]")]
  node_database[("Database Driver<br/>[IDatabase.h]")]
end

node_player(("Player"))

node_player -->|"plays through"| node_skyrim
node_skyrim -.->|"hosts client"| node_client
node_cliententry -.->|"starts services"| node_client
node_client -.->|"uses networking"| node_networking
node_client -.->|"sends actions"| node_serverentry
node_serverentry -->|"creates server"| node_native
node_serverentry -->|"registers systems"| node_serversystems
node_serverentry -->|"registers login"| node_login
node_serverentry -->|"registers spawn"| node_spawn
node_serverentry -->|"registers master"| node_master
node_master -->|"implements system"| node_serversystems
node_serverentry -.->|"dispatches messages"| node_cppclient
node_cppclient -.->|"uses IDs"| node_ids
node_frontend -->|"renders chat"| node_chat
node_frontend -->|"renders menu"| node_skills
node_sweetpie -.->|"opens menu"| node_skills
node_skyrim -.->|"runs scripts"| node_papyrus
node_serverentry -.->|"uses game data"| node_gameforms
node_serverentry -.->|"persists state"| node_saves
node_savefile -.->|"reads save data"| node_saves
node_saves -->|"delegates storage"| node_database

click node_skyrim "https://github.com/skyrim-multiplayer/skymp/blob/main/skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp"
click node_client "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/clientListener.ts"
click node_cliententry "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/index.ts"
click node_networking "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/networkingService.ts"
click node_sweetpie "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/sweetTaffySkillMenuService.ts"
click node_serverentry "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/index.ts"
click node_serversystems "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/system.ts"
click node_login "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/login.ts"
click node_spawn "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/spawn.ts"
click node_master "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/masterClient.ts"
click node_native "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/scampNative.ts"
click node_cppclient "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/cpp/client/main.cpp"
click node_ids "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/cpp/mp_common/IdManager.cpp"
click node_frontend "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/App.js"
click node_chat "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/constructorComponents/chat/index.js"
click node_skills "https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/features/skillsMenu/index.tsx"
click node_gameforms "https://github.com/skyrim-multiplayer/skymp/blob/main/libespm/src/Loader.cpp"
click node_savefile "https://github.com/skyrim-multiplayer/skymp/blob/main/savefile/src/SFReader.cpp"
click node_papyrus "https://github.com/skyrim-multiplayer/skymp/blob/main/papyrus-vm/src/papyrus-vm-lib/VirtualMachine.cpp"
click node_saves "https://github.com/skyrim-multiplayer/skymp/blob/main/viet/include/save_storages/AsyncSaveStorage.h"
click node_database "https://github.com/skyrim-multiplayer/skymp/blob/main/viet/include/database_drivers/IDatabase.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_skyrim toneBlue
class node_client,node_cliententry,node_networking,node_sweetpie toneAmber
class node_serverentry,node_serversystems,node_login,node_spawn,node_master,node_native,node_cppclient,node_ids toneMint
class node_frontend,node_chat,node_skills toneRose
class node_gameforms,node_savefile,node_papyrus,node_saves,node_database,node_player toneIndigo
```

## Components

### Game Platform

- [SkyrimPlatform](https://github.com/skyrim-multiplayer/skymp/blob/main/skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp): `skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp`

### Player Client

- [Client Services](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/clientListener.ts): `skymp5-client/src/services/services/clientListener.ts`
- [Client Entrypoint](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/index.ts): `skymp5-client/src/index.ts`
- [Client Networking](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/networkingService.ts): `skymp5-client/src/services/services/networkingService.ts`
- [Skill Menu Trigger](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-client/src/services/services/sweetTaffySkillMenuService.ts): `skymp5-client/src/services/services/sweetTaffySkillMenuService.ts`

### Multiplayer Server

- [Server Runtime](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/index.ts): `skymp5-server/ts/index.ts`
- [Server Systems](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/system.ts): `skymp5-server/ts/systems/system.ts`
- [Login](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/login.ts): `skymp5-server/ts/systems/login.ts`
- [Player Spawn](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/spawn.ts): `skymp5-server/ts/systems/spawn.ts`
- [Master Service](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/systems/masterClient.ts): `skymp5-server/ts/systems/masterClient.ts`
- [Native Server](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/ts/scampNative.ts): `skymp5-server/ts/scampNative.ts`
- [Native Client](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/cpp/client/main.cpp): `skymp5-server/cpp/client/main.cpp`
- [ID Management](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-server/cpp/mp_common/IdManager.cpp): `skymp5-server/cpp/mp_common/IdManager.cpp`

### Game Interface

- [UI Application](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/App.js): `skymp5-front/src/App.js`
- [Chat UI](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/constructorComponents/chat/index.js): `skymp5-front/src/constructorComponents/chat/index.js`
- [Skills Menu](https://github.com/skyrim-multiplayer/skymp/blob/main/skymp5-front/src/features/skillsMenu/index.tsx): `skymp5-front/src/features/skillsMenu/index.tsx`

### Runtime Libraries

- [Game Data Records](https://github.com/skyrim-multiplayer/skymp/blob/main/libespm/src/Loader.cpp): `libespm/src/Loader.cpp`
- [Save Files](https://github.com/skyrim-multiplayer/skymp/blob/main/savefile/src/SFReader.cpp): `savefile/src/SFReader.cpp`
- [Papyrus VM](https://github.com/skyrim-multiplayer/skymp/blob/main/papyrus-vm/src/papyrus-vm-lib/VirtualMachine.cpp): `papyrus-vm/src/papyrus-vm-lib/VirtualMachine.cpp`
- [Async Save Storage](https://github.com/skyrim-multiplayer/skymp/blob/main/viet/include/save_storages/AsyncSaveStorage.h): `viet/include/save_storages/AsyncSaveStorage.h`
- [Database Driver](https://github.com/skyrim-multiplayer/skymp/blob/main/viet/include/database_drivers/IDatabase.h): `viet/include/database_drivers/IDatabase.h`

### Other components

- **Player**

## Connections

- Player → SkyrimPlatform: plays through (evidence: `README.md`)
- SkyrimPlatform → Client Services: hosts client
- Client Entrypoint → Client Services: starts services
- Client Services → Client Networking: uses networking
- Client Services → Server Runtime: sends actions
- Server Runtime → Native Server: creates server (evidence: `skymp5-server/ts/index.ts`)
- Server Runtime → Server Systems: registers systems (evidence: `skymp5-server/ts/index.ts`)
- Server Runtime → Login: registers login (evidence: `skymp5-server/ts/index.ts`)
- Server Runtime → Player Spawn: registers spawn (evidence: `skymp5-server/ts/index.ts`)
- Server Runtime → Master Service: registers master (evidence: `skymp5-server/ts/index.ts`)
- Master Service → Server Systems: implements system (evidence: `skymp5-server/ts/systems/masterClient.ts`)
- Server Runtime → Native Client: dispatches messages
- Native Client → ID Management: uses IDs
- UI Application → Chat UI: renders chat (evidence: `skymp5-front/src/App.js`)
- UI Application → Skills Menu: renders menu (evidence: `skymp5-front/src/App.js`)
- Skill Menu Trigger → Skills Menu: opens menu
- SkyrimPlatform → Papyrus VM: runs scripts
- Server Runtime → Game Data Records: uses game data
- Server Runtime → Async Save Storage: persists state
- Save Files → Async Save Storage: reads save data
- Async Save Storage → Database Driver: delegates storage (evidence: `viet/include/save_storages/AsyncSaveStorage.h`)
