Quick Start (Editor-first)

Watch the Quick Start Tutorial Video on YouTube

This guide is for Unity users who want Sirocco Race Timing up and running quickly with minimal code.

1) Run the Quick Start Wizard (recommended)

In Unity, open:

Tools → Sirocco Race Timing → Quick Start Wizard

Core Components

The wizard creates these in your scene:

• A TrackMarkersSO asset (stores your track waypoint data)

• Pick an existing asset or click Create New to save a new one under Assets/SlowToastRacing/RaceTiming/TrackData/.

  

• A TrackMarkers GameObject with TrackMarkerManagerBehaviour (handles track editing and runtime track access)

• A RaceTimingManager GameObject (manages the session and timing)
• Defaults when freshly created:
  • AutoStartSession = true
  • SessionConfig = Sprint Race preset (10-lap race, F1-style countdown)
• Toast notification setup:
• Creates a ToastManager if one isn't already in the scene
• Attempts to auto-assign the DefaultToast prefab if none is set
• Creates a RaceToastBridge if one isn't already in the scene

Optional UI Components

These are off by default. Enable them in the wizard before clicking Run:

• Race Tower UI — standings display
• Delta Bar UI — live delta overlay compared to a reference lap
• Requires CompetitorFocusManager (auto-created)
• Press K in demo scenes to toggle
• Lap Position Bar — horizontal bar showing all competitors' track positions
• Requires CompetitorFocusManager (auto-created)
• Colour-coded: Red = leader, Green = focused driver, Grey = others
• Press L in demo scenes to toggle
• Start Lights UI — F1-style lights during the countdown
• Car Focus Indicator UI — brackets around the focused competitor's car
• Qualifying Lap UI — sector times and lap splits for the focused car

After the wizard runs, it selects the TrackMarkers object so you can start placing waypoints straight away.

2) Place track waypoints (Scene View)

Select the TrackMarkers GameObject, then use the Scene View:

Action	Result
Shift + Click	Add a waypoint
Click a waypoint	Select it (drag to move)
Alt + Click near a waypoint	Delete the nearest waypoint
Delete key	Delete the selected waypoint

You'll see: - Blue spheres = waypoints - Light blue lines = the path - A closing segment that loops back from the last marker to the first

Note: Your scene needs colliders or terrain for raycasts to detect waypoint placement.

3) Add competitors (cars)

For each vehicle GameObject:

1. Add the RaceCompetitor component
2. Optionally configure:
3. Id — auto-generated at runtime if left as 0
4. CompetitorName — defaults to the GameObject name
5. ShortName — 3-letter abbreviation, e.g. HAM
6. TeamColor

4) Press Play

If the wizard set up a RaceTimingManager for you, it defaults to the Sprint Race preset: - 10-lap race with an F1-style countdown (5 lights, 30s pre-start delay)

To use a different session type, select RaceTimingManager and assign a different SessionConfig from Assets/SlowToastRacing/RaceTiming/Presets/Sessions/:

Preset	Description
Practice	No countdown, runs until manually stopped
Qualifying	Simple countdown, 15-minute timed session
Sprint Race	F1 countdown, 10-lap race (default)
Feature Race	F1 countdown, 50-lap race
Endurance Race	F1 countdown, 6-hour timed race

Or create a custom config via Assets → Create → Race Timing → Session Config.

To control the session manually:

1. Disable AutoStartSession on RaceTimingManager
2. Call from code:
3. RaceTimingManager.Instance.StartSession()
4. RaceTimingManager.Instance.StopSession()

5) Set up the Race Tower UI

If you ran the wizard with Race Tower enabled, the UI is already set up.

Otherwise, see the setup guide: - UI Setup: RaceTowerUI

6) Optional: Add toast notifications

Toasts require a SiroccoToast.ToastManager in the scene. The wizard creates one automatically if you enable the toast option.

The RaceToastBridge subscribes to race events and shows toast notifications at runtime.

For setup and configuration, see: - UI Setup: Toast Notifications

If you don't see toasts, check Troubleshooting.