# uzelezz123/z-city architecture

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

- Interactive diagram: https://gitdiagram.com/uzelezz123/z-city
- Repository: https://github.com/uzelezz123/z-city

## Overview

Z-City is a Garry’s Mod addon combining character mechanics, a weapon base, and a gamemode. The principal user workflow is joining a game and playing through the gamemode, with damage, controls, and weapons as documented gameplay capabilities. The tree also shows supporting equipment, inventory, and client presentation systems, plus a substantial Glide vehicle subsystem. Source excerpts were unavailable, so the graph avoids asserting internal calls or data flow that the README and tree do not establish.

Main entry points: [`gamemodes/zcity/gamemode/shared.lua`](https://github.com/uzelezz123/z-city/blob/main/gamemodes/zcity/gamemode/shared.lua) (Z-City Gamemode)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Gameplay Runtime"]
  node_gamemode["Z-City Gamemode<br/>[shared.lua]"]
  node_modes["Game Modes"]
  node_rounds["Round System<br/>[sv_roundsystem.lua]"]
  node_entities["Gameplay Entities"]
end

subgraph group_character["Character Systems"]
  node_damage["Organism and Damage"]
  node_movement["Movement"]
end

subgraph group_content["Items and Vehicles"]
  node_weapons["Weapon Base"]
  node_equipment["Equipment"]
  node_inventory["Inventory"]
  node_clothes["Clothing"]
  node_glide["Glide Vehicles"]
end

subgraph group_presentation["Player Interface"]
  node_hud["HUD"]
  node_appearance["Appearance"]
end

node_player(("Player"))

node_player -->|"joins"| node_gamemode

click node_gamemode "https://github.com/uzelezz123/z-city/blob/main/gamemodes/zcity/gamemode/shared.lua"
click node_modes "https://github.com/uzelezz123/z-city/tree/main/gamemodes/zcity/gamemode/modes"
click node_rounds "https://github.com/uzelezz123/z-city/blob/main/gamemodes/zcity/gamemode/libraries/sv_roundsystem.lua"
click node_entities "https://github.com/uzelezz123/z-city/tree/main/gamemodes/zcity/entities/entities"
click node_damage "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/organism"
click node_movement "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/movement"
click node_weapons "https://github.com/uzelezz123/z-city/tree/main/lua/weapons/weapon_base"
click node_equipment "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/equipment_system"
click node_inventory "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/new_inventory"
click node_clothes "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/clothes"
click node_glide "https://github.com/uzelezz123/z-city/tree/main/lua/entities/base_glide"
click node_hud "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/hud"
click node_appearance "https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/new_appearance"

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_gamemode,node_modes,node_rounds,node_entities toneBlue
class node_damage,node_movement toneAmber
class node_weapons,node_equipment,node_inventory,node_clothes,node_glide toneMint
class node_hud,node_appearance toneRose
class node_player toneIndigo
```

## Components

### Gameplay Runtime

- [Z-City Gamemode](https://github.com/uzelezz123/z-city/blob/main/gamemodes/zcity/gamemode/shared.lua): `gamemodes/zcity/gamemode/shared.lua`
- [Game Modes](https://github.com/uzelezz123/z-city/tree/main/gamemodes/zcity/gamemode/modes): `gamemodes/zcity/gamemode/modes`
- [Round System](https://github.com/uzelezz123/z-city/blob/main/gamemodes/zcity/gamemode/libraries/sv_roundsystem.lua): `gamemodes/zcity/gamemode/libraries/sv_roundsystem.lua`
- [Gameplay Entities](https://github.com/uzelezz123/z-city/tree/main/gamemodes/zcity/entities/entities): `gamemodes/zcity/entities/entities`

### Character Systems

- [Organism and Damage](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/organism): `lua/homigrad/organism`
- [Movement](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/movement): `lua/homigrad/movement`

### Items and Vehicles

- [Weapon Base](https://github.com/uzelezz123/z-city/tree/main/lua/weapons/weapon_base): `lua/weapons/weapon_base`
- [Equipment](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/equipment_system): `lua/homigrad/equipment_system`
- [Inventory](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/new_inventory): `lua/homigrad/new_inventory`
- [Clothing](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/clothes): `lua/homigrad/clothes`
- [Glide Vehicles](https://github.com/uzelezz123/z-city/tree/main/lua/entities/base_glide): `lua/entities/base_glide`

### Player Interface

- [HUD](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/hud): `lua/homigrad/hud`
- [Appearance](https://github.com/uzelezz123/z-city/tree/main/lua/homigrad/new_appearance): `lua/homigrad/new_appearance`

### Other components

- **Player**

## Connections

- Player → Z-City Gamemode: joins