# jamesmcadamsdevhub/unity-customtrackgeneration architecture

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

- Interactive diagram: https://gitdiagram.com/jamesmcadamsdevhub/unity-customtrackgeneration
- Repository: https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration

## Overview

Unity Custom Track Generation is an editor-oriented tool for building modular, procedurally meshed track systems. A developer places a prefab, configures a spline or loop and geometry settings, then generates track; connection points snap compatible pieces together and trigger endcap updates. The implementation separates track-type generators, shared generation orchestration, geometry data/mesh construction, and configuration. The README documents these capabilities, but several generator implementations and detailed orchestration paths were not excerpted, so those connections are limited to SOURCE INDEX evidence.

Main entry points: [`Scripts/TrackGenerationOrchestrator.cs`](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackGenerationOrchestrator.cs) (Generation Orchestrator), [`Scripts/TrackRingsData.cs`](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackRingsData.cs) (Ring Mesh Builder), [`Scripts/MeshData.cs`](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/MeshData.cs) (Mesh Buffers), [`Scripts/TrackIntersectionData.cs`](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackIntersectionData.cs) (Intersection Mesh Data)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Track Authoring"]
  node_prefabs["Track Prefabs"]
end

subgraph group_generation["Track Generation"]
  node_spline["Spline Generator"]
  node_loop["Loop Generator"]
  node_curve["Curve Generator"]
  node_intersections["Intersection Generators"]
  node_orchestrator["Generation Orchestrator"]
  node_endcaps["Endcap Generation<br/>[TrackEndcapData.cs]"]
  node_segment["Track Segments<br/>[TrackSegment.cs]"]
  node_intersectionruntime["Intersection Runtime"]
  node_endcapruntime["Endcap Runtime<br/>[TrackEndcap.cs]"]
end

subgraph group_geometry["Geometry Data"]
  node_ringdata["Ring Mesh Builder<br/>[TrackRingsData.cs]"]
  node_intersectiondata["Intersection Mesh Data"]
  node_threewaydata["Three-Way Mesh Data"]
  node_fourwaydata["Four-Way Mesh Data"]
  node_constraints["Geometry Constraints"]
  node_meshdata["Mesh Buffers<br/>[MeshData.cs]"]
  node_localpoint["Local Points<br/>[LocalPointData.cs]"]
  node_ringvectors["Ring Vectors"]
end

subgraph group_connections["Connections &amp; Config"]
  node_settings["Generation Settings"]
  node_defaultconfig["Default Config"]
  node_connectionpoint["Connection Points<br/>[ConnectionPoint.cs]"]
end

node_developer(("Unity Developer"))

node_developer -->|"places"| node_prefabs
node_prefabs -->|"configures spline"| node_spline
node_prefabs -->|"configures loop"| node_loop
node_spline -->|"inherits generation"| node_orchestrator
node_loop -->|"uses generation"| node_orchestrator
node_curve -->|"uses generation"| node_orchestrator
node_intersections -->|"uses generation"| node_orchestrator
node_spline -->|"builds rings"| node_ringdata
node_loop -->|"builds rings"| node_ringdata
node_curve -->|"builds rings"| node_ringdata
node_orchestrator -->|"reads settings"| node_settings
node_settings -->|"loads defaults"| node_defaultconfig
node_defaultconfig -->|"refreshes config"| node_orchestrator
node_orchestrator -->|"creates connections"| node_connectionpoint
node_connectionpoint -->|"notifies tracks"| node_orchestrator
node_orchestrator -->|"generates endcaps"| node_endcaps
node_orchestrator -->|"creates segments"| node_segment
node_ringdata -->|"uses constraints"| node_constraints
node_ringdata -->|"fills buffers"| node_meshdata
node_ringdata -->|"uses points"| node_localpoint
node_ringdata -->|"uses vectors"| node_ringvectors
node_intersections -->|"builds three-way"| node_threewaydata
node_intersections -->|"builds four-way"| node_fourwaydata
node_threewaydata -->|"extends mesh data"| node_intersectiondata
node_fourwaydata -->|"extends mesh data"| node_intersectiondata
node_intersectiondata -->|"uses constraints"| node_constraints
node_intersectiondata -->|"fills buffers"| node_meshdata
node_endcaps -->|"uses constraints"| node_constraints
node_endcapruntime -->|"uses buffers"| node_meshdata
node_intersectionruntime -->|"uses buffers"| node_meshdata
node_segment -->|"uses buffers"| node_meshdata

click node_prefabs "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/tree/main/Prefabs"
click node_spline "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackAlongSplineGenerator.cs"
click node_loop "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackLoopGenerator.cs"
click node_curve "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackCurveGenerator.cs"
click node_intersections "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/tree/main/Scripts"
click node_orchestrator "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackGenerationOrchestrator.cs"
click node_settings "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackGenerationSettings.cs"
click node_defaultconfig "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Config/TrackGenerationDefaultConfig.cs"
click node_connectionpoint "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/ConnectionPoint.cs"
click node_endcaps "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackEndcapData.cs"
click node_segment "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackSegment.cs"
click node_ringdata "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackRingsData.cs"
click node_intersectiondata "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackIntersectionData.cs"
click node_threewaydata "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/Track3WayIntersectionData.cs"
click node_fourwaydata "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/Track4WayIntersectionData.cs"
click node_constraints "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackConstraintsData.cs"
click node_meshdata "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/MeshData.cs"
click node_localpoint "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/LocalPointData.cs"
click node_ringvectors "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackRingVectorData.cs"
click node_intersectionruntime "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackIntersection.cs"
click node_endcapruntime "https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackEndcap.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_prefabs toneBlue
class node_spline,node_loop,node_curve,node_intersections,node_orchestrator,node_endcaps,node_segment,node_intersectionruntime,node_endcapruntime toneAmber
class node_ringdata,node_intersectiondata,node_threewaydata,node_fourwaydata,node_constraints,node_meshdata,node_localpoint,node_ringvectors toneMint
class node_settings,node_defaultconfig,node_connectionpoint toneRose
class node_developer toneIndigo
```

## Components

### Track Authoring

- [Track Prefabs](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/tree/main/Prefabs): `Prefabs`

### Track Generation

- [Spline Generator](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackAlongSplineGenerator.cs): `Scripts/TrackAlongSplineGenerator.cs`
- [Loop Generator](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackLoopGenerator.cs): `Scripts/TrackLoopGenerator.cs`
- [Curve Generator](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackCurveGenerator.cs): `Scripts/TrackCurveGenerator.cs`
- [Intersection Generators](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/tree/main/Scripts): `Scripts`
- [Generation Orchestrator](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackGenerationOrchestrator.cs): `Scripts/TrackGenerationOrchestrator.cs`
- [Endcap Generation](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackEndcapData.cs): `Scripts/TrackEndcapData.cs`
- [Track Segments](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackSegment.cs): `Scripts/TrackSegment.cs`
- [Intersection Runtime](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackIntersection.cs): `Scripts/TrackIntersection.cs`
- [Endcap Runtime](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackEndcap.cs): `Scripts/TrackEndcap.cs`

### Geometry Data

- [Ring Mesh Builder](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackRingsData.cs): `Scripts/TrackRingsData.cs`
- [Intersection Mesh Data](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackIntersectionData.cs): `Scripts/TrackIntersectionData.cs`
- [Three-Way Mesh Data](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/Track3WayIntersectionData.cs): `Scripts/Track3WayIntersectionData.cs`
- [Four-Way Mesh Data](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/Track4WayIntersectionData.cs): `Scripts/Track4WayIntersectionData.cs`
- [Geometry Constraints](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackConstraintsData.cs): `Scripts/TrackConstraintsData.cs`
- [Mesh Buffers](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/MeshData.cs): `Scripts/MeshData.cs`
- [Local Points](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/LocalPointData.cs): `Scripts/LocalPointData.cs`
- [Ring Vectors](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackRingVectorData.cs): `Scripts/TrackRingVectorData.cs`

### Connections & Config

- [Generation Settings](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/TrackGenerationSettings.cs): `Scripts/TrackGenerationSettings.cs`
- [Default Config](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Config/TrackGenerationDefaultConfig.cs): `Config/TrackGenerationDefaultConfig.cs`
- [Connection Points](https://github.com/jamesmcadamsdevhub/unity-customtrackgeneration/blob/main/Scripts/ConnectionPoint.cs): `Scripts/ConnectionPoint.cs`

### Other components

- **Unity Developer**

## Connections

- Unity Developer → Track Prefabs: places (evidence: `README.md`)
- Track Prefabs → Spline Generator: configures spline (evidence: `README.md`)
- Track Prefabs → Loop Generator: configures loop (evidence: `README.md`)
- Spline Generator → Generation Orchestrator: inherits generation (evidence: `Scripts/TrackAlongSplineGenerator.cs`)
- Loop Generator → Generation Orchestrator: uses generation (evidence: `Scripts/TrackLoopGenerator.cs`)
- Curve Generator → Generation Orchestrator: uses generation (evidence: `Scripts/TrackCurveGenerator.cs`)
- Intersection Generators → Generation Orchestrator: uses generation (evidence: `Scripts/Track3WayIntersectionGenerator.cs`)
- Spline Generator → Ring Mesh Builder: builds rings (evidence: `Scripts/TrackAlongSplineGenerator.cs`)
- Loop Generator → Ring Mesh Builder: builds rings (evidence: `Scripts/TrackLoopGenerator.cs`)
- Curve Generator → Ring Mesh Builder: builds rings (evidence: `Scripts/TrackCurveGenerator.cs`)
- Generation Orchestrator → Generation Settings: reads settings (evidence: `Scripts/TrackGenerationOrchestrator.cs`)
- Generation Settings → Default Config: loads defaults (evidence: `Scripts/TrackGenerationSettings.cs`)
- Default Config → Generation Orchestrator: refreshes config (evidence: `Config/TrackGenerationDefaultConfig.cs`)
- Generation Orchestrator → Connection Points: creates connections (evidence: `Scripts/TrackGenerationOrchestrator.cs`)
- Connection Points → Generation Orchestrator: notifies tracks (evidence: `Scripts/ConnectionPoint.cs`)
- Generation Orchestrator → Endcap Generation: generates endcaps (evidence: `Scripts/TrackGenerationOrchestrator.cs`)
- Generation Orchestrator → Track Segments: creates segments (evidence: `Scripts/TrackGenerationOrchestrator.cs`)
- Ring Mesh Builder → Geometry Constraints: uses constraints (evidence: `Scripts/TrackRingsData.cs`)
- Ring Mesh Builder → Mesh Buffers: fills buffers (evidence: `Scripts/TrackRingsData.cs`)
- Ring Mesh Builder → Local Points: uses points (evidence: `Scripts/TrackRingsData.cs`)
- Ring Mesh Builder → Ring Vectors: uses vectors (evidence: `Scripts/TrackRingsData.cs`)
- Intersection Generators → Three-Way Mesh Data: builds three-way (evidence: `Scripts/Track3WayIntersectionGenerator.cs`)
- Intersection Generators → Four-Way Mesh Data: builds four-way (evidence: `Scripts/Track4WayIntersectionGenerator.cs`)
- Three-Way Mesh Data → Intersection Mesh Data: extends mesh data (evidence: `Scripts/Track3WayIntersectionData.cs`)
- Four-Way Mesh Data → Intersection Mesh Data: extends mesh data (evidence: `Scripts/Track4WayIntersectionData.cs`)
- Intersection Mesh Data → Geometry Constraints: uses constraints (evidence: `Scripts/TrackIntersectionData.cs`)
- Intersection Mesh Data → Mesh Buffers: fills buffers (evidence: `Scripts/TrackIntersectionData.cs`)
- Endcap Generation → Geometry Constraints: uses constraints (evidence: `Scripts/TrackEndcapData.cs`)
- Endcap Runtime → Mesh Buffers: uses buffers (evidence: `Scripts/TrackEndcap.cs`)
- Intersection Runtime → Mesh Buffers: uses buffers (evidence: `Scripts/TrackIntersection.cs`)
- Track Segments → Mesh Buffers: uses buffers (evidence: `Scripts/TrackSegment.cs`)
