A comprehensive escort job script for FiveM inspired by the classic GTA San Andreas "Pimp" missions. Players pick up NPC clients, transport them to destinations, and earn cash and reputation — with optional special service encounters along the way.
Requirements#
Before installing, make sure the following are already running on your server:
| Dependency | Required | Notes |
|---|---|---|
qb-core | ✅ Yes | Core framework |
oxmysql | ✅ Yes | Database connector |
qb-menu | ✅ Yes | Menu UI |
| MySQL / MariaDB | ✅ Yes | MariaDB 10.3+ or MySQL 5.7+ |
ox_lib | ⚠️ Optional | For modern ox_lib notifications |
qb-phone | ⚠️ Optional | For phone-style notifications |
Feature Highlights#
- Escort Job Loop — Pick up clients from marked locations, drive them to a destination, collect payment.
- Dynamic NPC Clients — 33+ preconfigured ped models with idle animations while waiting. Addon peds are supported.
- Blacklist Protection — Problematic ped models (especially those that despawn with OneSync) are automatically skipped.
- Dialogue System — Clients speak context-aware lines at pickup, during transit, and at drop-off.
- Special Service Offers — Optional interactions with configurable chance percentages and bonus payouts.
- Photographer NPC System — An NPC photographer may appear during special services, complete with camera flash effects.
- Ranking System — Four reputation-based ranks from Rookie Escort to VIP Escort, each unlocking higher earnings.
- Flexible Notifications — Supports QB-Core, qb-phone, ox_lib, and chat notification systems.
- GPS Waypoints — Automatic map waypoints guide players to pickup and drop-off points.
- 3D Text UI — On-screen interaction prompts appear near NPC clients.