Configuration Reference

Configuration Reference

Static configuration lives in lua/ge/extensions/taxiDriver/config.lua. Values are loaded once by the main GE extension. Runtime state does not belong in this module.

Supported languages

en, de, fr, es, it, pl, uk, ru, zh-CN

Runtime configuration

Key	Value	Unit / meaning
minRideDistance	1,000	metres
maxRideDistance	25,000	metres
minPickupDistance	400	metres
maxPickupDistance	3,500	metres
arrivalRadius	14	metres
maxArrivalSpeedKmh	4	km/h
averageCitySpeedKmh	40	ETA reference speed
minimumDrivability	0.7	route/road cutoff
hudUpdateInterval	0.2	real seconds
boardingDuration	3	simulation seconds
alightingDuration	3	simulation seconds
completedDuration	4	simulation seconds
stopWaitingDuration	10	simulation seconds
forcedExitDuration	5	simulation seconds

Sanitized user-setting ranges

Setting	Default	Range
uiScalePercent	100%	80–180% in 10% steps
appVolume	0.65	0–1
dynamicZoomIntensity	100%	0–200%
overspeedWarningKmh	10 km/h	0–30 km/h
economyMultiplier	1.00×	0.25–5.00×
deliveryOrderSharePercent	50%	0–100%
unlimitedRouteDistance	false	Boolean; removes the 25 km upper bound
aiDriver.aggressionPercent	30%	10–80%
aiDriver.followingTimeGap	2.2 s	1.2–3.5 s
aiDriver.brakingDeceleration	2.8 m/s²	1.5–4.5 m/s²
aiDriver.stuckDelaySeconds	15 s	8–30 s
aiDriver.preset	balanced	novice, cautious, balanced, assertive, racer, custom
aiDriver.obeySpeedLimits	true	Boolean
aiDriver.obeyTrafficSignals	true	Boolean
aiDriver.allowOvertaking	true	Boolean
aiDriver.laneChangeClearancePercent	100%	50–175%
aiDriver.allowOncomingRecovery	true	Boolean
aiDriver.allowReverseRecovery	true	Boolean
aiDriver.recoveryMaxAttempts	3	1–5
aiDriver.finalApproachSpeedKmh	12 km/h	5–20 km/h
aiDebugLogging	false	Boolean; streams dedicated AI JSONL diagnostics
fleet.enabled	true	Boolean
fleet.aiPreset	standard	careful, standard, or fast
fleet.ownerSharePercent	35%	10–90%
fleet.hiringFee	$75	$0–1,000
fleet.wagePerTenMinutes	$12	$0–250
fleet.maxDrivers	6	1–12
fleet.worldLabelDistance	400 m	50–1,000 m in 50 m steps
fleet.minimumJobDistanceKm	1.5 km	0.5–20 km
fleet.maximumJobDistanceKm	8 km	minimum–50 km
fleet.passengerJobs / deliveryJobs	true / true	At least one remains enabled
externalMapEnabled	true	Boolean
externalTerrainEnabled	true	Boolean
externalMapQuality	balanced	eco, balanced, or smooth
godMode	false	Boolean
debugLogging	true	Boolean

routePlanner.isDistanceAllowed() receives no maximum when unlimited routes are enabled. Minimum passenger/delivery distances and drivability checks are unchanged.

AI supervisor configuration

The user-facing values above are combined with internal safety constants from config.autopilot and autopilot.lua:

Key	Default	Meaning
recoveryRetryInterval	8 s	Retry interval after a failed local recovery
recoverySuccessDistance	8 m	Progress needed before restoring normal routing
signalHoldDistance	120 m	Maximum signal/queue supervision distance
signalQueueReleaseDelay	4 s	Grace after a queued signal clears before obstacle recovery
approachDistance / finalApproachDistance	45 / 20 m	Normal path speed stages
stopDistance	8 m	Ordinary target stop radius
exact completion radius	1.25 m	Fuel/order trigger final approach
followMinimumGap / followEmergencyGap	7 / 3.5 m	Lead-vehicle bumper gaps
followScanDistance	160 m	Dynamic lead search horizon
followScanInterval	0.2 s	Lead/speed-cap update interval
signalLookAhead	160 m	Route-edge signal search horizon
intersectionClearDistance	30 m	Travel after stop-line commitment before signal supervision resumes
directApproachDistance	48 m	Maximum Vehicle Lua exact-approach handoff
directApproachSpeed	3.5 m/s	Exact-approach target speed
bypassControllerSpeed	7 m/s	Adaptive local bypass target speed
bypassControllerTimeout	14 s	Local controller timeout
laneChangeLeadDistance	35 m	Slow-lead overtaking consideration distance
laneChangeCooldown	20 s	Minimum interval between lane changes
laneChangeFreeAhead / Behind	55 / 22 m	Adjacent-lane clearance
reverseEscapeMinDistance / MaxDistance	3 / 6 m	Rear-fan escape target range
reverseEscapeSpeed	2.2 m/s	Controlled reverse target speed
reverseEscapeTimeout	10 s	Reverse-controller timeout

See AI Driver and Recovery for how these values interact with BeamNG AI and Vehicle Lua safety rays.

Fleet AI presets

Fleet workers use fixed, simplified profiles rather than the player's six-profile/Custom editor. Each worker still receives a separate sanitized supervisor configuration.

Preset	Aggression	Gap	Braking	Stuck delay	Speed limits	Signals	Overtaking	Clearance	Oncoming	Reverse	Attempts	Approach
careful	20%	3.1 s	2.3 m/s²	20 s	On	On	Off	145%	Off	On	3	8 km/h
standard	30%	2.4 s	2.8 m/s²	15 s	On	On	On	110%	On	On	3	11 km/h
fast	52%	1.8 s	3.5 m/s²	11 s	Off	On	On	75%	On	On	4	15 km/h

See Fleet Operations for hiring, wages, assignments, persistence, and worker lifetime.

Offer configuration

Key	Value	Meaning
initialDelay	1.5 s	Delay before first generation job
intervalMin / intervalMax	1.2 / 2.2 s	Delay between completed offers
generationStepInterval	0.02 s	Cooldown between coroutine resumes
semanticScanBatchSize	6	Objects processed before yielding
semanticCandidateAttempts	40	Bounded semantic candidates per stop search
randomRouteAttempts	24	Bounded graph-derived fallback attempts
semanticLongitudinalJitterMax	70 m	Maximum variation along a semantic road segment
randomDistanceExponent	1.15	Random route-distance distribution
recentStopLimit	48	Remembered roadside points
recentStopSeparation	150 m	Preferred separation from recent points
routeDiversityMinimumShare	0.65	Pool share requiring strict endpoint diversity
routeDiversityAttempts	3	Candidate routes checked per normal offer
routeDiversityCellSize	400 m	Spatial route-history cell size
routeDiversityEndpointSeparation	280 m	Minimum endpoint separation under strict checks
recentRouteLimit	20	Remembered accepted/generated route pairs
minVisible / maxVisible	10 / 12	Dispatcher pool target
nextOfferDuration	5 s	Floating offer lifetime
nextOfferRetryMin / Max	5 / 10 s	Retry after expiry/failure
nextOfferProgressThreshold	0.80	Route progress required for floating offers
pickupTimeMultiplier	1.35	Pickup ETA multiplier
pickupTimeGraceSeconds	60 s	Added pickup grace
pickupTimeMinSeconds / Max	120 / 600 s	Pickup budget clamp
multiStopChance	0.24	Random unplanned type chance
multiStopVisibleMin / Max	2 / 3	Requested pool composition
rushVisibleMin / Max	2 / 4	Requested pool composition
multiStopCountMin / Max	2 / 2	Intermediate stop count
multiStopMinimumCandidates	20	Semantic candidates required
multiStopSegmentMin / Max	3,000 / 7,000 m	Normal leg range
multiStopRouteAttempts	18	Attempts per special leg
generationFailureBackoffMin / Max	4 / 7 s	Backoff after repeated failures
rushChance	0.28	Random unplanned type chance
rushBonusMin / Max	0.22 / 0.42	22–42% bonus
rushTimeRatioMin / Max	0.72 / 0.86	Normal ETA fraction

Base fare and rating

Key	Value
baseFare	$3.25
farePerKm	$1.55
farePerMinute	$0.20
ratingBonusThreshold	3.99
maxRatingBonus	0.15
maxTotalPenalty	0.50
ratingPenaltyScale	8
collisionRatingPenalty	0.15
minimumRideRating	1

Pickup penalty

Key	Value
pickupLateBasePenalty	0.05
pickupLatePenaltyPerSecond	0.000333
maxPickupLatePenalty	0.12

Passenger mood and stress

Key	Value
calmPenaltyIgnoreMaximum	0.70
calmPenaltyMultiplierThreshold	50
passengerStressThresholdMinimum	72
passengerStressThresholdCalmBonus	23
passengerMoodMaximumGain	40
passengerMoodPerfectRideGain	40
passengerMoodStressRecovery	0.8
passengerMoodPickupLateLoss	4
passengerMoodPickupLateStepLoss	2
passengerMoodSpeedingBaseLoss	2
passengerMoodCollisionBaseLoss	10
passengerMoodAggressionBaseLoss	4
passengerMoodRushExpiredLoss	6

Difficulty matrix

Speeding

Preset	Fixed tolerance	Ratio tolerance	Grace	Rate	Configured max
Elementary	15 km/h	25%	6 s	0.00025	6%
Easy	11 km/h	20%	4.5 s	0.00045	10%
Standard	8 km/h	15%	3 s	0.0008	15%
Professional	4 km/h	8%	1.5 s	0.0018	25%

Collision

Preset	Damage threshold	Damage scale	Damage factor	Event add	Configured max
Elementary	60	22,000	0.10	0.004	10%
Easy	35	17,000	0.14	0.007	14%
Standard	20	12,000	0.18	0.010	20%
Professional	10	8,000	0.24	0.020	30%

Collision events use a three-second cooldown in every preset.

Harsh manoeuvre

Preset	Longitudinal trigger/release	Lateral trigger/release	Event add	Extra rate / cap	Configured max
Elementary	0.88 / 0.55 g	0.78 / 0.48 g	0.002	0.006 / 0.004	5%
Easy	0.74 / 0.48 g	0.66 / 0.42 g	0.0035	0.010 / 0.006	8%
Standard	0.62 / 0.40 g	0.55 / 0.35 g	0.005	0.015 / 0.010	12%
Professional	0.48 / 0.32 g	0.42 / 0.28 g	0.010	0.025 / 0.018	20%

Aggression events use a three-second cooldown in every preset.

Internally, individual component accumulators allow up to twice the configured component max so a low-mood sensitivity multiplier can be represented. The final combined fare penalty remains capped at 50%.

Early-exit and abandonment reductions

Both passenger-triggered early exit and the extra percentage portion of driver abandonment use:

Preset	Reduction
Elementary	10%
Easy	20%
Standard	30%
Professional	45%

Driver abandonment additionally subtracts one full rating star before clamping to 0–5.

Realistic fuel configuration

Key	Value
fuelInitialLevel	5%
electricInitialLevel	30%
fallbackPricePerUnit	$1.00
fuelRatePerSecond	2 readable units/s
electricPercentRatePerSecond	4 percentage points/s
Gasoline fixed price	$0.93/L
Electric fixed price	$0.50/kWh
dashboardRefreshInterval	1 s

Estimated range uses 10 L/100 km for gasoline, 8.5 L/100 km for diesel, 12.5 L/100 km for kerosene, and 22 kWh/100 km for electric energy.

Cargo delivery configuration

Key	Value	Meaning
visibleMin / visibleMax	5 / 7	Requested delivery count in a full pool
minimumWeightKg / maximumWeightKg	2 / 250 kg	Generated cargo range
weightDistributionExponent	1.55	Bias toward lighter cargo
minimumDistance / maximumDistance	2,000 / 25,000 m	Delivery route range
routeAttempts	28	Route attempts per delivery candidate
diversityAttempts	3	Spatially distinct candidates checked
fareMultiplier	0.82	Pre-weight rate relative to passenger work
weightFareBonusThresholdKg	15 kg	Weight premium threshold
maximumWeightFareBonus	1.50	Maximum +150% premium at 250 kg
collisionDamageThreshold	20	Minimum telemetry damage delta
minimumImpactDamagePercent / maximumImpactDamagePercent	1 / 35%	Package damage per impact
impactDamageScale	4,500	Exponential impact-severity scale
ratingDamageThresholdPercent	5%	Damage threshold before rating loss

Phase IDs

inactive, searching, toFuelStation, toPickup, boarding,
toStop, stopWaiting, toDestination,
passengerStopDemand, passengerForcedExit, driverAbandoning,
alighting, complete, error