Home

TaxiDriver Reloaded Wiki

TaxiDriver Reloaded is a universal taxi gameplay mode for BeamNG.drive Free Roam. It runs as the TaxiDriverHUD UI App and combines dynamic road-graph orders, passenger behavior, navigation, fares, persistent progression, and optional paid refueling and repair.

Documentation version: 5.0.2
Target game version: BeamNG.drive 0.40.5

Start here

• Players: Installation and Quick Start → Gameplay and Ride Lifecycle
• Realistic economy: Realistic Refueling and vehicle repair
• Cargo work: Cargo Deliveries
• Settings and saved progress: Settings, Localization and Audio and Driver Profile and Persistence
• Navigation: Navigation and Map Controls
• Earth world routes and personal trips: Earth Integration
• Experimental connected phone: External Web UI
• Player-owned taxi company: Fleet Operations
• AI Driver: AI Driver Engine 0.39 → AI Driver and Recovery
• Mod developers: Architecture → Runtime Reliability and Performance → Configuration Reference → Lua API and UI Events → HUD State Reference → Developer Guide
• Problems and compatibility: Troubleshooting and Compatibility
• Release history: Changelog

Core capabilities

Area	Implementation
Runtime model	Free Roam GE extension, not a scenario
Dispatcher	10–12 gradually generated regular, rush, multi-stop, and cargo requests with sorting and income-efficiency estimates
Route cache	UI-published offers persisted per map, with semantic and road-edge generation plus cached restoration after map-module failures
Earth support	Experimental world orders, A → B / vehicle → B planning, optional passenger-free navigation, independent streamed maps and a compact street label
Navigation	Private native rectangular minimap that coexists with the stock map, ground route, ETA, speed limit, and dynamic zoom
Passenger model	Random identity, emoji chat, dynamic mood, penalty tolerance, stress, early exit, and optional trip events
Cargo model	2–250 kg physical cargo mass, collision damage, weight premium, delivery rating, and optional fragile-cargo events
Economy	Distance/time fare, rating bonus, cargo weight premium, capped penalties, persistent wallet
Realistic mode	Paid fuel/energy and damage repair, station routing, Magic Fuel fallback, quick-fill presets, projections, and timed service
AI driver	Experimental BeamNG 0.40.5 native-AI integration with asynchronous legal routing, optional strict GPS, bounded following/threat supervision, guarded overtaking/evasion, physical arrival, and drivetrain-aware parking
Fleet	Garage/traffic hiring, persistent native-route workers, reduced-rate traffic guards, bounded current-segment replanning, wages and owner share, live map/world markers, and persistent operating statistics
Persistence	Separate general settings, shareable difficulty, profile, progress, per-vehicle history, restorable shift history, and LAN identity JSON documents
UI	Native Vue 3 driver app with shared precompiled Connected Phone screens with full, compact-map, and button-only stages, 300 × 500 minimum size, stress-tested numeric overflow, 80–180% scaling, ten localizations, bounded motion, and reduced-motion support
Connected phone	Experimental responsive Web UI with QR pairing, lazy optional loading, native-listener/LAN-proxy fallback, automatic or manual LAN addressing, revision-aware map polling, configurable map modes, and iOS-safe audio
Vehicle integration	Lazy-loaded telemetry and cargo extensions, generation-checked Vehicle Bridge callbacks, and a guarded settle period around BeamNG Vehicle Config changes
Diagnostics	Per-subsystem fault boundaries, filtered structured [TaxiDriver] logging, and opt-in streaming JSONL journals for AI route, controller, gearbox, obstacle, signal, recovery, and damage analysis

Repository and releases

• Source repository
• 5.0.2 release
• Latest stable release
• Original TaxiDriver by Incognito

TaxiDriver Reloaded is an independent reimagining. It is not an official update to the original resource.

Documentation map

1. Installation and Quick Start
2. Gameplay and Ride Lifecycle
3. Order Generation and Routing
4. Passengers, Fares and Ratings
5. Realistic Refueling
6. Driver Profile and Persistence
7. Settings, Localization and Audio
8. External Web UI
9. Driver UI Design
10. AI Driver Engine 0.39
11. AI Driver and Recovery
12. Fleet Operations
13. Architecture
14. Runtime Reliability and Performance
15. Configuration Reference
16. Lua API and UI Events
17. HUD State Reference
18. Developer Guide
19. Troubleshooting and Compatibility
20. Earth Integration
21. Third Party Libraries and Source Review

Version 5.0.2 highlights

• Earth roads update in the private TaxiDriver map independently of the stock Navigation widget; compact maps remain visible with taxi mode off.
• Persistent Without a passenger selection for A → B and current vehicle → B routes, with separate GPS progress and no taxi order.
• Fuel and repair access from the phone header and compact HUD during personal trips, preserving the current GPS destination.
• Current street at the bottom centre of the compact HUD, using Earth's existing location data.
• Readable, unminified JavaScript, library descriptions/licenses inside the archive, and resource revision 513.

Existing settings, profiles, progress, fuel, vehicle/shift history, Fleet and LAN records retain their schemas. See Earth Integration, Third Party Libraries and Source Review and Changelog for details.