How skyrim-multiplayer/skymp works
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: index.ts Server Runtime · clientListener.ts Client Services · JsEngine.cpp SkyrimPlatform · AsyncSaveStorage.h Async Save Storage
Components 22
Game Platform
- SkyrimPlatform
skyrim-platform/src/platform_se/skyrim_platform/JsEngine.cpp
Player Client
- Client Services
skymp5-client/src/services/services/clientListener.ts - Client Entrypoint
skymp5-client/src/index.ts - Client Networking
skymp5-client/src/services/services/networkingService.ts - Skill Menu Trigger
skymp5-client/src/services/services/sweetTaffySkillMenuService.ts
Multiplayer Server
- Server Runtime
skymp5-server/ts/index.ts - Server Systems
skymp5-server/ts/systems/system.ts - Login
skymp5-server/ts/systems/login.ts - Player Spawn
skymp5-server/ts/systems/spawn.ts - Master Service
skymp5-server/ts/systems/masterClient.ts - Native Server
skymp5-server/ts/scampNative.ts - Native Client
skymp5-server/cpp/client/main.cpp - ID Management
skymp5-server/cpp/mp_common/IdManager.cpp
Game Interface
- UI Application
skymp5-front/src/App.js - Chat UI
skymp5-front/src/constructorComponents/chat/index.js - Skills Menu
skymp5-front/src/features/skillsMenu/index.tsx
Runtime Libraries
- Game Data Records
libespm/src/Loader.cpp - Save Files
savefile/src/SFReader.cpp - Papyrus VM
papyrus-vm/src/papyrus-vm-lib/VirtualMachine.cpp - Async Save Storage
viet/include/save_storages/AsyncSaveStorage.h - Database Driver
viet/include/database_drivers/IDatabase.h
Other components
- Player
Connections 21
- Player → SkyrimPlatform: plays through
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
skymp5-server/ts/index.ts - Server Runtime → Server Systems: registers systems
skymp5-server/ts/index.ts - Server Runtime → Login: registers login
skymp5-server/ts/index.ts - Server Runtime → Player Spawn: registers spawn
skymp5-server/ts/index.ts - Server Runtime → Master Service: registers master
skymp5-server/ts/index.ts - Master Service → Server Systems: implements system
skymp5-server/ts/systems/masterClient.ts - Server Runtime → Native Client: dispatches messages
- Native Client → ID Management: uses IDs
- UI Application → Chat UI: renders chat
skymp5-front/src/App.js - UI Application → Skills Menu: renders menu
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
viet/include/save_storages/AsyncSaveStorage.h