Skip to content

Example Scene Setup (Wizard-aligned)

This guide walks through building a race timing scene from scratch. It covers the same setup as the Quick Start Wizard, but explains each piece individually.

Use this guide if you want to: - validate your installation with a fresh scene - create your own base scene/template - troubleshoot missing references

Goal

Create a scene with: - a track (waypoints) - 2–3 competitors - a running timing manager - a Race Tower UI showing gaps - (optional) toast notifications

1) Create or open a scene

  1. File → New Scene
  2. Save it somewhere like: Assets/Scenes/RaceTimingExample.unity

2) Set up the track

There are two ways to do this.

Open: Tools → Sirocco Race Timing → Quick Start Wizard

The wizard will: - Create Assets/SlowToastRacing/RaceTiming/TrackData/TrackMarkersSO.asset (if one doesn't exist) - Create a RaceTimingManager with the Sprint Race preset (10-lap, F1-style countdown) - Set up ToastManager + assign DefaultToast + create RaceToastBridge

Then skip to Step 4 (create competitors).

Option B: Manual track setup

  1. Create the track data asset:
  2. Project window → Right-click → Create → Race Timing → Track Markers
  3. Name it: ExampleTrack
  4. In the Hierarchy:
  5. Create an empty GameObject named TrackMarkers
  6. Add the TrackMarkerManagerBehaviour component
  7. Assign the ExampleTrack asset to the Track Marker Scriptable Object field
  8. Select TrackMarkers, then in the Scene View use Shift + Click to place markers around a loop.

3) Add a RaceTimingManager

  1. Create an empty GameObject named RaceTimingManager
  2. Add the RaceTimingManager component
  3. Set in the Inspector:
  4. AutoStartSession: enabled (good for quick testing)
  5. SessionConfig: assign a preset from Assets/SlowToastRacing/RaceTiming/Presets/Sessions/
Preset Description
Sprint Race F1 countdown, 10-lap race (wizard default)
Practice No countdown, runs until manually stopped
Qualifying Simple countdown, 15-minute timed session
Feature Race F1 countdown, 50-lap race
Endurance Race F1 countdown, 6-hour timed race

Sectors default to 3 equal divisions. You can edit them on the TrackMarkersSO asset.

4) Add competitors

Minimal setup

For each competitor: 1. Create a placeholder object (e.g., GameObject → 3D Object → Cube) 2. Name it: Racer1, Racer2, etc. 3. Add the RaceCompetitor component 4. Optionally set ShortName and TeamColor

Making them move

Sirocco Race Timing does not include vehicle physics — you provide your own movement/controller.

For a simple test, use the demo helper: - Add DemoRacer from Assets/SlowToastRacing/RaceTiming/Demo/DemoRacer.cs - Assign the TrackMarkers GameObject to its Track Manager field - Give each competitor a slightly different speed

5) Add the standings UI

Use the prefab: Assets/SlowToastRacing/RaceTiming/UI/Prefabs/RaceTower.prefab

Or follow the step-by-step guide in: - UI Setup: RaceTowerUI

6) Optional: Toast notifications

  1. Add a ToastManager (SiroccoToast is included with the asset)
  2. Use the prefab: Assets/SlowToastRacing/RaceTiming/ThirdParty/SiroccoToast/Prefabs/ToastManager.prefab
  3. Add RaceToastBridge to the scene (the wizard does this automatically)
  4. Press Play and confirm toasts appear for:
  5. best lap
  6. best sector

7) Validate

When you press Play, you should see: - RaceTimingManager logs about configured sectors - competitors registering ([RaceCompetitor] Registered...) - lap/sector events firing as objects move around the loop - Race Tower rows appearing and updating

Next steps

  • Customize the session by assigning a different SessionConfig preset, or create your own via Assets → Create → Race Timing → Session Config
  • Wire UnityEvents (Inspector) for lap complete sounds, UI highlights on best lap/sector, etc.
  • Replace DemoRacer with your own controller and keep RaceCompetitor attached