GS AI TAXI

Advanced AI Taxi, QS Smartphone App & Dynamic Fare System for FiveM

GS AI TAXI is a fully automated AI taxi system for FiveM with road-based pickup logic, server-side fare calculation, smart path recovery, configurable taxi appearance, unpaid fare dispatch alerts and an embedded QS Smartphone taxi app. Players can call a taxi, enter as a passenger, set a map waypoint and let the AI driver handle the ride.

✨ Main Features

• • AI taxi spawns away from the player and drives to the nearest valid pickup road
• • Player must be close enough to a road before ordering a taxi
• • Taxi waits at pickup and gives the player a configurable no-show timer
• • Player enters as passenger and sets a map waypoint before the taxi starts driving
• • Dynamic fare meter with start fee, per-meter billing and slow-traffic waiting billing
• • Weekday and night surcharge support based on server local time
• • Server-side billing logic for QB-Core, Qbox/QBX and ESX money systems
• • Cash and bank payment support with automatic account fallback
• • Optional pre-check to prevent rides when the player cannot cover the start fee and surcharge
• • Unpaid fare detection with configurable cooldown after failed payment
• • Automatic dispatch alerts for unpaid fares and unpaid destroyed taxi cases
• • Two driving modes: Normal and Fast
• • Real-time on-screen ride HUD with distance, time and fare
• • Configurable taxi model, driver model, drive speed, driving style and arrival distances
• • Smart stuck recovery, flip recovery and rerouting logic
• • Driver seat protection so players stay in passenger seats
• • Automatic taxi cleanup and drive-away behavior after ride end
• • Embedded QS Smartphone taxi app with Call, End, Normal and Fast controls
• • Fully configurable from a clean config file
• • No SQL required

📱 QS Smartphone App

• • Built-in custom app for qs-smartphone
• • Registered through exports['qs-smartphone']:addCustomApp
• • Uses the new iframe / bridge custom app structure
• • App can appear directly on the phone home screen or be configured for app-store style use
• • App buttons can be enabled or disabled from config
• • Phone controls execute the same taxi commands as the normal command flow
• • Includes properly sized 700x700 icon assets
• • Includes light/dark phone theme bridge support

The phone app is included inside the same resource under phone/html. It is designed for the newer QS Smartphone custom app format, not the older phone app structure.

💵 Dynamic Fare & Billing

• • Fare starts only when the actual trip begins
• • Configurable start fee
• • Configurable rate per meter
• • Configurable slow-traffic / stopped waiting charge per second
• • Fare multiplier support per driving mode
• • Distance validation with teleport clamp protection
• • Server checks that the player is inside the taxi before metering
• • No charge if the trip never started, for example no waypoint drive or no-show cancellation
• • Cash first, bank fallback payment flow when both are enabled
• • If payment fails, the ride becomes unpaid and dispatch can be notified

The fare system is designed around GTA-style taxi pricing: start fee, distance, slow traffic waiting time, optional surcharges and mode multipliers.

🧠 AI Driving & Self-Healing Pathing

• • Road-node based pickup and destination handling
• • Taxi spawns at a configurable distance so it does not appear directly beside the player
• • Taxi drives to the pickup road and waits for the passenger
• • Taxi stays stopped until the player sets a valid waypoint
• • Waypoint updates are rate-limited to avoid AI steering spam
• • Destination arrival uses configurable stable arrival checks
• • Taxi can pause at destination and continue to a new waypoint
• • Stuck detection checks progress over time
• • Legit traffic stops can be ignored so traffic lights and traffic jams do not instantly trigger recovery
• • Recovery can retask the driver, move the taxi back to road, or hard recover near the target
• • Flip / rollover recovery support
• • Taxi destruction can end the ride and trigger unpaid logic if payment fails

🚨 Dispatch & Fare Evasion Alerts

• • Dispatch alerts can trigger when a player leaves without paying
• • Dispatch alerts can also trigger when the taxi is destroyed and the fare remains unpaid
• • Provider can be forced or auto-detected
• • Anti-duplicate dispatch cooldown protection
• • Alert data can include fare, street, gender, taxi plate and vehicle status
• • Dispatch provider support: cd_dispatch, rcore_dispatch, ps-dispatch, qs-dispatch, core_dispatch, redutzu-mdt, lb-tablet and wasabi_mdt
• • Provider-specific options for blips, priority, jobs, duration, sounds and metadata

🎨 Taxi Customization

• • Single modular customization config
• • Every appearance feature can be enabled or disabled independently
• • Primary and secondary paint support
• • Plate text and plate style support
• • Wheels, suspension, window tint, xenon, tyre smoke and neon support
• • Interior and dashboard color support
• • Livery, extras and mod slot support
• • Performance options for engine, brakes, transmission, armor, turbo and bulletproof tires
• • Uses GTA/FiveM indices so server owners can tune the taxi without editing client logic

⚙️ Configuration

• • Framework mode: auto, ESX, QB-Core, Qbox/QBX or standalone
• • Taxi model and driver model
• • Spawn search radius, minimum pickup distance and far spawn distance
• • Arrival radius, stable arrival time and destination update cooldown
• • No-show timer and despawn timer
• • Start fee, per-meter fare, slow traffic speed threshold and waiting charge
• • Weekday and night surcharges
• • Cash and bank payment behavior
• • Normal and fast driving mode settings
• • On-screen HUD position, size and text scale
• • Command names and command enable/disable toggles
• • QS Smartphone app settings, app id, label, category and button visibility
• • Dispatch provider, auto-detection order, job names, alert code, blip and provider-specific settings

⌨️ Commands

• • /calltaxi — Call an AI taxi to your nearest valid pickup road
• • /taximode normal — Set taxi driving mode to Normal
• • /taximode fast — Set taxi driving mode to Fast
• • /taxiend — End or cancel the current taxi ride

Command names can be changed in the config file, and commands can also be disabled if you only want to use exports or the phone app.

🔌 Exports

• • exports['gs_ai_taxi']:CallTaxi()
• • exports['gs_ai_taxi']:SetMode(mode)
• • exports['gs_ai_taxi']:EndTaxi()

⚙️ Dependencies

• • qs-smartphone required for this embedded phone-app build
• • QB-Core, Qbox/QBX or ESX required for built-in money removal / payment handling
• • Standalone framework mode is available, but standalone servers should connect their own payment logic or adjust payment settings
• • Dispatch system is optional and only needed for fare evasion alerts
• • OneSync enabled server recommended for reliable networked AI taxi behavior
• • No SQL database required

📦 Installation

• • Copy gs_ai_taxi into your server resources folder
• • Make sure qs-smartphone is started before GS AI Taxi
• • Configure framework, taxi model, pricing, dispatch and phone app settings in config/config.lua
• • Add the resource to your server.cfg
• • Restart the server and test /calltaxi or open the Taxi app from QS Smartphone

ensure qs-smartphone
ensure gs_ai_taxi

Important Notes

• • The taxi will not start driving without a map waypoint
• • The player must be near a road to order a taxi
• • If another script heavily controls player vehicles or AI tasks, test compatibility on a development server first
• • For unpaid fare alerts, at least one supported dispatch provider must be installed and started
• • For built-in payments, use QB-Core, Qbox/QBX or ESX money systems
• • This build uses the newer QS Smartphone custom app structure

© 2026 GameServers.fi | GS AI TAXI v2.0.3