# duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option architecture

> Architecture diagram of the GitHub repository duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option, 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/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option
- Repository: https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option

## Overview

FS-20 Vortex FCS is a Nuclear Option flight-control mod. The principal workflow is pilot input entering the game hooks, reaching a per-aircraft controller, then being allocated across control effectors and applied to the aircraft. Distinct branches add STOVL hover/throttle laws, fuel balancing and release protection, and aerodynamic changes such as staggered stall and drag relief. The graph includes documented capabilities whose exact call paths were not sampled; dashed links mark unverified integrations. Source excerpts are partial, so some relationships and subsystem internals remain uncertain.

Main entry points: [`Vortex_FS20.FCS/Plugin.cs`](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Plugin.cs) (Plugin Setup), [`Vortex_FS20.FCS/FcsController.cs`](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FcsController.cs) (FCS Controller), [`Vortex_FS20.FCS/Allocator.cs`](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Allocator.cs) (Control Allocator), [`Vortex_FS20.FCS/Hooks.cs`](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Hooks.cs) (Flight Hooks)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_integration["Game Integration"]
  node_plugin["Plugin Setup<br/>[Plugin.cs]"]
  node_hooks["Flight Hooks<br/>[Hooks.cs]"]
  node_registry["Aircraft Registry<br/>[Registry.cs]"]
end

subgraph group_control["Flight Control"]
  node_controller["FCS Controller<br/>[FcsController.cs]"]
  node_allocator["Control Allocator<br/>[Allocator.cs]"]
  node_effector["Effector Model<br/>[Effector.cs]"]
  node_surfaces["Surface Effectors<br/>[SurfaceEffector.cs]"]
  node_tvc["Vectoring Effectors<br/>[TvcEffector.cs]"]
  node_native["Native Solver<br/>[FcsNative.cs]"]
  node_nativecore["Native Core<br/>[lib.rs]"]
end

subgraph group_stovl["STOVL Control"]
  node_stovl["STOVL Laws<br/>[Stovl.cs]"]
  node_stovlhooks["STOVL Hooks<br/>[StovlHooks.cs]"]
  node_throttle["Throttle Detent<br/>[ThrottleDetent.cs]"]
  node_vanebox["Vane Box<br/>[VaneBox.cs]"]
end

subgraph group_airframe["Airframe Systems"]
  node_fuel["Fuel Balance<br/>[FuelBalance.cs]"]
  node_guard["Release Guard<br/>[ReleaseGuard.cs]"]
  node_stall["Stall Stagger<br/>[StallStagger.cs]"]
  node_drag["Drag Relief<br/>[DragRelief.cs]"]
end

subgraph group_feedback["Feedback and UI"]
  node_telemetry["Telemetry<br/>[Telemetry.cs]"]
  node_hud["Throttle HUD<br/>[HudThrottle.cs]"]
end

node_pilot(("Pilot"))
node_game["Nuclear Option"]

node_pilot -->|"provides controls"| node_game
node_game -->|"dispatches hooks"| node_hooks
node_plugin -->|"patches methods"| node_hooks
node_hooks -->|"ticks controller"| node_controller
node_registry -->|"creates controller"| node_controller
node_controller -.->|"solves allocation"| node_allocator
node_allocator -->|"allocates commands"| node_effector
node_controller -->|"uses surfaces"| node_surfaces
node_surfaces -->|"extends model"| node_effector
node_controller -.->|"uses vectoring"| node_tvc
node_allocator -->|"delegates solve"| node_native
node_native -.->|"uses native library"| node_nativecore
node_plugin -->|"enables STOVL"| node_stovl
node_stovlhooks -->|"connects STOVL"| node_controller
node_plugin -->|"registers hooks"| node_stovlhooks
node_plugin -->|"configures throttle"| node_throttle
node_throttle -->|"updates display"| node_hud
node_plugin -->|"configures vane box"| node_vanebox
node_plugin -->|"configures balancing"| node_fuel
node_plugin -->|"configures guard"| node_guard
node_plugin -->|"configures stall model"| node_stall
node_plugin -->|"configures drag relief"| node_drag
node_registry -->|"registers jobs"| node_stall
node_plugin -->|"configures telemetry"| node_telemetry

click node_plugin "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Plugin.cs"
click node_hooks "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Hooks.cs"
click node_registry "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Registry.cs"
click node_controller "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FcsController.cs"
click node_allocator "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Allocator.cs"
click node_effector "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Effector.cs"
click node_surfaces "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/SurfaceEffector.cs"
click node_tvc "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/TvcEffector.cs"
click node_native "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FcsNative.cs"
click node_nativecore "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/native/fcs_core/src/lib.rs"
click node_stovl "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Stovl.cs"
click node_stovlhooks "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/StovlHooks.cs"
click node_throttle "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/ThrottleDetent.cs"
click node_vanebox "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/VaneBox.cs"
click node_fuel "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FuelBalance.cs"
click node_guard "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/ReleaseGuard.cs"
click node_stall "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/StallStagger.cs"
click node_drag "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/DragRelief.cs"
click node_telemetry "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Telemetry.cs"
click node_hud "https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/HudThrottle.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_hooks,node_registry toneBlue
class node_controller,node_allocator,node_effector,node_surfaces,node_tvc,node_native,node_nativecore toneAmber
class node_stovl,node_stovlhooks,node_throttle,node_vanebox toneMint
class node_fuel,node_guard,node_stall,node_drag toneRose
class node_telemetry,node_hud,node_pilot,node_game toneIndigo
```

## Components

### Game Integration

- [Plugin Setup](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Plugin.cs): `Vortex_FS20.FCS/Plugin.cs`
- [Flight Hooks](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Hooks.cs): `Vortex_FS20.FCS/Hooks.cs`
- [Aircraft Registry](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Registry.cs): `Vortex_FS20.FCS/Registry.cs`

### Flight Control

- [FCS Controller](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FcsController.cs): `Vortex_FS20.FCS/FcsController.cs`
- [Control Allocator](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Allocator.cs): `Vortex_FS20.FCS/Allocator.cs`
- [Effector Model](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Effector.cs): `Vortex_FS20.FCS/Effector.cs`
- [Surface Effectors](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/SurfaceEffector.cs): `Vortex_FS20.FCS/SurfaceEffector.cs`
- [Vectoring Effectors](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/TvcEffector.cs): `Vortex_FS20.FCS/TvcEffector.cs`
- [Native Solver](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FcsNative.cs): `Vortex_FS20.FCS/FcsNative.cs`
- [Native Core](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/native/fcs_core/src/lib.rs): `native/fcs_core/src/lib.rs`

### STOVL Control

- [STOVL Laws](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Stovl.cs): `Vortex_FS20.FCS/Stovl.cs`
- [STOVL Hooks](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/StovlHooks.cs): `Vortex_FS20.FCS/StovlHooks.cs`
- [Throttle Detent](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/ThrottleDetent.cs): `Vortex_FS20.FCS/ThrottleDetent.cs`
- [Vane Box](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/VaneBox.cs): `Vortex_FS20.FCS/VaneBox.cs`

### Airframe Systems

- [Fuel Balance](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/FuelBalance.cs): `Vortex_FS20.FCS/FuelBalance.cs`
- [Release Guard](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/ReleaseGuard.cs): `Vortex_FS20.FCS/ReleaseGuard.cs`
- [Stall Stagger](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/StallStagger.cs): `Vortex_FS20.FCS/StallStagger.cs`
- [Drag Relief](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/DragRelief.cs): `Vortex_FS20.FCS/DragRelief.cs`

### Feedback and UI

- [Telemetry](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/Telemetry.cs): `Vortex_FS20.FCS/Telemetry.cs`
- [Throttle HUD](https://github.com/duythinh2022-ui/advanced-flight-controls-system-for-fs-20-vortex-nuclear-option/blob/main/Vortex_FS20.FCS/HudThrottle.cs): `Vortex_FS20.FCS/HudThrottle.cs`

### Other components

- **Pilot**
- **Nuclear Option**

## Connections

- Pilot → Nuclear Option: provides controls (evidence: `README.md`)
- Nuclear Option → Flight Hooks: dispatches hooks
- Plugin Setup → Flight Hooks: patches methods (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Flight Hooks → FCS Controller: ticks controller (evidence: `Vortex_FS20.FCS/Hooks.cs`)
- Aircraft Registry → FCS Controller: creates controller (evidence: `Vortex_FS20.FCS/Registry.cs`)
- FCS Controller → Control Allocator: solves allocation
- Control Allocator → Effector Model: allocates commands (evidence: `Vortex_FS20.FCS/Allocator.cs`)
- FCS Controller → Surface Effectors: uses surfaces (evidence: `Vortex_FS20.FCS/Registry.cs`)
- Surface Effectors → Effector Model: extends model (evidence: `Vortex_FS20.FCS/SurfaceEffector.cs`)
- FCS Controller → Vectoring Effectors: uses vectoring
- Control Allocator → Native Solver: delegates solve (evidence: `Vortex_FS20.FCS/Allocator.cs`)
- Native Solver → Native Core: uses native library
- Plugin Setup → STOVL Laws: enables STOVL (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- STOVL Hooks → FCS Controller: connects STOVL (evidence: `Vortex_FS20.FCS/StovlHooks.cs`)
- Plugin Setup → STOVL Hooks: registers hooks (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Plugin Setup → Throttle Detent: configures throttle (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Throttle Detent → Throttle HUD: updates display (evidence: `Vortex_FS20.FCS/ThrottleDetent.cs`)
- Plugin Setup → Vane Box: configures vane box (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Plugin Setup → Fuel Balance: configures balancing (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Plugin Setup → Release Guard: configures guard (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Plugin Setup → Stall Stagger: configures stall model (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Plugin Setup → Drag Relief: configures drag relief (evidence: `Vortex_FS20.FCS/Plugin.cs`)
- Aircraft Registry → Stall Stagger: registers jobs (evidence: `Vortex_FS20.FCS/Registry.cs`)
- Plugin Setup → Telemetry: configures telemetry (evidence: `Vortex_FS20.FCS/Plugin.cs`)
