# u3264128/back-to-skool architecture

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

- Interactive diagram: https://gitdiagram.com/u3264128/back-to-skool
- Repository: https://github.com/u3264128/back-to-skool

## Overview

Back to Skool is a playable Commodore 64 game port. The principal workflow is starting from the title, controlling Eric through the school, solving puzzles, and reaching the safe to begin the next school year. The graph preserves documented game, camera, and video capabilities. Assembly responsibilities are inferred only from filenames and README descriptions; the source excerpts do not show runtime calls, so component-to-component edges are omitted.

Main entry points: [`src/main.s`](https://github.com/u3264128/back-to-skool/blob/main/src/main.s) (Game flow), [`src/scroll_bands.s`](https://github.com/u3264128/back-to-skool/blob/main/src/scroll_bands.s) (Smooth camera), [`src/column_wipe.s`](https://github.com/u3264128/back-to-skool/blob/main/src/column_wipe.s) (Column camera), [`src/video.s`](https://github.com/u3264128/back-to-skool/blob/main/src/video.s) (Video output)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Game world"]
  node_game["Game flow<br/>[main.s]"]
  node_cast["School cast<br/>[actors.s]"]
  node_timetable["Timetable<br/>[main.s]"]
  node_puzzles["School puzzles<br/>[main.s]"]
end

subgraph group_runtime["C64 runtime"]
  node_cpu["CPU engine<br/>[cpu.s]"]
  node_platform["C64 platform<br/>[platform.s]"]
  node_sid["SID sound"]
end

subgraph group_display["Display and camera"]
  node_video["Video output<br/>[video.s]"]
  node_smooth["Smooth camera<br/>[scroll_bands.s]"]
  node_column["Column camera<br/>[column_wipe.s]"]
end

node_player(("Player"))

node_player -->|"starts and controls"| node_game
node_player -->|"meets and renames"| node_cast
node_player -->|"solves"| node_puzzles
node_game -->|"runs lessons"| node_timetable
node_game -->|"uses sound"| node_sid
node_game -->|"offers camera"| node_smooth
node_game -->|"offers variant"| node_column
node_smooth -->|"displays scrolling"| node_video
node_column -->|"displays transitions"| node_video

click node_game "https://github.com/u3264128/back-to-skool/blob/main/src/main.s"
click node_cast "https://github.com/u3264128/back-to-skool/blob/main/src/actors.s"
click node_timetable "https://github.com/u3264128/back-to-skool/blob/main/src/main.s"
click node_puzzles "https://github.com/u3264128/back-to-skool/blob/main/src/main.s"
click node_cpu "https://github.com/u3264128/back-to-skool/blob/main/src/cpu.s"
click node_platform "https://github.com/u3264128/back-to-skool/blob/main/src/platform.s"
click node_video "https://github.com/u3264128/back-to-skool/blob/main/src/video.s"
click node_smooth "https://github.com/u3264128/back-to-skool/blob/main/src/scroll_bands.s"
click node_column "https://github.com/u3264128/back-to-skool/blob/main/src/column_wipe.s"

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_cast,node_timetable,node_puzzles toneBlue
class node_cpu,node_platform,node_sid toneAmber
class node_video,node_smooth,node_column toneMint
class node_player toneIndigo
```

## Components

### Game world

- [Game flow](https://github.com/u3264128/back-to-skool/blob/main/src/main.s): `src/main.s`
- [School cast](https://github.com/u3264128/back-to-skool/blob/main/src/actors.s): `src/actors.s`
- [Timetable](https://github.com/u3264128/back-to-skool/blob/main/src/main.s): `src/main.s`
- [School puzzles](https://github.com/u3264128/back-to-skool/blob/main/src/main.s): `src/main.s`

### C64 runtime

- [CPU engine](https://github.com/u3264128/back-to-skool/blob/main/src/cpu.s): `src/cpu.s`
- [C64 platform](https://github.com/u3264128/back-to-skool/blob/main/src/platform.s): `src/platform.s`
- **SID sound**

### Display and camera

- [Video output](https://github.com/u3264128/back-to-skool/blob/main/src/video.s): `src/video.s`
- [Smooth camera](https://github.com/u3264128/back-to-skool/blob/main/src/scroll_bands.s): `src/scroll_bands.s`
- [Column camera](https://github.com/u3264128/back-to-skool/blob/main/src/column_wipe.s): `src/column_wipe.s`

### Other components

- **Player**

## Connections

- Player → Game flow: starts and controls (evidence: `README.md`)
- Player → School cast: meets and renames (evidence: `README.md`)
- Player → School puzzles: solves (evidence: `README.md`)
- Game flow → Timetable: runs lessons (evidence: `README.md`)
- Game flow → SID sound: uses sound (evidence: `README.md`)
- Game flow → Smooth camera: offers camera (evidence: `README.md`)
- Game flow → Column camera: offers variant (evidence: `README.md`)
- Smooth camera → Video output: displays scrolling (evidence: `README.md`)
- Column camera → Video output: displays transitions (evidence: `README.md`)
