# anand-kamble/fortnide architecture

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

- Interactive diagram: https://gitdiagram.com/anand-kamble/fortnide
- Repository: https://github.com/anand-kamble/fortnide

## Overview

Fortnide is a browser-based third-person shooter prototype. Its visible startup initializes browser inputs and shared state, creates the Three.js scene and player, enables core updates, then mounts the React game UI; player controls feed movement and firearm actions into physics and game state. The graph captures documented building/shooting ambitions, while their implementation is not established by the sampled code. Edges are limited to README statements or source-index references and excerpts; undocumented wiring is omitted.

Main entry points: [`src/core/render_engine/player_group.ts`](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/player_group.ts) (Player model and controls), [`src/App.tsx`](https://github.com/anand-kamble/fortnide/blob/master/src/App.tsx) (App bootstrap), [`src/core/helpers/global_variables.ts`](https://github.com/anand-kamble/fortnide/blob/master/src/core/helpers/global_variables.ts) (Shared variables), [`src/core/render_engine/animator.ts`](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/animator.ts) (Scene renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_startup["Game startup"]
  node_app["App bootstrap<br/>[App.tsx]"]
  node_sceneinit["Scene initialization<br/>[init.ts]"]
end

subgraph group_presentation["Game interface"]
  node_ui["React game view<br/>[Render.tsx]"]
  node_screens["Game screens"]
  node_weaponui["Weapon control<br/>[Weapon.tsx]"]
  node_button["Interface button<br/>[Button.tsx]"]
  node_styles["Screen styling<br/>[TestScreen.ts]"]
end

subgraph group_gameplay["Player and weapons"]
  node_playergroup["Player model and controls<br/>[player_group.ts]"]
  node_camera["Third-person camera"]
  node_animation["Animation updates<br/>[update_frame.ts]"]
  node_firearm["Firearm behavior<br/>[index.ts]"]
end

subgraph group_simulation["World simulation"]
  node_physics["Physics engine<br/>[physics.ts]"]
  node_physmethods["World and object methods"]
  node_physicsdata["Physics object types<br/>[modals.ts]"]
  node_projectile["Projectile motion<br/>[index.ts]"]
end

subgraph group_runtime["Runtime services"]
  node_browser["Browser bridge"]
  node_shared["Shared variables"]
  node_core["Core state API<br/>[index.ts]"]
  node_state["Game state manager<br/>[index.ts]"]
  node_renderer["Scene renderer<br/>[animator.ts]"]
  node_input["Input key mapping<br/>[index.ts]"]
  node_logger["Logging<br/>[index.ts]"]
end

node_player(("Player"))

node_player -->|"opens game"| node_app
node_app -->|"initializes browser"| node_browser
node_app -->|"initializes scene"| node_sceneinit
node_app -->|"creates player"| node_playergroup
node_app -->|"enables updates"| node_core
node_app -->|"mounts view"| node_ui
node_browser -->|"updates inputs"| node_shared
node_sceneinit -->|"initializes physics"| node_physics
node_sceneinit -.->|"configures scene"| node_renderer
node_playergroup -->|"registers controls"| node_browser
node_playergroup -->|"reads key mapping"| node_input
node_playergroup -->|"reads runtime values"| node_shared
node_playergroup -->|"adds player object"| node_physics
node_playergroup -->|"updates player state"| node_state
node_playergroup -->|"sets camera target"| node_camera
node_playergroup -->|"registers frame callback"| node_renderer
node_camera -->|"reads camera settings"| node_shared
node_camera -->|"uses animator"| node_renderer
node_animation -->|"reads global state"| node_shared
node_physics -->|"uses object types"| node_physicsdata
node_physmethods -->|"uses object types"| node_physicsdata
node_firearm -->|"launches projectile"| node_projectile
node_firearm -->|"reads animator clock"| node_renderer
node_firearm -->|"updates ammunition"| node_state
node_ui -->|"renders screens"| node_screens
node_ui -->|"renders weapon control"| node_weaponui
node_screens -->|"renders start button"| node_button
node_screens -->|"uses screen styles"| node_styles
node_button -->|"logs sound errors"| node_logger
node_weaponui -->|"uses core API"| node_core
node_player -->|"fires shots"| node_projectile
node_player -.->|"builds structures"| node_physmethods

click node_app "https://github.com/anand-kamble/fortnide/blob/master/src/App.tsx"
click node_browser "https://github.com/anand-kamble/fortnide/blob/master/src/core/helpers/browser_initiator.ts"
click node_shared "https://github.com/anand-kamble/fortnide/blob/master/src/core/helpers/global_variables.ts"
click node_core "https://github.com/anand-kamble/fortnide/blob/master/src/core/index.ts"
click node_state "https://github.com/anand-kamble/fortnide/blob/master/src/core/State%20Manager/index.ts"
click node_renderer "https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/animator.ts"
click node_sceneinit "https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/init.ts"
click node_playergroup "https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/player_group.ts"
click node_camera "https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/set_third_person.ts"
click node_animation "https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/update_frame.ts"
click node_physics "https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/physics.ts"
click node_physmethods "https://github.com/anand-kamble/fortnide/tree/master/src/core/Physics/methods"
click node_physicsdata "https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/modals.ts"
click node_firearm "https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/Weapon/FireArm/index.ts"
click node_projectile "https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/Projectile/index.ts"
click node_input "https://github.com/anand-kamble/fortnide/blob/master/src/core/input_keys/index.ts"
click node_ui "https://github.com/anand-kamble/fortnide/blob/master/src/UI/Render/Render.tsx"
click node_screens "https://github.com/anand-kamble/fortnide/tree/master/src/UI/Screens"
click node_weaponui "https://github.com/anand-kamble/fortnide/blob/master/src/UI/Components/Weapon.tsx"
click node_button "https://github.com/anand-kamble/fortnide/blob/master/src/UI/Components/Button.tsx"
click node_styles "https://github.com/anand-kamble/fortnide/blob/master/src/UI/StyleSheets/TestScreen.ts"
click node_logger "https://github.com/anand-kamble/fortnide/blob/master/src/Logger/index.ts"

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_app,node_sceneinit toneBlue
class node_ui,node_screens,node_weaponui,node_button,node_styles toneAmber
class node_playergroup,node_camera,node_animation,node_firearm toneMint
class node_physics,node_physmethods,node_physicsdata,node_projectile toneRose
class node_browser,node_shared,node_core,node_state,node_renderer,node_input,node_logger,node_player toneIndigo
```

## Components

### Game startup

- [App bootstrap](https://github.com/anand-kamble/fortnide/blob/master/src/App.tsx): `src/App.tsx`
- [Scene initialization](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/init.ts): `src/core/render_engine/init.ts`

### Game interface

- [React game view](https://github.com/anand-kamble/fortnide/blob/master/src/UI/Render/Render.tsx): `src/UI/Render/Render.tsx`
- [Game screens](https://github.com/anand-kamble/fortnide/tree/master/src/UI/Screens): `src/UI/Screens`
- [Weapon control](https://github.com/anand-kamble/fortnide/blob/master/src/UI/Components/Weapon.tsx): `src/UI/Components/Weapon.tsx`
- [Interface button](https://github.com/anand-kamble/fortnide/blob/master/src/UI/Components/Button.tsx): `src/UI/Components/Button.tsx`
- [Screen styling](https://github.com/anand-kamble/fortnide/blob/master/src/UI/StyleSheets/TestScreen.ts): `src/UI/StyleSheets/TestScreen.ts`

### Player and weapons

- [Player model and controls](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/player_group.ts): `src/core/render_engine/player_group.ts`
- [Third-person camera](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/set_third_person.ts): `src/core/render_engine/set_third_person.ts`
- [Animation updates](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/update_frame.ts): `src/core/render_engine/update_frame.ts`
- [Firearm behavior](https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/Weapon/FireArm/index.ts): `src/core/Physics/Weapon/FireArm/index.ts`

### World simulation

- [Physics engine](https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/physics.ts): `src/core/Physics/physics.ts`
- [World and object methods](https://github.com/anand-kamble/fortnide/tree/master/src/core/Physics/methods): `src/core/Physics/methods`
- [Physics object types](https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/modals.ts): `src/core/Physics/modals.ts`
- [Projectile motion](https://github.com/anand-kamble/fortnide/blob/master/src/core/Physics/Projectile/index.ts): `src/core/Physics/Projectile/index.ts`

### Runtime services

- [Browser bridge](https://github.com/anand-kamble/fortnide/blob/master/src/core/helpers/browser_initiator.ts): `src/core/helpers/browser_initiator.ts`
- [Shared variables](https://github.com/anand-kamble/fortnide/blob/master/src/core/helpers/global_variables.ts): `src/core/helpers/global_variables.ts`
- [Core state API](https://github.com/anand-kamble/fortnide/blob/master/src/core/index.ts): `src/core/index.ts`
- [Game state manager](https://github.com/anand-kamble/fortnide/blob/master/src/core/State%20Manager/index.ts): `src/core/State Manager/index.ts`
- [Scene renderer](https://github.com/anand-kamble/fortnide/blob/master/src/core/render_engine/animator.ts): `src/core/render_engine/animator.ts`
- [Input key mapping](https://github.com/anand-kamble/fortnide/blob/master/src/core/input_keys/index.ts): `src/core/input_keys/index.ts`
- [Logging](https://github.com/anand-kamble/fortnide/blob/master/src/Logger/index.ts): `src/Logger/index.ts`

### Other components

- **Player**

## Connections

- Player → App bootstrap: opens game (evidence: `README.md`)
- App bootstrap → Browser bridge: initializes browser (evidence: `src/App.tsx`)
- App bootstrap → Scene initialization: initializes scene (evidence: `src/App.tsx`)
- App bootstrap → Player model and controls: creates player (evidence: `src/App.tsx`)
- App bootstrap → Core state API: enables updates (evidence: `src/App.tsx`)
- App bootstrap → React game view: mounts view (evidence: `src/App.tsx`)
- Browser bridge → Shared variables: updates inputs (evidence: `src/core/helpers/browser_initiator.ts`)
- Scene initialization → Physics engine: initializes physics (evidence: `src/core/render_engine/init.ts`)
- Scene initialization → Scene renderer: configures scene (evidence: `src/core/render_engine/init.ts`)
- Player model and controls → Browser bridge: registers controls (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Input key mapping: reads key mapping (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Shared variables: reads runtime values (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Physics engine: adds player object (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Game state manager: updates player state (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Third-person camera: sets camera target (evidence: `src/core/render_engine/player_group.ts`)
- Player model and controls → Scene renderer: registers frame callback (evidence: `src/core/render_engine/player_group.ts`)
- Third-person camera → Shared variables: reads camera settings (evidence: `src/core/render_engine/set_third_person.ts`)
- Third-person camera → Scene renderer: uses animator (evidence: `src/core/render_engine/set_third_person.ts`)
- Animation updates → Shared variables: reads global state
- Physics engine → Physics object types: uses object types (evidence: `src/core/Physics/physics.ts`)
- World and object methods → Physics object types: uses object types (evidence: `src/core/Physics/methods/addObject.ts`)
- Firearm behavior → Projectile motion: launches projectile (evidence: `src/core/Physics/Weapon/FireArm/index.ts`)
- Firearm behavior → Scene renderer: reads animator clock (evidence: `src/core/Physics/Weapon/FireArm/index.ts`)
- Firearm behavior → Game state manager: updates ammunition (evidence: `src/core/Physics/Weapon/FireArm/index.ts`)
- React game view → Game screens: renders screens (evidence: `src/UI/Render/Render.tsx`)
- React game view → Weapon control: renders weapon control (evidence: `src/UI/Render/Render.tsx`)
- Game screens → Interface button: renders start button (evidence: `src/UI/Screens/TestScreen.tsx`)
- Game screens → Screen styling: uses screen styles (evidence: `src/UI/Screens/TestScreen.tsx`)
- Interface button → Logging: logs sound errors (evidence: `src/UI/Components/Button.tsx`)
- Weapon control → Core state API: uses core API (evidence: `src/UI/Components/Weapon.tsx`)
- Player → Projectile motion: fires shots (evidence: `README.md`)
- Player → World and object methods: builds structures
