# fzoltani/originalroleplay architecture

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

- Interactive diagram: https://gitdiagram.com/fzoltani/originalroleplay
- Repository: https://github.com/fzoltani/originalroleplay

## Overview

OriginalRoleplay is a published Multi Theft Auto roleplay gamemode repository: a large collection of server resources, client interfaces, jobs, maps, and shared systems. The supplied README describes the mod and its release, but not a specific player-facing workflow; the tree alone cannot establish how most resources interact. The clearest sampled runtime flow is the embedded 2048 game in the phone, alongside a separate browser-to-MTA AJAX bridge. The graph therefore shows those evidenced flows and keeps the broader roleplay resource families unlinked. Several 2048 modules are indexed as read but not excerpted.

Main entry points: [`oPhone/games/2048/js/game_manager.js`](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/game_manager.js) (Game manager), [`[Carlos]/ajax/ajax.js`](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/ajax.js) (AJAX bridge), [`oPhone/games/2048/js/keyboard_input_manager.js`](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/keyboard_input_manager.js) (Keyboard and touch), [`[Carlos]/ajax/exportedfunctions.js`](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/exportedfunctions.js) (Export wrappers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_phonegame["Phone 2048"]
  node_gamepage["Game page<br/>[application.js]"]
  node_input["Keyboard and touch"]
  node_manager["Game manager<br/>[game_manager.js]"]
  node_grid["Board grid<br/>[grid.js]"]
  node_tile["Tile model<br/>[tile.js]"]
  node_actuator["Game display<br/>[html_actuator.js]"]
  node_storage[("Game storage")]
end

subgraph group_webbridge["Browser AJAX"]
  node_ajax["AJAX bridge<br/>[ajax.js]"]
  node_json["JSON extensions<br/>[json.js]"]
  node_exports["Export wrappers"]
  node_perf["Performance browser<br/>[main.js]"]
end

subgraph group_roleplay["Roleplay Resources"]
  node_core["Core systems"]
  node_interface["Player interfaces"]
  node_jobs["Jobs"]
  node_world["Maps and world"]
  node_gameplay["Gameplay resources"]
end

node_player(("Player"))
node_browser(("Browser client"))
node_mta{{"MTA resource server"}}

node_player -->|"presses controls"| node_input
node_gamepage -->|"creates game"| node_manager
node_manager -->|"registers events"| node_input
node_input -->|"emits moves"| node_manager
node_manager -->|"updates board"| node_grid
node_manager -->|"creates tiles"| node_tile
node_manager -->|"saves state"| node_storage
node_manager -->|"renders state"| node_actuator
node_browser -.->|"requests exports"| node_exports
node_exports -->|"calls functions"| node_ajax
node_ajax -->|"parses responses"| node_json
node_ajax -->|"sends resource call"| node_mta

click node_gamepage "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/application.js"
click node_input "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/keyboard_input_manager.js"
click node_manager "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/game_manager.js"
click node_grid "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/grid.js"
click node_tile "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/tile.js"
click node_actuator "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/html_actuator.js"
click node_storage "https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/local_storage_manager.js"
click node_ajax "https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/ajax.js"
click node_json "https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/json.js"
click node_exports "https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/exportedfunctions.js"
click node_perf "https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/performancebrowser/main.js"
click node_core "https://github.com/fzoltani/originalroleplay/tree/main/%5BCore%5D/oCore"
click node_interface "https://github.com/fzoltani/originalroleplay/tree/main/%5BInterface%5D"
click node_jobs "https://github.com/fzoltani/originalroleplay/tree/main/%5BJobs%5D"
click node_world "https://github.com/fzoltani/originalroleplay/tree/main/%5BMaps%5D"
click node_gameplay "https://github.com/fzoltani/originalroleplay/tree/main/oVehicle"

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_gamepage,node_input,node_manager,node_grid,node_tile,node_actuator,node_storage,node_browser toneBlue
class node_ajax,node_json,node_exports,node_perf toneAmber
class node_core,node_interface,node_jobs,node_world,node_gameplay,node_mta toneMint
class node_player toneIndigo
```

## Components

### Phone 2048

- [Game page](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/application.js): `oPhone/games/2048/js/application.js`
- [Keyboard and touch](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/keyboard_input_manager.js): `oPhone/games/2048/js/keyboard_input_manager.js`
- [Game manager](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/game_manager.js): `oPhone/games/2048/js/game_manager.js`
- [Board grid](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/grid.js): `oPhone/games/2048/js/grid.js`
- [Tile model](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/tile.js): `oPhone/games/2048/js/tile.js`
- [Game display](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/html_actuator.js): `oPhone/games/2048/js/html_actuator.js`
- [Game storage](https://github.com/fzoltani/originalroleplay/blob/main/oPhone/games/2048/js/local_storage_manager.js): `oPhone/games/2048/js/local_storage_manager.js`

### Browser AJAX

- [AJAX bridge](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/ajax.js): `[Carlos]/ajax/ajax.js`
- [JSON extensions](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/json.js): `[Carlos]/ajax/json.js`
- [Export wrappers](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/ajax/exportedfunctions.js): `[Carlos]/ajax/exportedfunctions.js`
- [Performance browser](https://github.com/fzoltani/originalroleplay/blob/main/%5BCarlos%5D/performancebrowser/main.js): `[Carlos]/performancebrowser/main.js`

### Roleplay Resources

- [Core systems](https://github.com/fzoltani/originalroleplay/tree/main/%5BCore%5D/oCore): `[Core]/oCore`
- [Player interfaces](https://github.com/fzoltani/originalroleplay/tree/main/%5BInterface%5D): `[Interface]`
- [Jobs](https://github.com/fzoltani/originalroleplay/tree/main/%5BJobs%5D): `[Jobs]`
- [Maps and world](https://github.com/fzoltani/originalroleplay/tree/main/%5BMaps%5D): `[Maps]`
- [Gameplay resources](https://github.com/fzoltani/originalroleplay/tree/main/oVehicle): `oVehicle`

### Other components

- **Player**
- **Browser client**
- **MTA resource server**

## Connections

- Player → Keyboard and touch: presses controls (evidence: `oPhone/games/2048/js/keyboard_input_manager.js`)
- Game page → Game manager: creates game (evidence: `oPhone/games/2048/js/application.js`)
- Game manager → Keyboard and touch: registers events (evidence: `oPhone/games/2048/js/game_manager.js`)
- Keyboard and touch → Game manager: emits moves (evidence: `oPhone/games/2048/js/keyboard_input_manager.js`)
- Game manager → Board grid: updates board (evidence: `oPhone/games/2048/js/game_manager.js`)
- Game manager → Tile model: creates tiles (evidence: `oPhone/games/2048/js/game_manager.js`)
- Game manager → Game storage: saves state (evidence: `oPhone/games/2048/js/game_manager.js`)
- Game manager → Game display: renders state (evidence: `oPhone/games/2048/js/game_manager.js`)
- Browser client → Export wrappers: requests exports
- Export wrappers → AJAX bridge: calls functions (evidence: `[Carlos]/ajax/exportedfunctions.js`)
- AJAX bridge → JSON extensions: parses responses (evidence: `[Carlos]/ajax/ajax.js`)
- AJAX bridge → MTA resource server: sends resource call (evidence: `[Carlos]/ajax/ajax.js`)
