AI Taxi Configuration Reference

All operational parameters, vehicle models, spawning distances, seating assignments, and localized player notification messages for MTM-TAXI are configured in config.lua.

---

Configuration Settings Summary

Setting	Type	Default	Description
Config.vehicle	String	'taxi'	The spawn model name of the taxi vehicle.
Config.distance	Number	70	Distance in meters down the road where the taxi spawns from the player.
Config.seatUsed	Number	2	Default passenger seat index for the player (2 = rear right).
Config.pedModel	String	'a_m_m_prolhost_01'	Ped model hash used for the automated chauffeur.
Config.showBlip	Boolean	true	Renders a flashing yellow taxi sprite on the map during approach.
Config.deleteTaxi	Boolean	true	Automatically deletes vehicle and ped entities after the passenger exits.
Config.deleteTaxiTimer	Number	6000	Delay in milliseconds before deleting entities after passenger exit.
Config.maxWaypointRoadDistance	Number	40	Maximum distance in meters a waypoint may be from a road before refusal.
Config.spawnDistance	Number	75	Maximum distance in meters the player may be from a road to hail a cab.

---

Key Configuration Explanations

Passenger Seating Index (Config.seatUsed)

GTA V uses native zero-indexed seating identifiers:

• -1: Driver seat
• 0: Front passenger seat
• 1: Rear left passenger seat
• 2: Rear right passenger seat (Recommended default)

Setting this to 2 ensures that the passenger enters through the curbside rear door, safely away from oncoming highway traffic.

Spawn Distance vs. Proximity Check

• Config.spawnDistance (default 75): Checks if the player is close enough to a mapped road to be picked up. If a player is standing in the wilderness 100 meters away from any street, the driver refuses the fare.
• Config.distance (default 70): The distance along the road where the taxi actually creates the vehicle entity. Spawning between 50 and 80 meters away creates a natural visual effect where the cab appears around a corner or down the block and drives up to the passenger.

Waypoint Road Tolerance (Config.maxWaypointRoadDistance)

Standard GTA V map markers placed by players are rarely exact. Setting this tolerance to 40 meters allows players to place waypoints generally near buildings, parking lots, or intersections without the driver rejecting the route, while still preventing trips to inaccessible mountains or water.

---

Complete config.lua Source

Config = {}

-- The taxi vehicle model.
Config.vehicle = 'taxi'

-- The distance (in meters) where the taxi spawns from the player (recommended 50-80m for reliable spawning).
Config.distance = 70

-- The seat the player enters by default (-1 driver, 0 front passenger, 1 rear left, 2 rear right).
Config.seatUsed = 2

-- The taxi driver ped model.
Config.pedModel = 'a_m_m_prolhost_01'

-- Shows the taxi blip on the map when the taxi is on its way.
Config.showBlip = true

-- Deletes the taxi entity after the player exits.
Config.deleteTaxi = true

-- How long (in ms) after exiting before the taxi is deleted.
Config.deleteTaxiTimer = 6000

-- Message shown to the player upon entering the taxi.
Config.setWaypointMessage = "Set your waypoint for the destination"

-- Message shown to the player when requesting the taxi.
Config.taxiUnderway = "The taxi has been called and is on its way."

-- Message shown when the player is too far from a road.
Config.cantReach = "The taxi driver cannot reach you here."

-- Message shown to the player upon arrival.
Config.arrivalMessage = "You have arrived at your destination, you can now exit."

-- Message shown when trying to call a taxi while one is already active.
Config.alreadyCalled = "You already have a taxi en route or are currently in a taxi."

-- Message shown when the waypoint is too far from any drivable road.
Config.destinationUnreachable = "I cannot drive there, please set a destination near a road."

-- Maximum distance (in meters) a waypoint can be from a road before the driver refuses.
Config.maxWaypointRoadDistance = 40

-- Maximum distance (in meters) the player may be from a road to call a taxi.
Config.spawnDistance = 75