Traffic Light

How To Customize City Crossroads

Open Global Light Settings.

Spirit604/CityEditor/Window/Global Traffic Light Settings
Enable Show world info.
You can now quickly view and adjust the timelines of all the crossroads.
Enable Show disabled Lights to see crossroads with traffic lights switched off.
Select the desired crossroad and press Select.
In the TrafficLightCrossroad component, you can now set the timings.

How To Auto Connect Lights

You can automatically reconnect traffic and pedestrian lights to their closest relevant road nodes using the built-in auto-connector tool.

Requirements for Light Objects

For the auto-connector to detect and link your traffic lights correctly, ensure that the following setup is met:

The root GameObject of the traffic light must contain both the TrafficLightObjectAuthoring and the TrafficLightObject components.
Each child TrafficLightFrame component must have its Index direction property set strictly in accordance with where the physical frame (visor/lens) is facing. This direction is critical for the algorithm to properly align the traffic light orientation with the target road and traffic node. A small ray is displayed in the Scene view to visualize this direction.

Execution Steps

Open Global Light Settings.
Expand the Auto Light Connector foldout section.
Configure the following parameters:
- Raycast Distance: Set the maximum search radius for finding nearby nodes.
- Connect Only Missing: If enabled, the system will skip lights that are already connected to a valid crossroad.
- Traffic Lights: Enable this checkbox to process vehicle traffic lights.
- Pedestrian Lights: Enable this checkbox to process pedestrian lights.
- Pedestrian Name Pattern: Enter a substring (e.g., Pedestrian) to identify pedestrian light objects by their name.
Click the Reconnect Lights button.

Note

The tool performs a proximity and directional search. Vehicle lights will be linked to the closest aligned TrafficNode, while pedestrian lights will look for a matching crosswalk node based on your name pattern.

How To Assign Light

Open Global Light Settings.
Enable Show light connections.
Select Light connection type for example Traffic node.
Select H0 or H1 depending on the desired light index.
Next, select the desired T (TrafficNode).
Now, the selected TrafficNode will have the selected TrafficLightHandler.
In the same way, you can assign Light objects by changing the Light connection type.

Light object connection example.

Global Lights Settings

Window for quick display of crossroad timings and for linking the traffic lights to different entities.

How To Use

Settings

Common Settings

Focus on select : move the SceneView camera to the selected traffic light crossroad when you select.
Show world info : show enabled traffic light data in the scene (example).
Show disabled lights : show all traffic light data (include disabled) in the scene (example).

Scene light info example.

Scene light info (include disabled) example.

Connection Settings

Show light connections : on/off light connections in the scene.
Auto unselect handler : auto unselect TrafficLightHandler when connecting TrafficLightHandler traffic lights to any object.
Allow override light index : allow index traffic light overrides in traffic light objects.
Reparent light : traffic light object will be a child of the connected crossroad.

Light connection type :

All : show all connection types.
Traffic node : show traffic node connection only.
Light : show light object connection only.

Show connection buttons : show connection buttons for selected Light connection type.

Lights index : objects with a selected light index are displayed (-1 value - all indexes are displayed).

Selected Light connection type : [TrafficNode] and Lights index : [0] example.

World Lights

Custom settings : on/off custom timeline settings for selected crossroad.

Timeline: shows light states of crossroad and total duration.

TrafficLight [0] : TrafficLightHandler with light index 0.
TrafficLight [1] : TrafficLightHandler with light index 1.

SceneView Light Objects Description

Select:

H0/H1 : TrafficLightHandler (index 0, index 1).
T0/T1/T : TrafficNode (index 0, index 1, no index).
L0/L1/L : Light object (index 0, index 1, no index).

Unselect:

H- : unselect TrafficLightHandler.
T- : unselect TrafficNode.
L- : unselect Light object.

All connection types and -1 light index are enabled example.

How To Replace Global Light States

Open Global Light Settings window.
Click the * button to expand the Replace settings.
Select the source state container you wish to replace.
Select your new desired State container.
Click the Replace button.
As a result, all the source State containers are replaced.

Shared Light State Container

Contains common timings of light states that are shared between traffic light crossroads. You can easily replace shared containers using the Global Light Settings tool.

How To Create

from the project context :

Default Container Path

Project path example.

Settings

Example.

Light States

Green : car only drives on a green lights.
Red
Yellow
Red Yellow : red and yellow lights at the same time, shown as orange in the inspector.

Light Index

Unique traffic light ID in TrafficLightCrossroad defined in TrafficLightHandler used to link TrafficLightHandlers and traffic lights by index.

Traffic Light Handler

Traffic Light Handler is an entity for handling the state of a traffic light. Is part of TrafficLightCrossroad.

Settings

Traffic light crossroad : reference to the TrafficLightCrossroad.
Triggers : nodes that relate to the handler.
Traffic light parent : parent to which the light objects will be added.
Pedestrian light parent : parent to which the light objects will be added.
Related light index : linked traffic light traffic index.
Child lights : list of attached child light objects.
Custom lights : list of attached custom light objects.
Light states : light state of handler.

Components

Authoring

Traffic Light Object

Main Component

Traffic light object in the scene (parent component of the traffic light).

Contains data on the light frames and linked light indexes.

Traffic light object example.

Light Frame

A child component that contains the data for the traffic light indicators.

Traffic light object : reference to light frames.
Red light : red light state entity.
Yellow light : yellow light state entity.
Green light : green light state entity.
Initial light index : initial light index.
Index direction : direction in which the light index is displayed in the scene. A small ray is displayed in the Scene view to visualize this direction.