# mrantares/robrowserlegacy architecture

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

- Interactive diagram: https://gitdiagram.com/mrantares/robrowserlegacy
- Repository: https://github.com/mrantares/robrowserlegacy

## Overview

ROBrowser Legacy is a browser-based Ragnarok Online client. A player starts the client, loads game assets locally or from a remote client, connects through a WebSocket proxy to a game server, and uses the client’s login, character, and map experiences. The map experience combines packet-driven game state, domain data, rendering, audio, controls, and UI. The repository also includes asset and graphics viewers, plugins, and desktop/PWA entry points. The graph preserves these documented capabilities; several internal connections are dashed because the available excerpts do not verify their call paths.

Main entry points: [`src/Engine/MapEngine.js`](https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/MapEngine.js) (Map gameplay), [`src/main.js`](https://github.com/mrantares/robrowserlegacy/blob/master/src/main.js) (Client entry), [`src/Network/NetworkManager.js`](https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/NetworkManager.js) (Packet networking), [`src/Core/FileManager.js`](https://github.com/mrantares/robrowserlegacy/blob/master/src/Core/FileManager.js) (Asset loading)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_application["Client applications"]
  node_webapp["Client entry<br/>[main.js]"]
  node_pwa["PWA setup<br/>[Config.js]"]
  node_electron["Desktop shell<br/>[main.js]"]
  node_viewers["Asset viewers<br/>[GrfViewer.js]"]
  node_mapviewer["Map viewer<br/>[MapViewer.js]"]
  node_modelviewer["Model viewer<br/>[ModelViewer.js]"]
  node_effectviewer["Effect viewer<br/>[EffectViewer.js]"]
  node_strviewer["STR viewer<br/>[StrViewer.js]"]
  node_grannyviewer["Granny viewer"]
end

subgraph group_gameplay["Gameplay runtime"]
  node_login["Login flow<br/>[LoginEngine.js]"]
  node_character["Character flow<br/>[CharEngine.js]"]
  node_mapengine["Map gameplay<br/>[MapEngine.js]"]
  node_mapmodules["Map features"]
  node_storageengine["Storage protocol<br/>[Storage.js]"]
  node_plugins["Plugin manager<br/>[PluginManager.js]"]
end

subgraph group_content["Game content"]
  node_assets["Asset loading<br/>[FileManager.js]"]
  node_database["Game data<br/>[DBManager.js]"]
end

subgraph group_presentation["Presentation"]
  node_renderer["WebGL renderer<br/>[Renderer.js]"]
  node_entityrender["Entity rendering<br/>[EntityManager.js]"]
  node_effects["Effects<br/>[EffectManager.js]"]
  node_ui["Game interface<br/>[UIManager.js]"]
  node_storageui["Storage window<br/>[StorageCommon.js]"]
  node_controls["Input controls<br/>[KeyEventHandler.js]"]
  node_audio["Audio<br/>[SoundManager.js]"]
end

subgraph group_integration["External integration"]
  node_network["Packet networking<br/>[NetworkManager.js]"]
  node_protocol["Protocol versions"]
  node_packetdefs["Packet definitions<br/>[PacketRegister.js]"]
end

node_player(("Player"))
node_proxy["WebSocket proxy"]
node_gameserver["Game server"]
node_assetfiles["Game assets"]
node_remoteclient["Remote client"]

node_player -->|"starts"| node_webapp
node_player -->|"loads locally"| node_assetfiles
node_webapp -.->|"loads assets"| node_assets
node_assets -.->|"reads assets"| node_assetfiles
node_assets -->|"requests assets"| node_remoteclient
node_webapp -.->|"starts session"| node_login
node_login -.->|"continues to"| node_character
node_character -.->|"enters gameplay"| node_mapengine
node_mapengine -->|"dispatches features"| node_mapmodules
node_mapengine -.->|"exchanges packets"| node_network
node_network -->|"uses WebSockets"| node_proxy
node_proxy -->|"translates TCP"| node_gameserver
node_network -->|"selects protocol"| node_protocol
node_network -->|"registers packets"| node_packetdefs
node_mapengine -.->|"uses game data"| node_database
node_mapengine -.->|"updates scene"| node_renderer
node_renderer -.->|"renders entities"| node_entityrender
node_renderer -.->|"renders effects"| node_effects
node_mapengine -.->|"opens interface"| node_ui
node_storageengine -.->|"updates storage"| node_storageui
node_controls -.->|"sends actions"| node_mapengine
node_mapengine -.->|"triggers audio"| node_audio
node_player -.->|"uses PWA"| node_pwa
node_player -.->|"uses desktop app"| node_electron
node_webapp -.->|"loads plugins"| node_plugins
node_player -.->|"opens GRF viewer"| node_viewers
node_player -.->|"opens map viewer"| node_mapviewer
node_player -.->|"opens model viewer"| node_modelviewer
node_player -.->|"opens effect viewer"| node_effectviewer
node_player -.->|"opens STR viewer"| node_strviewer
node_player -.->|"opens Granny viewer"| node_grannyviewer

click node_webapp "https://github.com/mrantares/robrowserlegacy/blob/master/src/main.js"
click node_pwa "https://github.com/mrantares/robrowserlegacy/blob/master/applications/pwa/Config.js"
click node_electron "https://github.com/mrantares/robrowserlegacy/blob/master/applications/electron/main.js"
click node_login "https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/LoginEngine.js"
click node_character "https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/CharEngine.js"
click node_mapengine "https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/MapEngine.js"
click node_mapmodules "https://github.com/mrantares/robrowserlegacy/tree/master/src/Engine/MapEngine"
click node_network "https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/NetworkManager.js"
click node_protocol "https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/PacketVerManager.js"
click node_packetdefs "https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/PacketRegister.js"
click node_assets "https://github.com/mrantares/robrowserlegacy/blob/master/src/Core/FileManager.js"
click node_database "https://github.com/mrantares/robrowserlegacy/blob/master/src/DB/DBManager.js"
click node_renderer "https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/Renderer.js"
click node_entityrender "https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/EntityManager.js"
click node_effects "https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/EffectManager.js"
click node_ui "https://github.com/mrantares/robrowserlegacy/blob/master/src/UI/UIManager.js"
click node_storageui "https://github.com/mrantares/robrowserlegacy/blob/master/src/UI/Components/Storage/StorageCommon.js"
click node_storageengine "https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/MapEngine/Storage.js"
click node_controls "https://github.com/mrantares/robrowserlegacy/blob/master/src/Controls/KeyEventHandler.js"
click node_audio "https://github.com/mrantares/robrowserlegacy/blob/master/src/Audio/SoundManager.js"
click node_plugins "https://github.com/mrantares/robrowserlegacy/blob/master/src/Plugins/PluginManager.js"
click node_viewers "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/GrfViewer.js"
click node_mapviewer "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/MapViewer.js"
click node_modelviewer "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/ModelViewer.js"
click node_effectviewer "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/EffectViewer.js"
click node_strviewer "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/StrViewer.js"
click node_grannyviewer "https://github.com/mrantares/robrowserlegacy/blob/master/src/App/GrannyModelViewer.js"

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_webapp,node_pwa,node_electron,node_viewers,node_mapviewer,node_modelviewer,node_effectviewer,node_strviewer,node_grannyviewer,node_remoteclient toneBlue
class node_login,node_character,node_mapengine,node_mapmodules,node_storageengine,node_plugins toneAmber
class node_assets,node_database,node_gameserver toneMint
class node_renderer,node_entityrender,node_effects,node_ui,node_storageui,node_controls,node_audio toneRose
class node_network,node_protocol,node_packetdefs,node_player,node_proxy,node_assetfiles toneIndigo
```

## Components

### Client applications

- [Client entry](https://github.com/mrantares/robrowserlegacy/blob/master/src/main.js): `src/main.js`
- [PWA setup](https://github.com/mrantares/robrowserlegacy/blob/master/applications/pwa/Config.js): `applications/pwa/Config.js`
- [Desktop shell](https://github.com/mrantares/robrowserlegacy/blob/master/applications/electron/main.js): `applications/electron/main.js`
- [Asset viewers](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/GrfViewer.js): `src/App/GrfViewer.js`
- [Map viewer](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/MapViewer.js): `src/App/MapViewer.js`
- [Model viewer](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/ModelViewer.js): `src/App/ModelViewer.js`
- [Effect viewer](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/EffectViewer.js): `src/App/EffectViewer.js`
- [STR viewer](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/StrViewer.js): `src/App/StrViewer.js`
- [Granny viewer](https://github.com/mrantares/robrowserlegacy/blob/master/src/App/GrannyModelViewer.js): `src/App/GrannyModelViewer.js`

### Gameplay runtime

- [Login flow](https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/LoginEngine.js): `src/Engine/LoginEngine.js`
- [Character flow](https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/CharEngine.js): `src/Engine/CharEngine.js`
- [Map gameplay](https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/MapEngine.js): `src/Engine/MapEngine.js`
- [Map features](https://github.com/mrantares/robrowserlegacy/tree/master/src/Engine/MapEngine): `src/Engine/MapEngine`
- [Storage protocol](https://github.com/mrantares/robrowserlegacy/blob/master/src/Engine/MapEngine/Storage.js): `src/Engine/MapEngine/Storage.js`
- [Plugin manager](https://github.com/mrantares/robrowserlegacy/blob/master/src/Plugins/PluginManager.js): `src/Plugins/PluginManager.js`

### Game content

- [Asset loading](https://github.com/mrantares/robrowserlegacy/blob/master/src/Core/FileManager.js): `src/Core/FileManager.js`
- [Game data](https://github.com/mrantares/robrowserlegacy/blob/master/src/DB/DBManager.js): `src/DB/DBManager.js`

### Presentation

- [WebGL renderer](https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/Renderer.js): `src/Renderer/Renderer.js`
- [Entity rendering](https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/EntityManager.js): `src/Renderer/EntityManager.js`
- [Effects](https://github.com/mrantares/robrowserlegacy/blob/master/src/Renderer/EffectManager.js): `src/Renderer/EffectManager.js`
- [Game interface](https://github.com/mrantares/robrowserlegacy/blob/master/src/UI/UIManager.js): `src/UI/UIManager.js`
- [Storage window](https://github.com/mrantares/robrowserlegacy/blob/master/src/UI/Components/Storage/StorageCommon.js): `src/UI/Components/Storage/StorageCommon.js`
- [Input controls](https://github.com/mrantares/robrowserlegacy/blob/master/src/Controls/KeyEventHandler.js): `src/Controls/KeyEventHandler.js`
- [Audio](https://github.com/mrantares/robrowserlegacy/blob/master/src/Audio/SoundManager.js): `src/Audio/SoundManager.js`

### External integration

- [Packet networking](https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/NetworkManager.js): `src/Network/NetworkManager.js`
- [Protocol versions](https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/PacketVerManager.js): `src/Network/PacketVerManager.js`
- [Packet definitions](https://github.com/mrantares/robrowserlegacy/blob/master/src/Network/PacketRegister.js): `src/Network/PacketRegister.js`

### Other components

- **Player**
- **WebSocket proxy**
- **Game server**
- **Game assets**
- **Remote client**

## Connections

- Player → Client entry: starts
- Player → Game assets: loads locally
- Client entry → Asset loading: loads assets
- Asset loading → Game assets: reads assets
- Asset loading → Remote client: requests assets
- Client entry → Login flow: starts session
- Login flow → Character flow: continues to
- Character flow → Map gameplay: enters gameplay
- Map gameplay → Map features: dispatches features (evidence: `src/Engine/MapEngine.js`)
- Map gameplay → Packet networking: exchanges packets
- Packet networking → WebSocket proxy: uses WebSockets
- WebSocket proxy → Game server: translates TCP
- Packet networking → Protocol versions: selects protocol (evidence: `src/Network/NetworkManager.js`)
- Packet networking → Packet definitions: registers packets (evidence: `src/Network/NetworkManager.js`)
- Map gameplay → Game data: uses game data
- Map gameplay → WebGL renderer: updates scene
- WebGL renderer → Entity rendering: renders entities
- WebGL renderer → Effects: renders effects
- Map gameplay → Game interface: opens interface
- Storage protocol → Storage window: updates storage
- Input controls → Map gameplay: sends actions
- Map gameplay → Audio: triggers audio
- Player → PWA setup: uses PWA
- Player → Desktop shell: uses desktop app
- Client entry → Plugin manager: loads plugins
- Player → Asset viewers: opens GRF viewer
- Player → Map viewer: opens map viewer
- Player → Model viewer: opens model viewer
- Player → Effect viewer: opens effect viewer
- Player → STR viewer: opens STR viewer
- Player → Granny viewer: opens Granny viewer
