How eneaferri/altf1-racing works
AltF1 Racing is a browser-based arcade racing game, with single-player and online multiplayer modes. The principal workflow is choosing a mode and circuit, driving through the shared simulation, and viewing the race in the client. Online play adds a server-managed lobby and rooms; clients exchange input and receive game updates. Shared modules also define track data and race rules, while OpenF1 tools support real-circuit content generation. The map follows the README and available index references; unsampled multiplayer and rendering internals limit some links.
Main entry points: SinglePlayerGame.ts Single-Player Game · GameServer.ts Game Server · game.ts Race Simulation · main.ts Client Entry
Components 24
Browser Client
- Client Entry
01_packages/client/src/main.ts - Mode Menu
01_packages/client/src/view/menu/ModeMenu.ts - Single-Player Game
01_packages/client/src/singleplayer/SinglePlayerGame.ts - Keyboard Input
01_packages/client/src/controller/KeyboardController.ts - Game Loop
01_packages/client/src/core/GameLoop.ts - Race Scene
01_packages/client/src/view/SceneView.ts - Race HUD
01_packages/client/src/view/hud/Hud.ts - Multiplayer Setup
01_packages/client/src/multiplayer/start.ts - Network Client
01_packages/client/src/multiplayer/NetClient.ts - Online Race
01_packages/client/src/multiplayer/OnlineGame.ts
Online Server
- Game Server
01_packages/server/src/GameServer.ts - Lobby
01_packages/server/src/Lobby.ts - Race Room
01_packages/server/src/Room.ts - Grand Prix
01_packages/server/src/GrandPrix.ts - Lap Records
01_packages/server/src/LapRecords.ts
Shared Game Runtime
- Race Simulation
01_packages/shared/src/sim/game.ts - Car Physics
01_packages/shared/src/sim/car.ts - Track Queries
01_packages/shared/src/track/query.ts - Online Sim Setup
01_packages/shared/src/net/simContext.ts - Track Builder
01_packages/shared/src/track/buildTrack.ts
Circuit Content
- OpenF1 Circuit Tools
01_tools/openf1/generate.ts - Circuit Definitions
01_tools/openf1/circuits.ts
Other components
- Player
- Browser
Connections 23
- Player → Browser: plays in
README.md - Browser → Client Entry: opens
README.md - Client Entry → Mode Menu: shows
01_packages/client/src/main.ts - Client Entry → Single-Player Game: starts
01_packages/client/src/main.ts - Client Entry → Multiplayer Setup: starts
01_packages/client/src/main.ts - Player → Mode Menu: chooses mode
README.md - Single-Player Game → Keyboard Input: samples input
01_packages/client/src/singleplayer/SinglePlayerGame.ts - Single-Player Game → Game Loop: uses loop
01_packages/client/src/singleplayer/SinglePlayerGame.ts - Single-Player Game → Race Simulation: advances
01_packages/shared/src/sim/game.ts - Single-Player Game → Race Scene: renders race
01_packages/client/src/singleplayer/SinglePlayerGame.ts - Single-Player Game → Race HUD: updates display
01_packages/client/src/singleplayer/SinglePlayerGame.ts - Multiplayer Setup → Network Client: connects
- Network Client → Game Server: exchanges messages
- Online Race → Race Simulation: predicts locally
- Game Server → Lobby: manages
01_packages/server/src/GameServer.ts - Game Server → Race Room: routes race play
01_packages/server/src/GameServer.ts - Game Server → Grand Prix: delegates GP
01_packages/server/src/GameServer.ts - Game Server → Lap Records: uses records
01_packages/server/src/GameServer.ts - Race Simulation → Car Physics: advances cars
01_packages/shared/src/sim/game.ts - Race Simulation → Track Queries: queries track
01_packages/shared/src/sim/game.ts - Online Sim Setup → Race Simulation: configures
01_packages/shared/src/net/simContext.ts - OpenF1 Circuit Tools → Circuit Definitions: uses definitions
01_tools/openf1/scenery.ts - OpenF1 Circuit Tools → Track Builder: produces track content