Getting Started

Get started with configuring Traffic Engine for your community.

Installation

Step 1: Install the Resource

Place the Traffic Engine resource into your server's resources folder.

Example:

resources/[trafficengine]/sonoran-trafficengine

• 

Step 2: Ensure the Resource

Ensure and start Traffic Engine to your server's server.cfg file.

ensure sonoran-trafficengine

• 

Step 3: Configure Permissions

Traffic Engine uses ACE permissions for administrative access.

Add the following permission to your server configuration:

add_ace group.admin trafficengine.admin allow

Example:

add_principal identifier.fivem:123456 group.admin
add_ace group.admin trafficengine.admin allow

Traffic Engine Menu

Opening Traffic Engine

Administrators can access Traffic Engine in-game using:

/trafficengine

This command opens the Traffic Engine administrative toolset.

This menu allows for the creation of regions, zones, breakdowns, and debris management.

Region and Zone Management

What are Regions?

Regions

A region represents a large section of the map and acts as the parent for all traffic behavior within that area.

Example Regions:

• City Region: Los Santos
• County Region: Blaine County
• Rural Region: Paleto Bay

What are Zones?

Zones are smaller areas inside a region.

Examples:

• Downtown Los Santos
• Interstate 1
• Airport Access Road
• Mirror Park

Zones allow you to override regional settings and create unique traffic behavior in specific locations.

For example:

Area	Morning/Evening Rush Hour Density Value 1-3
Los Santos Region	3
Legion Square Zone	2

Region Creation

To create a region:

1. Open the menu with /trafficengine
2. Select Create Category > Region
3. Configure the region's name and rush hour settings:

Morning Rush Multiplier

• How dense will the traffic in this region become during the morning rush hour time?
• These values can be edited as a baseline in the config.lua as a blanket while the regions in game can have their own values.

  

Evening Rush Multiplier

• How dense will the traffic in this region become during the morning rush hour time?
• These values can be edited as a baseline in the config.lua as a blanket while the regions in game can have their own values. As seen as above.

1. Place Nodes

• Add nodes by placing them down by pressing E to draw out your zone. Press Enter to confirm
• Regions are substantially taller and deeper than a zone.

  

Zone Creation

To create zones inside of the region:

1. Open the menu with /trafficengine
2. Select Create Category > Zone
3. Configure the zone's settings:

Breakdown Allowance

<figure><img src="../.gitbook/assets/image (10).png" alt=""><figcaption></figcaption></figure>

Debris Allowance

<figure><img src="../.gitbook/assets/image (11).png" alt=""><figcaption></figcaption></figure>

1. Place Spawn Zones

• Configure spawn points for the breakdowns and debris by pressing E, to save press Enter.
• When blue nodes appear those are temporary locations, you can remove or save their location by going to a new area then press E

  

Region and Zone Deletion

Delete zones or regions from the in-game menu.

Note that any changes will be saved automatically, save a backup file if you wish to revert your changes.

<figure><img src="../.gitbook/assets/image (21).png" alt=""><figcaption></figcaption></figure>

Debris

Configuring Debris Spawning

Debris will automatically spawn inside the zone depending on the maximum amount of debris allowance set when first creating the zone.

Debris spawn frequency will be based on the config.Debris chance value.

Users can also manually spawn debris at a specific location in a zone via the in-game menu. To manually spawn a debris, navigate to Spawn Category > Debris.

The Config.Debris values can be tweaked for further customization.

tickIntervalMs - How often the breakdown system checks whether it should try to spawn one.

spawnCooldownMs - Cooldown after a successful breakdown before another normal spawn can happen.

guaranteedSpawnIntervalMs - Maximum time allowed without a breakdown before the system forces a guaranteed attempt.

eventActiveSeconds - How long a breakdown stays active before expiring.

nodeGracePeriodSeconds - How long a used breakdown node stays locked before it can be reused.

minPlayerDistance - Minimum distance a player must be from the node for a breakdown to spawn.

cleanupTimeMs - Cleanup timer used to remove the breakdown scene after it expires.

cleanupWhenPlayersFar - If enabled, cleans up breakdowns early when players move far enough away.

useRoadBlockingFallback - If enabled, blocks road pathing around the breakdown when needed.

allowPedSpawnWithBreakdown - If enabled, allows a stranded ped to spawn with the breakdown vehicle.

Cleanup Debris

Roadway debris can be cleaned up and removed by interacting and holding E on the debris.

This allows law enforcement, sanitation, DOT, civilians, or anyone else to clear debris from the roadways.

Breakdowns

Vehicle Breakdowns

Breakdowns will automatically spawn inside the zone depending on the maximum amount of breakdown allowance set when first creating the zone.

• 

Breakdown spawn frequency will be based on the config.Breakdowns chance value.

Users can also manually spawn breakdowns at a specific location in a zone via the in-game menu. To manually spawn a breakdown, navigate to Spawn Category > Breakdown.

When a breakdown spawns, it can be one of several severity scenarios. Higher level breakdowns can also spawn emergency services that will respond to it.

Breakdowns slow the speed of traffic substantially, causing traffic jams if players are in the area.

Config.Breakdowns:

enabled = true,

Turns the breakdown system on or off.

chance = 1.00,

Base chance for a breakdown event to occur when the system rolls.

chanceIncreasePerMiss = 0.08,

Adds 8% to the breakdown chance after each failed roll.

rushHourChanceIncreaseBonus = 0.20,

Adds an extra 20% chance during configured rush-hour periods.

maxActive = 500,

Maximum number of active breakdowns allowed server-wide.

maxActivePerZone = 10,

Maximum number of active breakdowns allowed in a single zone.

maxActivePerRegion = 30,

Maximum number of active breakdowns allowed in a single region.

trafficBlockRadius = 30.0,

Distance around the breakdown where AI traffic will react and avoid the scene.

Emergency Response

Breakdown Emergency Response

When a high level vehicle breakdown spawns, fire and EMS vehicles can also spawn nearby for added realism.

Users can also manually spawn emergency vehicles at a specific location in a zone via the in-game menu. To manually spawn an emergency vehicle, navigate to Spawn Category > Emergency. Emergency Nodes will show up in blue when manually placed.

Calm AI

Traffic Engine will conflict with scripts like Calm AI and other traffic management scripts.

Disable any existing traffic management scripts and use only Traffic Engine for these features.

Calm AI Traffic Management

Many communities use traffic and AI management systems like "Calm AI". These scripts manage the overall traffic density across the map and AI aggressiveness behavior.

Because Traffic Engine will conflict with any existing Calm AI script, these features are built in.

Go to config.lua and find this value to apply Override or not depending on what traffic manager you use.

Config.CalmAI = {
    -- MASTER TOGGLE FOR CALM AI POPULATION OVERRIDES. | BOOLEAN | TRUE OR FALSE
    enabled = true,
    -- HOW MANY VEHICLES ARE DRIVING AROUND THE MAP. LOWER = LESS MOVING TRAFFIC. | NUMBER | 0.0 TO 3.0
    VehDensity = 0.85,
    -- HOW MANY RANDOMLY SPAWNED TRAFFIC VEHICLES ARE AROUND. LOWER = LESS RANDOM TRAFFIC. | NUMBER | 0.0 TO 3.0
    RanVehDensity = 0.65,
    -- HOW MANY PARKED CARS ARE AROUND THE MAP. LOWER = FEWER PARKED CARS. | NUMBER | 0.0 TO 3.0
    ParkCarDensity = 0.95,
    -- HOW MANY WALKING/STREET AI PEDS ARE AROUND. LOWER = FEWER PEDS. | NUMBER | 0.0 TO 1.0
    PedDensity = 0.75,
    -- HOW MANY SCENARIO PEDS ARE RUNNING EMOTES/TASKS. LOWER = FEWER SCENE PEDS. | NUMBER | 0.0 TO 1.0
    ScenePedDensity = 0.35,
    -- TRUE DISABLES VANILLA AI DISPATCH. FALSE LEAVES VANILLA DISPATCH ON. | BOOLEAN | TRUE OR FALSE
    DispatchDead = true