NPC Mechanic brings an advanced AI-driven roadside assistance experience to your FiveM server.
Players can call an NPC mechanic through the Quasar Smartphone (qs-smartphone) or, optionally, with the /chamarmecanico command.
The NPC mechanic drives a tow truck from the configured base, navigates dynamically to the player’s location, repairs their vehicle, processes payment automatically, and returns to base — all without player intervention.
Quasar Phone integrationFully compatible with qs-smartphone. Players can call the configured mechanic number, and the NPC will automatically respond and head to their position.
(You can disable phone usage via Config.UsePhone = false to use only the command instead.)
Smart AI Navigation
The mechanic uses realistic driving tasks (TaskVehicleDriveToCoordLongrange) and despawns only after leaving player sight, simulating a natural workflow.
Dynamic Pricing System
The total repair price is calculated based on distance (per kilometer).
A configurable percentage automatically goes to the society account (e.g., society_mechanic).
Intelligent Service Logic- NPC mechanics can only be called when there are no human mechanics on duty.
- Cooldowns prevent spam requests.
- Max concurrent NPCs configurable via Config.MaxConcurrentNPCs.
Secure Token System- Each NPC service call generates a unique token with HMAC-style verification.
- Prevents exploit attempts, fake triggers, or duplicated payments.
Discord Webhook Logging- Optional JSON embed logs for every event: call, cancel, and payment.
Configurable Base Location- Define your own mechanic base using vector4(x, y, z, heading).
- The NPC spawns there and drives to the player using natural pathfinding.
Realistic Repair Animation- Mechanic exits the truck, plays a “repair vehicle” scenario, fixes all damage, and restarts the engine.
Last edited by a moderator:
