# chasmlol/2010-rust-rewrite-mashup architecture

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

- Interactive diagram: https://gitdiagram.com/chasmlol/2010-rust-rewrite-mashup
- Repository: https://github.com/chasmlol/2010-rust-rewrite-mashup

## Overview

This workspace is a Rust game mashup built on an MW2 rewrite: MW2 multiplayer is the host game, with optional Skate 3 gameplay and an integrated Minecraft world. The main Minecraft path is map selection, server-side world simulation, a client scene, then streamed terrain preparation and rendering. The README documents the player-facing capabilities; source-index references support several Minecraft module relationships. Other integration details, especially the unsampled Skate and MW2 runtime wiring, are intentionally left unconnected.

Main entry points: [`crates/minecraft_terrain/src/terrain.rs`](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/terrain.rs) (Terrain streaming), [`crates/iw4l-master/src/main.rs`](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/iw4l-master/src/main.rs) (Game host), [`crates/minecraft_terrain/src/server.rs`](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/server.rs) (World server), [`crates/asset_game/src/menu_catalog.rs`](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/asset_game/src/menu_catalog.rs) (Map selection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_game["MW2 game"]
  node_game_host["Game host<br/>[main.rs]"]
  node_mw2_gameplay["MW2 gameplay<br/>[client_view.rs]"]
  node_mw2_hud["MW2 HUD<br/>[mod.rs]"]
  node_map_select["Map selection<br/>[menu_catalog.rs]"]
end

subgraph group_minecraft["Minecraft world"]
  node_mc_server["World server<br/>[server.rs]"]
  node_mc_mobs["Mob simulation<br/>[server_mobs.rs]"]
  node_mc_scene["World scene<br/>[scene.rs]"]
  node_mc_terrain["Terrain streaming<br/>[terrain.rs]"]
  node_mc_sections["Terrain sections<br/>[sections.rs]"]
  node_mc_mesh["Terrain meshes<br/>[mesh.rs]"]
  node_mc_lighting["World lighting<br/>[lighting.rs]"]
  node_mc_fluids["Fluid rendering<br/>[fluid.rs]"]
  node_mc_pack["Minecraft resources<br/>[pack.rs]"]
end

subgraph group_skate["Skate mode"]
  node_skate_mode["Skate gameplay<br/>[controller.rs]"]
  node_skate_camera["Skate camera<br/>[shot_manager.rs]"]
end

subgraph group_platform["Controls and assets"]
  node_controller_input["Controller input<br/>[weapon_select.rs]"]
  node_bindings["Rebindable controls<br/>[binds.rs]"]
  node_asset_download["First-run download<br/>[first_run.rs]"]
end

node_player(("Player"))
node_mojang["Mojang servers"]

node_player -->|"starts game"| node_game_host
node_game_host -->|"offers maps"| node_map_select
node_player -->|"selects map"| node_map_select
node_map_select -->|"starts Minecraft map"| node_mc_server
node_game_host -->|"hosts multiplayer"| node_mw2_gameplay
node_game_host -.->|"presents HUD"| node_mw2_hud
node_mc_server -->|"updates blocks"| node_mc_scene
node_mc_server -->|"ticks mobs"| node_mc_mobs
node_mc_terrain -->|"updates scene"| node_mc_scene
node_mc_terrain -->|"builds sections"| node_mc_sections
node_mc_terrain -->|"builds meshes"| node_mc_mesh
node_mc_terrain -->|"uses lighting"| node_mc_lighting
node_mc_terrain -->|"uses fluids"| node_mc_fluids
node_mc_scene -->|"uses resources"| node_mc_pack
node_player -->|"enters skating"| node_skate_mode
node_skate_mode -.->|"updates camera"| node_skate_camera
node_player -->|"plays with controller"| node_controller_input
node_controller_input -.->|"supports rebinding"| node_bindings
node_asset_download -->|"downloads game files"| node_mojang

click node_game_host "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/iw4l-master/src/main.rs"
click node_mw2_gameplay "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/sim/src/match_state/client_view.rs"
click node_mw2_hud "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/hud/src/menus/mod.rs"
click node_map_select "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/asset_game/src/menu_catalog.rs"
click node_mc_server "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/server.rs"
click node_mc_mobs "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/server_mobs.rs"
click node_mc_scene "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/scene.rs"
click node_mc_terrain "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/terrain.rs"
click node_mc_sections "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/sections.rs"
click node_mc_mesh "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/mesh.rs"
click node_mc_lighting "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/lighting.rs"
click node_mc_fluids "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/fluid.rs"
click node_mc_pack "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/pack.rs"
click node_skate_mode "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/skate/crates/skate-core/src/physics/manual/controller.rs"
click node_skate_camera "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/skate/crates/skate-core/src/camera/shot_manager.rs"
click node_controller_input "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/input_iw4/src/weapon_select.rs"
click node_bindings "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/console/src/binds.rs"
click node_asset_download "https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/launcher/src/first_run.rs"

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_game_host,node_mw2_gameplay,node_mw2_hud,node_map_select toneBlue
class node_mc_server,node_mc_mobs,node_mc_scene,node_mc_terrain,node_mc_sections,node_mc_mesh,node_mc_lighting,node_mc_fluids,node_mc_pack toneAmber
class node_skate_mode,node_skate_camera,node_mojang toneMint
class node_controller_input,node_bindings,node_asset_download toneRose
class node_player toneIndigo
```

## Components

### MW2 game

- [Game host](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/iw4l-master/src/main.rs): `crates/iw4l-master/src/main.rs`
- [MW2 gameplay](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/sim/src/match_state/client_view.rs): `crates/sim/src/match_state/client_view.rs`
- [MW2 HUD](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/hud/src/menus/mod.rs): `crates/hud/src/menus/mod.rs`
- [Map selection](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/asset_game/src/menu_catalog.rs): `crates/asset_game/src/menu_catalog.rs`

### Minecraft world

- [World server](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/server.rs): `crates/minecraft_terrain/src/server.rs`
- [Mob simulation](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/server_mobs.rs): `crates/minecraft_terrain/src/server_mobs.rs`
- [World scene](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/scene.rs): `crates/minecraft_terrain/src/scene.rs`
- [Terrain streaming](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/terrain.rs): `crates/minecraft_terrain/src/terrain.rs`
- [Terrain sections](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/sections.rs): `crates/minecraft_terrain/src/sections.rs`
- [Terrain meshes](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/mesh.rs): `crates/minecraft_terrain/src/mesh.rs`
- [World lighting](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/lighting.rs): `crates/minecraft_terrain/src/lighting.rs`
- [Fluid rendering](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/fluid.rs): `crates/minecraft_terrain/src/fluid.rs`
- [Minecraft resources](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/minecraft_terrain/src/pack.rs): `crates/minecraft_terrain/src/pack.rs`

### Skate mode

- [Skate gameplay](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/skate/crates/skate-core/src/physics/manual/controller.rs): `skate/crates/skate-core/src/physics/manual/controller.rs`
- [Skate camera](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/skate/crates/skate-core/src/camera/shot_manager.rs): `skate/crates/skate-core/src/camera/shot_manager.rs`

### Controls and assets

- [Controller input](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/input_iw4/src/weapon_select.rs): `crates/input_iw4/src/weapon_select.rs`
- [Rebindable controls](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/console/src/binds.rs): `crates/console/src/binds.rs`
- [First-run download](https://github.com/chasmlol/2010-rust-rewrite-mashup/blob/main/crates/launcher/src/first_run.rs): `crates/launcher/src/first_run.rs`

### Other components

- **Player**
- **Mojang servers**

## Connections

- Player → Game host: starts game (evidence: `README.md`)
- Game host → Map selection: offers maps (evidence: `README.md`)
- Player → Map selection: selects map (evidence: `README.md`)
- Map selection → World server: starts Minecraft map (evidence: `README.md`)
- Game host → MW2 gameplay: hosts multiplayer (evidence: `README.md`)
- Game host → MW2 HUD: presents HUD
- World server → World scene: updates blocks (evidence: `crates/minecraft_terrain/src/server.rs`)
- World server → Mob simulation: ticks mobs (evidence: `crates/minecraft_terrain/src/server.rs`)
- Terrain streaming → World scene: updates scene (evidence: `crates/minecraft_terrain/src/terrain.rs`)
- Terrain streaming → Terrain sections: builds sections (evidence: `crates/minecraft_terrain/src/terrain.rs`)
- Terrain streaming → Terrain meshes: builds meshes (evidence: `crates/minecraft_terrain/src/terrain.rs`)
- Terrain streaming → World lighting: uses lighting (evidence: `crates/minecraft_terrain/src/terrain.rs`)
- Terrain streaming → Fluid rendering: uses fluids (evidence: `crates/minecraft_terrain/src/terrain.rs`)
- World scene → Minecraft resources: uses resources (evidence: `crates/minecraft_terrain/src/scene.rs`)
- Player → Skate gameplay: enters skating (evidence: `README.md`)
- Skate gameplay → Skate camera: updates camera
- Player → Controller input: plays with controller (evidence: `README.md`)
- Controller input → Rebindable controls: supports rebinding
- First-run download → Mojang servers: downloads game files (evidence: `README.md`)
