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, pl, uk, ru

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

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.08 s	Cooldown between coroutine resumes
semanticScanBatchSize	6	Objects processed before yielding
minVisible / maxVisible	10 / 12	Dispatcher pool target
nextOfferDuration	5 s	Floating offer lifetime
nextOfferRetryMin / Max	5 / 10 s	Retry after expiry/failure
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

Phase IDs

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