# wolfnetworkofc/formularacing-wolf-network architecture

> Architecture diagram of the GitHub repository wolfnetworkofc/formularacing-wolf-network, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-02). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/wolfnetworkofc/formularacing-wolf-network
- Repository: https://github.com/wolfnetworkofc/formularacing-wolf-network

## Overview

FormulaRacing is a Paper Minecraft racing plugin. Players start time trials, quick races, group races, or duels; race sessions track progress and produce results, while events and leagues provide championship structure. The README also documents AI opponents, track editing, ghosts, customizable boat physics, and Bedrock support, so these appear as separate capability branches. Edges are limited to README-documented capabilities and relationships visible in the supplied source index or excerpts; unsampled internals are not inferred.

Main entry points: [`src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java) (Plugin bootstrap), [`src/main/java/dev/EfraGroup/formulaRacing/Command`](https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/Command) (Player commands), [`src/main/java/dev/EfraGroup/formulaRacing/Controllers/QuickRaceManager.java`](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/QuickRaceManager.java) (Quick races), [`src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java`](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java) (Event lifecycle)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_racing["Race sessions"]
  node_quickrace["Quick races"]
  node_timetrial["Time trials"]
  node_duels["Race duels"]
  node_heats["Heat sessions<br/>[Heats.java]"]
  node_race_logic["Race logic<br/>[RaceSession.java]"]
  node_drivers["Driver progress<br/>[Driver.java]"]
end

subgraph group_competition["Events and competition"]
  node_events["Race events"]
  node_event_domain["Event lifecycle<br/>[Events.java]"]
  node_rounds["Rounds<br/>[Rounds.java]"]
  node_leagues["Leagues"]
  node_medals["Medals<br/>[MedalManager.java]"]
end

subgraph group_capabilities["Race capabilities"]
  node_ai["AI opponents"]
  node_tracks["Tracks and editor"]
  node_ghosts["Race ghosts<br/>[GhostManager.java]"]
  node_boat_physics["Boat physics"]
  node_bedrock["Bedrock interface"]
end

subgraph group_platform["Plugin platform"]
  node_plugin["Plugin bootstrap<br/>[FormulaRacing.java]"]
  node_commands["Player commands"]
  node_api["Live API<br/>[ApiManager.java]"]
end

subgraph group_persistence["Storage"]
  node_database[("Race database")]
end

node_players(("Players"))

node_players -->|"issue commands"| node_commands
node_commands -->|"start quick races"| node_quickrace
node_commands -->|"start time trials"| node_timetrial
node_commands -->|"start duels"| node_duels
node_quickrace -->|"manages heats"| node_heats
node_events -->|"manages events"| node_event_domain
node_event_domain -->|"contains rounds"| node_rounds
node_event_domain -->|"reports results"| node_leagues
node_heats -->|"tracks drivers"| node_drivers
node_players -->|"edit tracks"| node_tracks
node_players -->|"race AI"| node_ai
node_players -->|"race ghosts"| node_ghosts
node_players -->|"configure physics"| node_boat_physics
node_players -->|"use adapted UI"| node_bedrock
node_plugin -->|"initializes"| node_ai
node_plugin -->|"initializes"| node_leagues
node_plugin -->|"initializes"| node_api
node_plugin -->|"initializes"| node_ghosts
node_quickrace -->|"uses database"| node_database
node_ai -->|"uses track integration"| node_tracks
node_medals -->|"reads and writes"| node_database

click node_plugin "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java"
click node_commands "https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/Command"
click node_quickrace "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/QuickRaceManager.java"
click node_timetrial "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/TimeTrial/TimeTrialController.java"
click node_duels "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Duels/TimeTrialDuels.java"
click node_heats "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Heat/Heats.java"
click node_race_logic "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Heat/Logic/RaceSession.java"
click node_drivers "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Participant/Driver.java"
click node_events "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/RaceEventManager.java"
click node_event_domain "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java"
click node_rounds "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Round/Rounds.java"
click node_leagues "https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/League"
click node_ai "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/AI/AIOpponentManager.java"
click node_tracks "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/TrackIntegrationManager.java"
click node_ghosts "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Ghost/GhostManager.java"
click node_boat_physics "https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/BoatUtils"
click node_bedrock "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Gui/BedrockFormListener.java"
click node_database "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Database/DatabaseManager.java"
click node_api "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Api/ApiManager.java"
click node_medals "https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Medals/MedalManager.java"

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_quickrace,node_timetrial,node_duels,node_heats,node_race_logic,node_drivers toneBlue
class node_events,node_event_domain,node_rounds,node_leagues,node_medals toneAmber
class node_ai,node_tracks,node_ghosts,node_boat_physics,node_bedrock toneMint
class node_plugin,node_commands,node_api toneRose
class node_database,node_players toneIndigo
```

## Components

### Race sessions

- [Quick races](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/QuickRaceManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Controllers/QuickRaceManager.java`
- [Time trials](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/TimeTrial/TimeTrialController.java): `src/main/java/dev/EfraGroup/formulaRacing/TimeTrial/TimeTrialController.java`
- [Race duels](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Duels/TimeTrialDuels.java): `src/main/java/dev/EfraGroup/formulaRacing/Duels/TimeTrialDuels.java`
- [Heat sessions](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Heat/Heats.java): `src/main/java/dev/EfraGroup/formulaRacing/Heat/Heats.java`
- [Race logic](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Heat/Logic/RaceSession.java): `src/main/java/dev/EfraGroup/formulaRacing/Heat/Logic/RaceSession.java`
- [Driver progress](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Participant/Driver.java): `src/main/java/dev/EfraGroup/formulaRacing/Participant/Driver.java`

### Events and competition

- [Race events](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/RaceEventManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Controllers/RaceEventManager.java`
- [Event lifecycle](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java): `src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java`
- [Rounds](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Round/Rounds.java): `src/main/java/dev/EfraGroup/formulaRacing/Round/Rounds.java`
- [Leagues](https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/League): `src/main/java/dev/EfraGroup/formulaRacing/League`
- [Medals](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Medals/MedalManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Medals/MedalManager.java`

### Race capabilities

- [AI opponents](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/AI/AIOpponentManager.java): `src/main/java/dev/EfraGroup/formulaRacing/AI/AIOpponentManager.java`
- [Tracks and editor](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Controllers/TrackIntegrationManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Controllers/TrackIntegrationManager.java`
- [Race ghosts](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Ghost/GhostManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Ghost/GhostManager.java`
- [Boat physics](https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/BoatUtils): `src/main/java/dev/EfraGroup/formulaRacing/BoatUtils`
- [Bedrock interface](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Gui/BedrockFormListener.java): `src/main/java/dev/EfraGroup/formulaRacing/Gui/BedrockFormListener.java`

### Plugin platform

- [Plugin bootstrap](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java): `src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`
- [Player commands](https://github.com/wolfnetworkofc/formularacing-wolf-network/tree/master/src/main/java/dev/EfraGroup/formulaRacing/Command): `src/main/java/dev/EfraGroup/formulaRacing/Command`
- [Live API](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Api/ApiManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Api/ApiManager.java`

### Storage

- [Race database](https://github.com/wolfnetworkofc/formularacing-wolf-network/blob/master/src/main/java/dev/EfraGroup/formulaRacing/Database/DatabaseManager.java): `src/main/java/dev/EfraGroup/formulaRacing/Database/DatabaseManager.java`

### Other components

- **Players**

## Connections

- Players → Player commands: issue commands (evidence: `README.md`)
- Player commands → Quick races: start quick races (evidence: `README.md`)
- Player commands → Time trials: start time trials (evidence: `README.md`)
- Player commands → Race duels: start duels (evidence: `README.md`)
- Quick races → Heat sessions: manages heats (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Heat/Heats.java`)
- Race events → Event lifecycle: manages events (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java`)
- Event lifecycle → Rounds: contains rounds (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java`)
- Event lifecycle → Leagues: reports results (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Event/Events.java`)
- Heat sessions → Driver progress: tracks drivers (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Heat/Heats.java`)
- Players → Tracks and editor: edit tracks (evidence: `README.md`)
- Players → AI opponents: race AI (evidence: `README.md`)
- Players → Race ghosts: race ghosts (evidence: `README.md`)
- Players → Boat physics: configure physics (evidence: `README.md`)
- Players → Bedrock interface: use adapted UI (evidence: `README.md`)
- Plugin bootstrap → AI opponents: initializes (evidence: `src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`)
- Plugin bootstrap → Leagues: initializes (evidence: `src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`)
- Plugin bootstrap → Live API: initializes (evidence: `src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`)
- Plugin bootstrap → Race ghosts: initializes (evidence: `src/main/java/dev/EfraGroup/formulaRacing/FormulaRacing.java`)
- Quick races → Race database: uses database
- AI opponents → Tracks and editor: uses track integration (evidence: `src/main/java/dev/EfraGroup/formulaRacing/AI/AIOpponentManager.java`)
- Medals → Race database: reads and writes (evidence: `src/main/java/dev/EfraGroup/formulaRacing/Medals/MedalManager.java`)
