Traffic Car

How To Create 

Create a vehicle using the Car Prefab Creator tool (for example Simple physics entity type).

Car Prefab Creator final step example.
Make sure, that the vehicle collection contains vehicle you have created.
Make sure, that the preset contains the vehicle.
Open the Traffic settings and select the Simple physics entity type (if you have created a Simple physics entity).
Open the Hub object in the scene and press the Copy To Subscene button.
Open the EntitySubScene, find the TrafficCarEntityPoolBakerRef gameobject, make sure the correct preset is assigned.
Adjust the traffic settings of the created vehicles.
- For simple physics.
- For custom physics.

Vehicle Physics Types 

Simple Physics 

Entities moved by the simple physical system (by simply adding the physics velocity to the physics body).
Settings.
Hybrid entity simple physics & Pure entity simple physics types refer to this.

Authoring components 

CarWheelAuthoring 

Wheel base : wheel radius.
All wheels : all wheels of the vehicle.
Steering wheels : wheels that can turn.

PhysicsShape 

Example

Optional components if the car moves with physics.

No Physics 

Pure entities that moved by transform system without physics.
Contains the same components as Simple Physics.
Settings.
Pure entity no physics type refer to this.

Common Authoring Components 

TrafficCarEntityAuthoring 

Main component of traffic entity [required].

Hull mesh renderer : vehicle hull mesh renderer reference.
Physics shape : vehicle entity PhysicsShape reference.
Faction type : selected faction type of vehicle.
Car type : selected car type of vehicle.
Bounds source type : selected bounds source for the entity bounds.
Traffic group : selected traffic group.

Shared Settings 

Each vehicle has a common set of settings that are described here

NavMeshObstacleAuthoring 

NavMeshObstacleData entity component for runtime loading of NavMeshObstacle objects for pedestrian navigation. Make sure, that option is enabled in the traffic settings [optional].

CarSoundAuthoring 

Component for vehicle sounds [optional].

HealthAuthoring 

Vehicle health component for damage system [optional].

CarDamageEngineAuthoring 

Component for visual presentation of damage in the damage systems [optional].

PlayerTargetAuthoring 

Component for player targeting systems [optional].

CullState Info 

States 

Culled : entity is destroyed.
CloseToCamera:
- Cull physics (if enabled) : custom physics & simple physics temporarily converted to no physics entity.
- Cull wheel (if enabled) : disabling wheel rotating.
InVisionOfCamera : entity fully enabled.

Parking 

Сar parking consists of the following states:

Entering parking states 

The car has chosen the path containing the parking node.
The car links the parking node to prevent it from being selected by other cars (the list of linked nodes can be customized here).
When the car reaches the parking node, the car position correction is activated for precise parking (if disabled in the parking config, this step is skipped).
Stopping the engine state is starting (if enabled in the stopping engine config & vehicle in view of camera’s player).
Pedestrian gets out of the car.

Exiting parking states 

The Pedestrian enters the pedestrian parking node, if available.
The parking car removes link with TrafficNode.
Ignition state system starts (if enabled in ignition config).
Once the car has started the engine, the car starts moving.

Avoidance 

Avoidance is used in the case of stuck vehicles.

Currently enabled in the following situations:

A cyclical obstacle where cars get stuck in each other (avoidance config).
A car has collided frontally with another car (collision config).

Cyclical obstacle example.

Avoiding cyclical obstacle example.

Note

Test scene example.

The Rail movement is used to drive the vehicle precisely along the path, which can be useful in small enclosed parking areas, for example. To enable rail movement, tick on the Rail parameter in the path settings. Open the rail config to adjust the Rail parameters.

Note

Enabled by default for trams.

Obstacle Detection 

Raycast 

Config

TrafficCarRaycastConfig.

Debugger

TrafficCarRaycastDebugger.

Modes

Hybrid mode : raycast is activated only when the selected targets are close to the car.
Raycast only : raycasts are sent constantly.

To define raycast targets for Hybrid or Raycast only modes, redefine the GetTargetQuery method in the TrafficCarRaycastObstacleTargetQueryProvider class, which returns the EntityQuery of the targets.

public static EntityQuery GetTargetQuery(
                   SystemBase sourceSystem,
                   TrafficCarDetectObstacleMode trafficCarDetectObstacleMode,
                   TrafficCarDetectNpcMode trafficCarDetectNpcMode,
                   out CollisionFilter tempRaycastCollisionFilter,
                   out CollisionFilter raycastAlwaysCollisionFilter);

TrafficCarDetectObstacleMode.
TrafficCarDetectNpcMode.
Hybrid Mode Filter : collision filter of hybrid raycast mode.
Raycast Only Filter : collision filter of raycast only mode.
Note
- You can also dynamically change the raycast target for Hybrid mode by adding or removing the TrafficCustomRaycastTargetTag component.
- Layer constants are stored in the ProjectConstants.cs file.

Traffic Car

How To Create 

Vehicle Physics Types 

Custom Physics 

Authoring components 

Vehicle Authoring 

Wheel 

Suspension 

Friction 

Transient Forces 

Brakes 

Engine 

Scene Settings 

Template Settings 

Wheel Refs 

PhysicsBody 

PhysicsShape 

Simple Physics 

Authoring components 

CarWheelAuthoring 

PhysicsBody 

PhysicsShape 

No Physics 

Common Authoring Components 

TrafficCarEntityAuthoring 

Shared Settings 

NavMeshObstacleAuthoring 

CarSoundAuthoring 

HealthAuthoring 

CarDamageEngineAuthoring 

PlayerTargetAuthoring 

CullState Info 

States 

Parking 

Entering parking states 

Exiting parking states 

Avoidance 

Rail Movement 

Obstacle Detection 

Raycast 