# otland/forgottenserver architecture

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

- Interactive diagram: https://gitdiagram.com/otland/forgottenserver
- Repository: https://github.com/otland/forgottenserver

## Overview

The Forgotten Server is a C++ MMORPG server emulator; OTClient is the documented client. The principal workflow is client connection and protocol handling, followed by server-side game and world activity, with persistence for account and world state. Lua-driven gameplay systems provide configurable actions and events. An optional HTTP interface handles login and cache-info requests. The sampled sources confirm service dispatch, HTTP routing, script-system loading, and database-management behavior; wiring between several unsampled gameplay and persistence modules is therefore shown only where supported by their clear runtime roles.

Main entry points: [`src/scriptmanager.cpp`](https://github.com/otland/forgottenserver/blob/master/src/scriptmanager.cpp) (Script systems), [`src/http/router.cpp`](https://github.com/otland/forgottenserver/blob/master/src/http/router.cpp) (HTTP router), [`src/server.cpp`](https://github.com/otland/forgottenserver/blob/master/src/server.cpp) (Service ports), [`src/database.cpp`](https://github.com/otland/forgottenserver/blob/master/src/database.cpp) (Database)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_network["Network access"]
  node_services["Service ports<br/>[server.cpp]"]
  node_protocol["Game protocol<br/>[protocolgame.cpp]"]
end

subgraph group_game["Game runtime"]
  node_game_engine["Game engine<br/>[game.cpp]"]
  node_world["Map and tiles<br/>[map.cpp]"]
  node_players["Player and creatures<br/>[player.cpp]"]
  node_movement["Movement<br/>[movement.cpp]"]
  node_combat["Combat and spells<br/>[combat.cpp]"]
  node_items["Items and actions<br/>[item.cpp]"]
end

subgraph group_content["Gameplay systems"]
  node_chat["Chat and commands<br/>[chat.cpp]"]
  node_script_manager["Script systems<br/>[scriptmanager.cpp]"]
  node_events["Gameplay events<br/>[events.cpp]"]
  node_lua["Lua runtime<br/>[luascript.cpp]"]
end

subgraph group_data["Configuration and persistence"]
  node_config["Server configuration<br/>[configmanager.cpp]"]
  node_login_data["Login data<br/>[iologindata.cpp]"]
  node_database[("Database<br/>[database.cpp]")]
  node_db_manager["Database manager"]
end

subgraph group_http["HTTP interface"]
  node_http_session["HTTP sessions<br/>[session.cpp]"]
  node_http_router["HTTP router<br/>[router.cpp]"]
  node_http_login["HTTP login<br/>[login.cpp]"]
  node_cache_info["Cache info<br/>[cacheinfo.cpp]"]
end

node_client(("OTClient"))

node_client -->|"connects"| node_services
node_services -->|"creates protocol"| node_protocol
node_script_manager -->|"loads scripts"| node_lua
node_script_manager -->|"loads systems"| node_chat
node_script_manager -->|"loads systems"| node_events
node_db_manager -->|"queries and updates"| node_database
node_login_data -->|"persists login data"| node_database
node_http_session -->|"dispatches request"| node_http_router
node_http_router -->|"routes login"| node_http_login
node_http_router -->|"routes cache info"| node_cache_info

click node_services "https://github.com/otland/forgottenserver/blob/master/src/server.cpp"
click node_protocol "https://github.com/otland/forgottenserver/blob/master/src/protocolgame.cpp"
click node_game_engine "https://github.com/otland/forgottenserver/blob/master/src/game.cpp"
click node_world "https://github.com/otland/forgottenserver/blob/master/src/map.cpp"
click node_players "https://github.com/otland/forgottenserver/blob/master/src/player.cpp"
click node_movement "https://github.com/otland/forgottenserver/blob/master/src/movement.cpp"
click node_combat "https://github.com/otland/forgottenserver/blob/master/src/combat.cpp"
click node_items "https://github.com/otland/forgottenserver/blob/master/src/item.cpp"
click node_chat "https://github.com/otland/forgottenserver/blob/master/src/chat.cpp"
click node_script_manager "https://github.com/otland/forgottenserver/blob/master/src/scriptmanager.cpp"
click node_events "https://github.com/otland/forgottenserver/blob/master/src/events.cpp"
click node_lua "https://github.com/otland/forgottenserver/blob/master/src/luascript.cpp"
click node_config "https://github.com/otland/forgottenserver/blob/master/src/configmanager.cpp"
click node_login_data "https://github.com/otland/forgottenserver/blob/master/src/iologindata.cpp"
click node_database "https://github.com/otland/forgottenserver/blob/master/src/database.cpp"
click node_db_manager "https://github.com/otland/forgottenserver/blob/master/src/databasemanager.cpp"
click node_http_session "https://github.com/otland/forgottenserver/blob/master/src/http/session.cpp"
click node_http_router "https://github.com/otland/forgottenserver/blob/master/src/http/router.cpp"
click node_http_login "https://github.com/otland/forgottenserver/blob/master/src/http/login.cpp"
click node_cache_info "https://github.com/otland/forgottenserver/blob/master/src/http/cacheinfo.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_services,node_protocol,node_client toneBlue
class node_game_engine,node_world,node_players,node_movement,node_combat,node_items toneAmber
class node_chat,node_script_manager,node_events,node_lua toneMint
class node_config,node_login_data,node_database,node_db_manager toneRose
class node_http_session,node_http_router,node_http_login,node_cache_info toneIndigo
```

## Components

### Network access

- [Service ports](https://github.com/otland/forgottenserver/blob/master/src/server.cpp): `src/server.cpp`
- [Game protocol](https://github.com/otland/forgottenserver/blob/master/src/protocolgame.cpp): `src/protocolgame.cpp`

### Game runtime

- [Game engine](https://github.com/otland/forgottenserver/blob/master/src/game.cpp): `src/game.cpp`
- [Map and tiles](https://github.com/otland/forgottenserver/blob/master/src/map.cpp): `src/map.cpp`
- [Player and creatures](https://github.com/otland/forgottenserver/blob/master/src/player.cpp): `src/player.cpp`
- [Movement](https://github.com/otland/forgottenserver/blob/master/src/movement.cpp): `src/movement.cpp`
- [Combat and spells](https://github.com/otland/forgottenserver/blob/master/src/combat.cpp): `src/combat.cpp`
- [Items and actions](https://github.com/otland/forgottenserver/blob/master/src/item.cpp): `src/item.cpp`

### Gameplay systems

- [Chat and commands](https://github.com/otland/forgottenserver/blob/master/src/chat.cpp): `src/chat.cpp`
- [Script systems](https://github.com/otland/forgottenserver/blob/master/src/scriptmanager.cpp): `src/scriptmanager.cpp`
- [Gameplay events](https://github.com/otland/forgottenserver/blob/master/src/events.cpp): `src/events.cpp`
- [Lua runtime](https://github.com/otland/forgottenserver/blob/master/src/luascript.cpp): `src/luascript.cpp`

### Configuration and persistence

- [Server configuration](https://github.com/otland/forgottenserver/blob/master/src/configmanager.cpp): `src/configmanager.cpp`
- [Login data](https://github.com/otland/forgottenserver/blob/master/src/iologindata.cpp): `src/iologindata.cpp`
- [Database](https://github.com/otland/forgottenserver/blob/master/src/database.cpp): `src/database.cpp`
- [Database manager](https://github.com/otland/forgottenserver/blob/master/src/databasemanager.cpp): `src/databasemanager.cpp`

### HTTP interface

- [HTTP sessions](https://github.com/otland/forgottenserver/blob/master/src/http/session.cpp): `src/http/session.cpp`
- [HTTP router](https://github.com/otland/forgottenserver/blob/master/src/http/router.cpp): `src/http/router.cpp`
- [HTTP login](https://github.com/otland/forgottenserver/blob/master/src/http/login.cpp): `src/http/login.cpp`
- [Cache info](https://github.com/otland/forgottenserver/blob/master/src/http/cacheinfo.cpp): `src/http/cacheinfo.cpp`

### Other components

- **OTClient**

## Connections

- OTClient → Service ports: connects
- Service ports → Game protocol: creates protocol
- Script systems → Lua runtime: loads scripts
- Script systems → Chat and commands: loads systems
- Script systems → Gameplay events: loads systems
- Database manager → Database: queries and updates
- Login data → Database: persists login data
- HTTP sessions → HTTP router: dispatches request
- HTTP router → HTTP login: routes login
- HTTP router → Cache info: routes cache info
