# m0nstergamez/airplane-scoring architecture

> Architecture diagram of the GitHub repository m0nstergamez/airplane-scoring, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/m0nstergamez/airplane-scoring
- Repository: https://github.com/m0nstergamez/airplane-scoring

## Overview

airplane-scoring is a deterministic Rust airplane game with a browser/native game shell and an optional replay-verified online leaderboard. The player steers through five obstacle-themed levels; the game shell polls input, advances the pure-logic core, draws the world, and plays its sounds. At level completion, an optional board submission sends the recorded flight for server verification and ranking. Core orchestration and several subsystem links are supported by the source index; leaderboard flow is documented in the README, while unsampled server internals are not expanded.

Main entry points: [`crates/core/src/lib.rs`](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/lib.rs) (World simulation), [`crates/game/src/main.rs`](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/main.rs) (Game loop), [`crates/core/src/rng.rs`](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/rng.rs) (Seeded randomness), [`crates/game/src/board.rs`](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/board.rs) (Board client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_play["Game shell"]
  node_game["Game loop<br/>[main.rs]"]
  node_audio["Audio playback<br/>[audio.rs]"]
  node_scenery_view["Scenery renderer<br/>[scenery.rs]"]
  node_browser["Browser glue<br/>[page_js.rs]"]
end

subgraph group_core["Simulation core"]
  node_input["Input mapping<br/>[input.rs]"]
  node_tilt["Tilt controls<br/>[tilt.rs]"]
  node_world_logic["World simulation<br/>[lib.rs]"]
  node_levels["Level progression<br/>[level.rs]"]
  node_replay["Flight replay<br/>[replay.rs]"]
  node_best_times["Local best times<br/>[best_times.rs]"]
  node_collision["Collision geometry<br/>[shape.rs]"]
  node_random["Seeded randomness<br/>[rng.rs]"]
  node_sound_logic["Sound mix<br/>[sound.rs]"]
end

subgraph group_world["Level content"]
  node_level1["Beach obstacles<br/>[balloons.rs]"]
  node_huts["Huts and pads<br/>[huts.rs]"]
  node_airport["Airport<br/>[airport.rs]"]
  node_level2["Coastal gulls<br/>[gulls.rs]"]
  node_level3["Night city<br/>[city.rs]"]
  node_level4["Sunrise hazards<br/>[sunrise.rs]"]
  node_level5["Autumn forest<br/>[forest.rs]"]
  node_weather["Weather<br/>[weather.rs]"]
end

subgraph group_leaderboard["Leaderboard"]
  node_board_client["Board client<br/>[board.rs]"]
  node_web_board["Web board bridge<br/>[board.js]"]
  node_server["Board server<br/>[lib.rs]"]
  node_database[("Leaderboard database<br/>[lib.rs]")]
end

node_player(("Player"))

node_player -->|"steers"| node_game
node_game -->|"maps controls"| node_input
node_game -->|"ticks and reads"| node_world_logic
node_game -->|"drives playback"| node_audio
node_game -->|"draws scenery"| node_scenery_view
node_game -->|"reads page state"| node_browser
node_game -->|"updates board"| node_board_client
node_world_logic -->|"uses progression"| node_levels
node_world_logic -->|"records flight"| node_replay
node_world_logic -->|"tracks times"| node_best_times
node_world_logic -->|"checks overlaps"| node_collision
node_world_logic -->|"produces mix"| node_sound_logic
node_world_logic -->|"advances hazards"| node_level1
node_world_logic -->|"advances huts"| node_huts
node_world_logic -->|"manages runway"| node_airport
node_world_logic -->|"advances hazards"| node_level2
node_world_logic -->|"advances hazards"| node_level3
node_world_logic -->|"advances hazards"| node_level4
node_world_logic -->|"advances hazards"| node_level5
node_world_logic -->|"advances weather"| node_weather
node_level1 -->|"uses seeded RNG"| node_random
node_level3 -->|"uses seeded RNG"| node_random
node_level4 -->|"uses seeded RNG"| node_random
node_level5 -->|"uses seeded RNG"| node_random
node_board_client -->|"submits recording"| node_replay
node_board_client -->|"calls bridge"| node_web_board
node_web_board -->|"sends replay"| node_server
node_server -.->|"stores rankings"| node_database
node_game -.->|"supports tilt"| node_tilt
node_audio -->|"plays mix"| node_sound_logic

click node_game "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/main.rs"
click node_audio "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/audio.rs"
click node_scenery_view "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/scenery.rs"
click node_browser "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/page_js.rs"
click node_input "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/input.rs"
click node_tilt "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/tilt.rs"
click node_world_logic "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/lib.rs"
click node_levels "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/level.rs"
click node_replay "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/replay.rs"
click node_best_times "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/best_times.rs"
click node_collision "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/shape.rs"
click node_random "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/rng.rs"
click node_sound_logic "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/sound.rs"
click node_level1 "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/balloons.rs"
click node_huts "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/huts.rs"
click node_airport "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/airport.rs"
click node_level2 "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/gulls.rs"
click node_level3 "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/city.rs"
click node_level4 "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/sunrise.rs"
click node_level5 "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/forest.rs"
click node_weather "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/weather.rs"
click node_board_client "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/board.rs"
click node_web_board "https://github.com/m0nstergamez/airplane-scoring/blob/main/web/board.js"
click node_server "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/server/src/lib.rs"
click node_database "https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/server/src/lib.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,node_audio,node_scenery_view,node_browser toneBlue
class node_input,node_tilt,node_world_logic,node_levels,node_replay,node_best_times,node_collision,node_random,node_sound_logic toneAmber
class node_level1,node_huts,node_airport,node_level2,node_level3,node_level4,node_level5,node_weather toneMint
class node_board_client,node_web_board,node_server,node_database toneRose
class node_player toneIndigo
```

## Components

### Game shell

- [Game loop](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/main.rs): `crates/game/src/main.rs`
- [Audio playback](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/audio.rs): `crates/game/src/audio.rs`
- [Scenery renderer](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/scenery.rs): `crates/game/src/scenery.rs`
- [Browser glue](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/page_js.rs): `crates/game/src/page_js.rs`

### Simulation core

- [Input mapping](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/input.rs): `crates/core/src/input.rs`
- [Tilt controls](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/tilt.rs): `crates/core/src/tilt.rs`
- [World simulation](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/lib.rs): `crates/core/src/lib.rs`
- [Level progression](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/level.rs): `crates/core/src/level.rs`
- [Flight replay](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/replay.rs): `crates/core/src/replay.rs`
- [Local best times](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/best_times.rs): `crates/core/src/best_times.rs`
- [Collision geometry](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/shape.rs): `crates/core/src/shape.rs`
- [Seeded randomness](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/rng.rs): `crates/core/src/rng.rs`
- [Sound mix](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/sound.rs): `crates/core/src/sound.rs`

### Level content

- [Beach obstacles](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/balloons.rs): `crates/core/src/balloons.rs`
- [Huts and pads](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/huts.rs): `crates/core/src/huts.rs`
- [Airport](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/airport.rs): `crates/core/src/airport.rs`
- [Coastal gulls](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/gulls.rs): `crates/core/src/gulls.rs`
- [Night city](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/city.rs): `crates/core/src/city.rs`
- [Sunrise hazards](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/sunrise.rs): `crates/core/src/sunrise.rs`
- [Autumn forest](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/forest.rs): `crates/core/src/forest.rs`
- [Weather](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/core/src/weather.rs): `crates/core/src/weather.rs`

### Leaderboard

- [Board client](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/game/src/board.rs): `crates/game/src/board.rs`
- [Web board bridge](https://github.com/m0nstergamez/airplane-scoring/blob/main/web/board.js): `web/board.js`
- [Board server](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/server/src/lib.rs): `crates/server/src/lib.rs`
- [Leaderboard database](https://github.com/m0nstergamez/airplane-scoring/blob/main/crates/server/src/lib.rs): `crates/server/src/lib.rs`

### Other components

- **Player**

## Connections

- Player → Game loop: steers (evidence: `README.md`)
- Game loop → Input mapping: maps controls (evidence: `crates/game/src/main.rs`)
- Game loop → World simulation: ticks and reads (evidence: `crates/game/src/main.rs`)
- Game loop → Audio playback: drives playback (evidence: `crates/game/src/main.rs`)
- Game loop → Scenery renderer: draws scenery (evidence: `crates/game/src/main.rs`)
- Game loop → Browser glue: reads page state (evidence: `crates/game/src/main.rs`)
- Game loop → Board client: updates board (evidence: `crates/game/src/main.rs`)
- World simulation → Level progression: uses progression (evidence: `crates/core/src/lib.rs`)
- World simulation → Flight replay: records flight (evidence: `README.md`)
- World simulation → Local best times: tracks times (evidence: `crates/core/src/lib.rs`)
- World simulation → Collision geometry: checks overlaps (evidence: `crates/core/src/lib.rs`)
- World simulation → Sound mix: produces mix (evidence: `crates/core/src/lib.rs`)
- World simulation → Beach obstacles: advances hazards (evidence: `crates/core/src/lib.rs`)
- World simulation → Huts and pads: advances huts (evidence: `crates/core/src/lib.rs`)
- World simulation → Airport: manages runway (evidence: `crates/core/src/lib.rs`)
- World simulation → Coastal gulls: advances hazards (evidence: `crates/core/src/lib.rs`)
- World simulation → Night city: advances hazards (evidence: `crates/core/src/lib.rs`)
- World simulation → Sunrise hazards: advances hazards (evidence: `crates/core/src/lib.rs`)
- World simulation → Autumn forest: advances hazards (evidence: `crates/core/src/lib.rs`)
- World simulation → Weather: advances weather (evidence: `crates/core/src/lib.rs`)
- Beach obstacles → Seeded randomness: uses seeded RNG (evidence: `crates/core/src/balloons.rs`)
- Night city → Seeded randomness: uses seeded RNG (evidence: `crates/core/src/city.rs`)
- Sunrise hazards → Seeded randomness: uses seeded RNG (evidence: `crates/core/src/sunrise.rs`)
- Autumn forest → Seeded randomness: uses seeded RNG (evidence: `crates/core/src/forest.rs`)
- Board client → Flight replay: submits recording (evidence: `README.md`)
- Board client → Web board bridge: calls bridge (evidence: `crates/game/src/board.rs`)
- Web board bridge → Board server: sends replay (evidence: `README.md`)
- Board server → Leaderboard database: stores rankings (evidence: `crates/server/src/lib.rs`)
- Game loop → Tilt controls: supports tilt
- Audio playback → Sound mix: plays mix (evidence: `crates/game/src/audio.rs`)
