# fivem-scripts/venomous-freemode architecture

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

- Interactive diagram: https://gitdiagram.com/fivem-scripts/venomous-freemode
- Repository: https://github.com/fivem-scripts/venomous-freemode

## Overview

Venomous-freemode is a modular FiveM freemode game, split into independently usable resources. The tree shows a player foundation, phone and app resources, and gameplay services such as banking, missions, shops, cinema, and synchronization. One visible UI workflow is the bank interface: it opens from a message, presents banking actions, and posts navigation, deposit, withdrawal, and close requests to the vf_bank resource. Most resource internals and their connections were not sampled, so the graph avoids inferring their call flow.

Main entry points: [`vf_bank/ui/script.js`](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/ui/script.js) (Bank interface), [`vf_bank/client.lua`](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/client.lua) (Bank service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_foundation["Player foundation"]
  node_player["Player foundation<br/>[player.lua]"]
  node_world["Spawn and world<br/>[spawn.lua]"]
end

subgraph group_phone["Phone"]
  node_phone_runtime["Phone runtime<br/>[cl_phone.lua]"]
  node_phone_apps["Phone apps<br/>[cl_appmessages.lua]"]
end

subgraph group_gameplay["Gameplay resources"]
  node_bank_ui["Bank interface<br/>[script.js]"]
  node_bank_service["Bank service<br/>[client.lua]"]
  node_ammunation["Ammunation<br/>[client.lua]"]
  node_convenience["Convenience shops<br/>[client.lua]"]
  node_vending["Vending<br/>[client.lua]"]
  node_missions["Missions<br/>[cl_missions.lua]"]
  node_cinema["Cinema<br/>[cinema.lua]"]
  node_interaction["Interactions<br/>[client.lua]"]
end

subgraph group_support["Shared services"]
  node_sync_client["Client synchronization<br/>[cl_timesync.lua]"]
  node_weather_sync["Weather synchronization<br/>[cl_weathersync.lua]"]
  node_weather_server["Weather service<br/>[sv_weathersync.lua]"]
end

node_player_actor(("Player"))

node_bank_ui -->|"posts actions"| node_bank_service

click node_player "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_base/server/player.lua"
click node_world "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_base/client/spawn.lua"
click node_phone_runtime "https://github.com/fivem-scripts/venomous-freemode/blob/master/%5Bphone%5D/vf_phone/phone/cl_phone.lua"
click node_phone_apps "https://github.com/fivem-scripts/venomous-freemode/blob/master/%5Bphone%5D/vf_baseapps/apps/cl_appmessages.lua"
click node_bank_ui "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/ui/script.js"
click node_bank_service "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/client.lua"
click node_ammunation "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_ammunation/client.lua"
click node_convenience "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_convenience/client.lua"
click node_vending "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_vending/client.lua"
click node_missions "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_mtest/missions/cl_missions.lua"
click node_cinema "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_cinema/cinema.lua"
click node_interaction "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_interaction/client.lua"
click node_sync_client "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/cl_timesync.lua"
click node_weather_sync "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/cl_weathersync.lua"
click node_weather_server "https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/sv_weathersync.lua"

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_player,node_world toneBlue
class node_phone_runtime,node_phone_apps toneAmber
class node_bank_ui,node_bank_service,node_ammunation,node_convenience,node_vending,node_missions,node_cinema,node_interaction toneMint
class node_sync_client,node_weather_sync,node_weather_server toneRose
class node_player_actor toneIndigo
```

## Components

### Player foundation

- [Player foundation](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_base/server/player.lua): `vf_base/server/player.lua`
- [Spawn and world](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_base/client/spawn.lua): `vf_base/client/spawn.lua`

### Phone

- [Phone runtime](https://github.com/fivem-scripts/venomous-freemode/blob/master/%5Bphone%5D/vf_phone/phone/cl_phone.lua): `[phone]/vf_phone/phone/cl_phone.lua`
- [Phone apps](https://github.com/fivem-scripts/venomous-freemode/blob/master/%5Bphone%5D/vf_baseapps/apps/cl_appmessages.lua): `[phone]/vf_baseapps/apps/cl_appmessages.lua`

### Gameplay resources

- [Bank interface](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/ui/script.js): `vf_bank/ui/script.js`
- [Bank service](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_bank/client.lua): `vf_bank/client.lua`
- [Ammunation](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_ammunation/client.lua): `vf_ammunation/client.lua`
- [Convenience shops](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_convenience/client.lua): `vf_convenience/client.lua`
- [Vending](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_vending/client.lua): `vf_vending/client.lua`
- [Missions](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_mtest/missions/cl_missions.lua): `vf_mtest/missions/cl_missions.lua`
- [Cinema](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_cinema/cinema.lua): `vf_cinema/cinema.lua`
- [Interactions](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_interaction/client.lua): `vf_interaction/client.lua`

### Shared services

- [Client synchronization](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/cl_timesync.lua): `vf_sync/cl_timesync.lua`
- [Weather synchronization](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/cl_weathersync.lua): `vf_sync/cl_weathersync.lua`
- [Weather service](https://github.com/fivem-scripts/venomous-freemode/blob/master/vf_sync/sv_weathersync.lua): `vf_sync/sv_weathersync.lua`

### Other components

- **Player**

## Connections

- Bank interface → Bank service: posts actions (evidence: `vf_bank/ui/script.js`)
