# andrewwoan/psu-vr architecture

> Architecture diagram of the GitHub repository andrewwoan/psu-vr, 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/andrewwoan/psu-vr
- Repository: https://github.com/andrewwoan/psu-vr

## Overview

PSU VR is a browser-based multiplayer campus experience. Users enter through the frontend, choose a name and avatar, then explore the rendered campus as a player; the interface also supports chat and camera/audio controls. The graph separates application setup, asset loading and presentation, campus world construction, and player interaction. The README documents the multiplayer campus product; source excerpts show client-side socket events, but do not expose server implementation or establish its wiring, so server relationships are omitted.

Main entry points: [`frontend/Experience/Experience.js`](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Experience.js) (Experience loop), [`frontend/index.js`](https://github.com/andrewwoan/psu-vr/blob/main/frontend/index.js) (Frontend entry), [`frontend/Experience/World/World.js`](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/World.js) (World coordinator), [`frontend/Experience/Utils/Resources.js`](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/Resources.js) (Asset resources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and interface"]
  node_entry["Frontend entry<br/>[index.js]"]
  node_experience["Experience loop<br/>[Experience.js]"]
  node_ui["Chat and selection UI<br/>[index.js]"]
  node_preloader["Preloader<br/>[Preloader.js]"]
  node_server["Backend server<br/>[server.js]"]
end

subgraph group_render["Rendering and assets"]
  node_resources["Asset resources<br/>[Resources.js]"]
  node_loaders["Asset loaders<br/>[Loaders.js]"]
  node_assetlist["Asset catalog<br/>[assets.js]"]
  node_camera["Camera controls<br/>[Camera.js]"]
  node_orbit["Orbit controls"]
  node_renderer["Scene renderer<br/>[Renderer.js]"]
end

subgraph group_world["Campus world"]
  node_world["World coordinator<br/>[World.js]"]
  node_campus["Westgate campus<br/>[Westgate.js]"]
  node_environment["Lighting and environment<br/>[Environment.js]"]
end

subgraph group_players["Player interaction"]
  node_player["Player and movement<br/>[Player.js]"]
  node_avatar["Avatar model<br/>[Avatar.js]"]
  node_nametag["Player nametag<br/>[Nametag.js]"]
end

node_visitor(("Visitor"))
node_socket{{"Realtime socket service"}}

node_visitor -->|"opens"| node_entry
node_entry -->|"creates"| node_experience
node_entry -->|"registers events"| node_ui
node_entry -->|"emits chat and updates"| node_socket
node_socket -->|"delivers chat"| node_ui
node_experience -->|"creates"| node_resources
node_experience -->|"creates"| node_preloader
node_experience -->|"creates"| node_camera
node_experience -->|"creates"| node_renderer
node_experience -->|"creates"| node_world
node_resources -->|"loads catalog"| node_assetlist
node_resources -->|"uses"| node_loaders
node_camera -->|"creates controls"| node_orbit
node_world -->|"creates"| node_campus
node_world -->|"creates"| node_player
node_world -->|"creates"| node_environment
node_player -->|"creates"| node_avatar
node_avatar -->|"creates"| node_nametag

click node_entry "https://github.com/andrewwoan/psu-vr/blob/main/frontend/index.js"
click node_experience "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Experience.js"
click node_ui "https://github.com/andrewwoan/psu-vr/blob/main/frontend/index.js"
click node_preloader "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Preloader.js"
click node_server "https://github.com/andrewwoan/psu-vr/blob/main/server.js"
click node_resources "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/Resources.js"
click node_loaders "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/Loaders.js"
click node_assetlist "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/assets.js"
click node_camera "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Camera.js"
click node_orbit "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/CustomOrbitControls.js"
click node_renderer "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Renderer.js"
click node_world "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/World.js"
click node_campus "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Westgate.js"
click node_environment "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Environment.js"
click node_player "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Player.js"
click node_avatar "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Avatar.js"
click node_nametag "https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Nametag.js"

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_entry,node_experience,node_ui,node_preloader,node_server toneBlue
class node_resources,node_loaders,node_assetlist,node_camera,node_orbit,node_renderer toneAmber
class node_world,node_campus,node_environment toneMint
class node_player,node_avatar,node_nametag toneRose
class node_visitor,node_socket toneIndigo
```

## Components

### Application and interface

- [Frontend entry](https://github.com/andrewwoan/psu-vr/blob/main/frontend/index.js): `frontend/index.js`
- [Experience loop](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Experience.js): `frontend/Experience/Experience.js`
- [Chat and selection UI](https://github.com/andrewwoan/psu-vr/blob/main/frontend/index.js): `frontend/index.js`
- [Preloader](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Preloader.js): `frontend/Experience/Preloader.js`
- [Backend server](https://github.com/andrewwoan/psu-vr/blob/main/server.js): `server.js`

### Rendering and assets

- [Asset resources](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/Resources.js): `frontend/Experience/Utils/Resources.js`
- [Asset loaders](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/Loaders.js): `frontend/Experience/Utils/Loaders.js`
- [Asset catalog](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/assets.js): `frontend/Experience/Utils/assets.js`
- [Camera controls](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Camera.js): `frontend/Experience/Camera.js`
- [Orbit controls](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Utils/CustomOrbitControls.js): `frontend/Experience/Utils/CustomOrbitControls.js`
- [Scene renderer](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/Renderer.js): `frontend/Experience/Renderer.js`

### Campus world

- [World coordinator](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/World.js): `frontend/Experience/World/World.js`
- [Westgate campus](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Westgate.js): `frontend/Experience/World/Westgate.js`
- [Lighting and environment](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Environment.js): `frontend/Experience/World/Environment.js`

### Player interaction

- [Player and movement](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Player.js): `frontend/Experience/World/Player/Player.js`
- [Avatar model](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Avatar.js): `frontend/Experience/World/Player/Avatar.js`
- [Player nametag](https://github.com/andrewwoan/psu-vr/blob/main/frontend/Experience/World/Player/Nametag.js): `frontend/Experience/World/Player/Nametag.js`

### Other components

- **Visitor**
- **Realtime socket service**

## Connections

- Visitor → Frontend entry: opens (evidence: `README.md`)
- Frontend entry → Experience loop: creates (evidence: `frontend/index.js`)
- Frontend entry → Chat and selection UI: registers events (evidence: `frontend/index.js`)
- Frontend entry → Realtime socket service: emits chat and updates (evidence: `frontend/index.js`)
- Realtime socket service → Chat and selection UI: delivers chat (evidence: `frontend/index.js`)
- Experience loop → Asset resources: creates (evidence: `frontend/Experience/Experience.js`)
- Experience loop → Preloader: creates (evidence: `frontend/Experience/Experience.js`)
- Experience loop → Camera controls: creates (evidence: `frontend/Experience/Experience.js`)
- Experience loop → Scene renderer: creates (evidence: `frontend/Experience/Experience.js`)
- Experience loop → World coordinator: creates (evidence: `frontend/Experience/Experience.js`)
- Asset resources → Asset catalog: loads catalog (evidence: `frontend/Experience/Experience.js`)
- Asset resources → Asset loaders: uses (evidence: `frontend/Experience/Utils/Resources.js`)
- Camera controls → Orbit controls: creates controls (evidence: `frontend/Experience/Camera.js`)
- World coordinator → Westgate campus: creates (evidence: `frontend/Experience/World/World.js`)
- World coordinator → Player and movement: creates (evidence: `frontend/Experience/World/World.js`)
- World coordinator → Lighting and environment: creates (evidence: `frontend/Experience/World/World.js`)
- Player and movement → Avatar model: creates (evidence: `frontend/Experience/World/Player/Player.js`)
- Avatar model → Player nametag: creates (evidence: `frontend/Experience/World/Player/Avatar.js`)
