# grabowmar/boscali-summer architecture

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

- Interactive diagram: https://gitdiagram.com/grabowmar/boscali-summer
- Repository: https://github.com/grabowmar/boscali-summer

## Overview

Boscali Summer is a Unity/BepInEx game mod that adds flight, command, communications, campaign, and world-simulation features. The main user-facing flow is through in-game HUD/MFD and map interfaces: players inspect information or issue requests, module managers evaluate or coordinate them, and game state or networked effects follow. The repository also contains a reusable Avionics UI toolkit and several independent simulation systems. The README is empty; connections below are limited to the supplied source excerpts and SOURCE INDEX references, so unsampled subsystem wiring is omitted.

Main entry points: [`Core/Plugin.cs`](https://github.com/grabowmar/boscali-summer/blob/main/Core/Plugin.cs) (Plugin entry), [`AvionicsUi`](https://github.com/grabowmar/boscali-summer/tree/main/AvionicsUi) (Avionics toolkit), [`modules/Comms/Runtime/CommsManager.cs`](https://github.com/grabowmar/boscali-summer/blob/main/modules/Comms/Runtime/CommsManager.cs) (Communications), [`Core/Services/ServiceRegistry.cs`](https://github.com/grabowmar/boscali-summer/blob/main/Core/Services/ServiceRegistry.cs) (Service registry)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Mod foundation"]
  node_plugin["Plugin entry<br/>[Plugin.cs]"]
  node_service_registry["Service registry<br/>[ServiceRegistry.cs]"]
  node_module_services["Module services<br/>[ModuleServices.cs]"]
  node_deterministic["Deterministic math<br/>[Deterministic.cs]"]
end

subgraph group_flight["Flight experience"]
  node_wing_pipeline["Tiltwing control"]
  node_fixed_pipeline["Fixed-wing control"]
  node_rotary_pipeline["Rotary control<br/>[RotaryPipeline.cs]"]
  node_hud["HUD features"]
  node_autopilot["Autopilot features"]
end

subgraph group_operations["Operations and comms"]
  node_command["Command and maps"]
  node_comms_manager["Communications<br/>[CommsManager.cs]"]
  node_events_manager["Dynamic events<br/>[EventsManager.cs]"]
  node_operations_manager["Dynamic operations"]
  node_support_manager["Support requests<br/>[SupportManager.cs]"]
  node_squad_manager["Squad progression<br/>[SquadManager.cs]"]
end

subgraph group_simulation["World simulation"]
  node_weather_manager["Weather simulation<br/>[WeatherManager.cs]"]
  node_fire_manager["Fire and destruction"]
  node_urban_manager["Urban combat"]
  node_radio_manager["Radio playback<br/>[RadioManager.cs]"]
  node_trench_manager["Trench systems<br/>[TrenchManager.cs]"]
end

subgraph group_ui["Avionics UI"]
  node_avionics_sound["Avionics sound<br/>[AvUiSound.cs]"]
  node_avionics_toolkit["Avionics toolkit"]
end

node_player(("Player"))

node_player -.->|"launches mod"| node_plugin
node_plugin -->|"configures UI"| node_avionics_sound
node_plugin -->|"loads bundle"| node_avionics_toolkit
node_plugin -.->|"starts mod"| node_command
node_wing_pipeline -->|"delegates plane mode"| node_fixed_pipeline
node_wing_pipeline -->|"delegates rotary mode"| node_rotary_pipeline
node_comms_manager -->|"plays cues"| node_avionics_sound
node_comms_manager -->|"uses map picker"| node_avionics_toolkit
node_comms_manager -->|"queries services"| node_module_services
node_events_manager -->|"selects events"| node_deterministic
node_events_manager -.->|"presents event panel"| node_avionics_toolkit
node_operations_manager -->|"queries services"| node_module_services
node_support_manager -->|"queries services"| node_module_services
node_support_manager -->|"plays cues"| node_avionics_sound
node_weather_manager -.->|"samples weather"| node_deterministic
node_fire_manager -->|"varies fire spread"| node_deterministic
node_urban_manager -.->|"uses UI services"| node_avionics_toolkit
node_radio_manager -->|"registers services"| node_service_registry
node_squad_manager -->|"registers services"| node_service_registry
node_trench_manager -.->|"uses services"| node_service_registry

click node_plugin "https://github.com/grabowmar/boscali-summer/blob/main/Core/Plugin.cs"
click node_service_registry "https://github.com/grabowmar/boscali-summer/blob/main/Core/Services/ServiceRegistry.cs"
click node_module_services "https://github.com/grabowmar/boscali-summer/blob/main/Core/Services/ModuleServices.cs"
click node_deterministic "https://github.com/grabowmar/boscali-summer/blob/main/Core/Math/Deterministic.cs"
click node_wing_pipeline "https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/TiltwingPipeline.cs"
click node_fixed_pipeline "https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/FixedWingPipeline.cs"
click node_rotary_pipeline "https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/RotaryPipeline.cs"
click node_hud "https://github.com/grabowmar/boscali-summer/tree/main/modules/Hud"
click node_autopilot "https://github.com/grabowmar/boscali-summer/tree/main/modules/Autopilot"
click node_avionics_sound "https://github.com/grabowmar/boscali-summer/blob/main/AvionicsUi/AvUiSound.cs"
click node_avionics_toolkit "https://github.com/grabowmar/boscali-summer/tree/main/AvionicsUi"
click node_command "https://github.com/grabowmar/boscali-summer/tree/main/modules/Command"
click node_comms_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Comms/Runtime/CommsManager.cs"
click node_events_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Events/Runtime/EventsManager.cs"
click node_operations_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/DynamicOperations/Runtime/OperationsManager.cs"
click node_support_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Support/Runtime/SupportManager.cs"
click node_weather_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Weather/Runtime/WeatherManager.cs"
click node_fire_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/FireAndDestruction/Runtime/ImpactFireManager.cs"
click node_urban_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/UrbanCombat/Runtime/ZoneGarrisonManager.cs"
click node_radio_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Radio/Runtime/RadioManager.cs"
click node_squad_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Squad/Runtime/SquadManager.cs"
click node_trench_manager "https://github.com/grabowmar/boscali-summer/blob/main/modules/Trenches/Runtime/TrenchManager.cs"

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_plugin,node_service_registry,node_module_services,node_deterministic toneBlue
class node_wing_pipeline,node_fixed_pipeline,node_rotary_pipeline,node_hud,node_autopilot toneAmber
class node_command,node_comms_manager,node_events_manager,node_operations_manager,node_support_manager,node_squad_manager toneMint
class node_weather_manager,node_fire_manager,node_urban_manager,node_radio_manager,node_trench_manager toneRose
class node_avionics_sound,node_avionics_toolkit,node_player toneIndigo
```

## Components

### Mod foundation

- [Plugin entry](https://github.com/grabowmar/boscali-summer/blob/main/Core/Plugin.cs): `Core/Plugin.cs`
- [Service registry](https://github.com/grabowmar/boscali-summer/blob/main/Core/Services/ServiceRegistry.cs): `Core/Services/ServiceRegistry.cs`
- [Module services](https://github.com/grabowmar/boscali-summer/blob/main/Core/Services/ModuleServices.cs): `Core/Services/ModuleServices.cs`
- [Deterministic math](https://github.com/grabowmar/boscali-summer/blob/main/Core/Math/Deterministic.cs): `Core/Math/Deterministic.cs`

### Flight experience

- [Tiltwing control](https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/TiltwingPipeline.cs): `modules/Wing/Domain/Control/TiltwingPipeline.cs`
- [Fixed-wing control](https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/FixedWingPipeline.cs): `modules/Wing/Domain/Control/FixedWingPipeline.cs`
- [Rotary control](https://github.com/grabowmar/boscali-summer/blob/main/modules/Wing/Domain/Control/RotaryPipeline.cs): `modules/Wing/Domain/Control/RotaryPipeline.cs`
- [HUD features](https://github.com/grabowmar/boscali-summer/tree/main/modules/Hud): `modules/Hud`
- [Autopilot features](https://github.com/grabowmar/boscali-summer/tree/main/modules/Autopilot): `modules/Autopilot`

### Operations and comms

- [Command and maps](https://github.com/grabowmar/boscali-summer/tree/main/modules/Command): `modules/Command`
- [Communications](https://github.com/grabowmar/boscali-summer/blob/main/modules/Comms/Runtime/CommsManager.cs): `modules/Comms/Runtime/CommsManager.cs`
- [Dynamic events](https://github.com/grabowmar/boscali-summer/blob/main/modules/Events/Runtime/EventsManager.cs): `modules/Events/Runtime/EventsManager.cs`
- [Dynamic operations](https://github.com/grabowmar/boscali-summer/blob/main/modules/DynamicOperations/Runtime/OperationsManager.cs): `modules/DynamicOperations/Runtime/OperationsManager.cs`
- [Support requests](https://github.com/grabowmar/boscali-summer/blob/main/modules/Support/Runtime/SupportManager.cs): `modules/Support/Runtime/SupportManager.cs`
- [Squad progression](https://github.com/grabowmar/boscali-summer/blob/main/modules/Squad/Runtime/SquadManager.cs): `modules/Squad/Runtime/SquadManager.cs`

### World simulation

- [Weather simulation](https://github.com/grabowmar/boscali-summer/blob/main/modules/Weather/Runtime/WeatherManager.cs): `modules/Weather/Runtime/WeatherManager.cs`
- [Fire and destruction](https://github.com/grabowmar/boscali-summer/blob/main/modules/FireAndDestruction/Runtime/ImpactFireManager.cs): `modules/FireAndDestruction/Runtime/ImpactFireManager.cs`
- [Urban combat](https://github.com/grabowmar/boscali-summer/blob/main/modules/UrbanCombat/Runtime/ZoneGarrisonManager.cs): `modules/UrbanCombat/Runtime/ZoneGarrisonManager.cs`
- [Radio playback](https://github.com/grabowmar/boscali-summer/blob/main/modules/Radio/Runtime/RadioManager.cs): `modules/Radio/Runtime/RadioManager.cs`
- [Trench systems](https://github.com/grabowmar/boscali-summer/blob/main/modules/Trenches/Runtime/TrenchManager.cs): `modules/Trenches/Runtime/TrenchManager.cs`

### Avionics UI

- [Avionics sound](https://github.com/grabowmar/boscali-summer/blob/main/AvionicsUi/AvUiSound.cs): `AvionicsUi/AvUiSound.cs`
- [Avionics toolkit](https://github.com/grabowmar/boscali-summer/tree/main/AvionicsUi): `AvionicsUi`

### Other components

- **Player**

## Connections

- Player → Plugin entry: launches mod
- Plugin entry → Avionics sound: configures UI (evidence: `Core/Plugin.cs`)
- Plugin entry → Avionics toolkit: loads bundle (evidence: `Core/Plugin.cs`)
- Plugin entry → Command and maps: starts mod
- Tiltwing control → Fixed-wing control: delegates plane mode (evidence: `modules/Wing/Domain/Control/TiltwingPipeline.cs`)
- Tiltwing control → Rotary control: delegates rotary mode (evidence: `modules/Wing/Domain/Control/TiltwingPipeline.cs`)
- Communications → Avionics sound: plays cues (evidence: `modules/Comms/Runtime/CommsManager.cs`)
- Communications → Avionics toolkit: uses map picker (evidence: `modules/Comms/Runtime/CommsManager.cs`)
- Communications → Module services: queries services (evidence: `modules/Comms/Runtime/CommsManager.cs`)
- Dynamic events → Deterministic math: selects events (evidence: `modules/Events/Runtime/EventsManager.cs`)
- Dynamic events → Avionics toolkit: presents event panel
- Dynamic operations → Module services: queries services (evidence: `modules/DynamicOperations/Runtime/OperationsManager.cs`)
- Support requests → Module services: queries services (evidence: `modules/Support/Runtime/SupportManager.cs`)
- Support requests → Avionics sound: plays cues (evidence: `modules/Support/Presentation/CallsController.cs`)
- Weather simulation → Deterministic math: samples weather
- Fire and destruction → Deterministic math: varies fire spread (evidence: `modules/FireAndDestruction/Runtime/ImpactFireManager.cs`)
- Urban combat → Avionics toolkit: uses UI services
- Radio playback → Service registry: registers services (evidence: `modules/Radio/Runtime/RadioManager.cs`)
- Squad progression → Service registry: registers services (evidence: `modules/Squad/Runtime/SquadManager.cs`)
- Trench systems → Service registry: uses services
