A comprehensive escort job script for FiveM inspired by GTA San Andreas "Pimp" mission, designed for QBCore framework with advanced features, immersive gameplay, and cutting-edge enhancements.
Prerequisites & Dependencies
Before installing, ensure you have:
-
✅ **QBCore or QBox **(Latest version)
-
✅ MySQL Database (MariaDB 10.3+ or MySQL 5.7+)
-
✅ oxmysql (Database connector for QBCore)
-
ox_target (Optional but Highly Recommended) (Fallsback to toggle keys)
Optional Enhancements
For enhanced experience, consider installing:
- 📋 ox_lib - Modern notification system with better UI
Features:
🎬 Photographer NPC System
-
📸 Dynamic Photographer Spawning - NPCs appear during special services to take pictures
-
🎭 Realistic Camera Animations - Professional paparazzi-style photography with flash effects
-
⚙️ Fully Configurable - Spawn chance, frequency, distance, and ped models all customizable
-
🔄 Smart Cleanup - Automatic photographer removal after services complete
🪑 Table-Based Intimate Animations
-
� Enhanced Scenes - Table props spawn for varied intimate experiences
-
🎲 Random Scenarios - 33% chance for table-based encounters during special services
-
🎨 Immersive Positioning - Proper ped placement and realistic interaction sequences
-
🧹 Memory Management - Automatic prop cleanup prevents resource leaks
🛡️ Advanced Ped Validation System
-
🚫 Blacklisted Ped Prevention - Automatic filtering of problematic models (OneSync compatibility)
-
🔄 Smart Model Selection - Multiple fallback attempts before using guaranteed working models
-
� Enhanced Logging - Detailed console output for debugging ped issues
-
⚡ Performance Optimized - Efficient model loading with timeout protection
� Enhanced Animation System
-
🔄 Seamless Transitions - Smooth animation switching between different phases
-
🎭 Context-Aware Animations - Different animations for different service types and scenarios
-
🎪 Fallback Mechanisms - Graceful degradation when animations fail to load
-
🎨 Visual Feedback - Progress indicators and status updates during scenes
📋 Core Features
🚗 Advanced Escort System
-
Smart Client Pickup & Dropoff: Enhanced AI for realistic client behavior with natural pathfinding
-
Interactive NPCs: Dynamic client spawning with 33+ preconfigured models + addon ped support
-
GPS Navigation: Waypoint system for routing to destinations
-
3D Text Interaction: Clear visual indicators with emoji-enhanced UI
-
Dynamic Dialogue System: Context-aware conversations with speech synthesis
-
Blacklist Protection: Automatic filtering of problematic ped models for OneSync servers
🎭 Immersive Client Interactions
-
Client Speech System: Realistic voice lines for all interaction phases
-
Special Service Offers: Optional intimate content with enhanced animations and table scenarios
-
Accept/Decline Mechanics: Player choice in service offerings with visual feedback
-
Contextual Dialogue: Different conversations for pickup, transit, and dropoff
-
Natural Client Behavior: Realistic movement and pathfinding with smart positioning
-
Photographer Integration: NPCs may appear during special services for added realism
💰 Advanced Payment & Progression
-
Base Payment: $250-$400 per completed job with reputation multipliers
-
Service Bonuses: Additional payments for special services with table scenarios
-
Reputation Multipliers: Earnings scale with your escort reputation and rank
-
Smart Tip System: Dynamic tipping based on performance and service quality
-
Multiple Revenue Streams: Various service types with different payouts and bonuses
🏆 Comprehensive Ranking System
Four distinct ranks with exclusive benefits:
-
Rookie Escort (0+ rep) - Starting tier with basic privileges
-
Pro Escort (10+ rep) - Enhanced earning potential
-
Elite Companion (25+ rep) - Premium service access
-
VIP Escort (50+ rep) - Maximum benefits and exclusive content
🎨 Cutting-Edge UI & Effects
-
Custom Visual Effects: Configurable screen effects for different scenarios and services
-
Enhanced Notification System: Support for QB-Core, ox_lib, qb-phone, and chat systems
-
Interactive Progress UI: Real-time scene progress with visual feedback and status updates
-
Offer-Specific Effects: Unique visual styles for different service types and scenarios
-
Screen Filters & Overlays: Immersive visual atmosphere with camera flash effects
-
Photographer Flash System: Realistic camera flash effects during photo sessions
📍 Strategic Locations
Pickup Locations (8 spots):
-
🍸 Tequilla Lounge - High-end clientele
-
🏛️ Near Mission Row PD - Discrete location
-
🏥 Pillbox Hill - Medical district
-
🛠️ Rockford Plaza - Shopping area
-
🎾 Richman Tennis Courts - Upscale neighborhood
-
🏨 Richman Hotel - Luxury destination
-
🌭 Hot Dog STand in Sandy Shores
-
⛽ LTS Gas Station in Davis
Dropoff Locations (7 destinations):
-
✈️ Los Santos Airport - International travel
-
🏪 Suburban Store - Shopping convenience
-
🏠 Del Perro Apartment - Residential area
-
🚇 Subway Station - Transportation hub
-
🏛️ Kortz Center - Cultural district
-
🏔️ Vinewood Hills - Celebrity homes
-
🏨 Clothing Shop in Grapeseed
🗺️ Navigation System
-
GPS Waypoints: Basic waypoint system for navigation
-
Distance Monitoring: Real-time distance updates and notifications
-
Smart Routing: Pathfinding to pickup and dropoff destinations
-
Enhanced Blips: Improved map markers with route visualization
📸 Photographer NPC System
-
Dynamic Spawning: NPCs randomly appear during special services (configurable 75% chance)
-
Professional Animations: Realistic paparazzi-style photography with camera poses
-
Camera Flash Effects: Screen flash effects synchronized with photo-taking actions
-
Smart Positioning: Photographers spawn at optimal distance and angles for realistic shots
-
Configurable Behavior: Customize spawn chance, photo frequency, max pictures, and ped models
-
Automatic Cleanup: Photographers despawn after services complete or on timeout
🎮 How to Play
Getting Started
- 🗺️ Find Pickup Locations: Visit pink blips on the map (8 locations available)
-
🤝 Request Client: Press
Eat any pickup location when no contract is active - ⏳ Wait for Assignment: A client will spawn with random appearance and personality
- 🚗 Vehicle Preparation: Get a vehicle and wait for the client to approach
During Contracts
- 🚪 Client Entry: Client will automatically enter your vehicle when you get in
- 🧭 Navigation: Follow GPS waypoints or turn-by-turn directions (if available)
- 💬 Transit Conversation: Enjoy realistic dialogue during the ride
- 📍 Destination Arrival: Drive within 15m of the dropoff location
- 👋 Client Departure: Client will exit and walk away naturally
Special Interactions
-
🎭 Service Offers: Some clients may offer additional services (configurable)
-
✅ Accept/Decline: Use
Gto accept orHto decline special offers -
💰 Bonus Payments: Special services provide additional income
-
🏆 Reputation Building: Complete contracts to increase your rank
Advanced Features
-
🗺️ GPS Navigation: Waypoint-based routing to destinations
-
📱 Multi-Platform Notifications: Choose your preferred notification system
-
🎨 Visual Effects: Enjoy custom UI effects during interactions
-
🎤 Client Speech: Hear realistic voice lines throughout the experience
Dialogue Customization
-
📝 Pickup Lines: Client greetings and initial conversation
-
🚗 Transit Dialogue: Conversations during transportation
-
👋 Dropoff Lines: Farewell messages and completion dialogue
-
🎭 Special Offers: Service-specific dialogue options
-
💬 Dynamic Content: Context-aware conversation system
🔧 Technical Specifications
Framework Compatibility
-
🎯 Primary Framework: QBCore (Latest)
-
📊 Database: MySQL/MariaDB via oxmysql
-
🎮 FiveM Version: Compatible with latest builds
-
💾 Lua Version: 5.4+
Notification Systems Supported
-
📱 QB-Core: Default QBCore notification system
-
📞 qb-phone: Phone-based notifications with custom styling
-
📋 ox_lib: Modern notification system with positioning
-
💬 Chat: Simple chat-based notification fallback
Performance Features
-
⚡ Optimized Threading: Efficient resource usage with smart Wait() intervals
-
🧠 Smart AI: Advanced pathfinding and behavior systems
-
🔄 Fallback Systems: Graceful degradation when optional resources unavailable
-
🛡️ Error Handling: Comprehensive error management and recovery
Addon Support
-
🎭 Custom Ped Models: Full support for addon ped resources
-
** Modular Design**: Easy integration with other scripts
-
📦 Resource Management: Intelligent model loading with timeouts
📝 Commands & Controls
Player Controls
-
EKey: Request client at pickup locations / Start contracts -
GKey: Accept special service offers -
HKey: Decline special service offers -
🗺️ GPS Navigation: Follow waypoints to destinations
🎯 Reputation & Progression System
Reputation Mechanics
Your escort reputation directly affects:
-
💰 Base Payment Multipliers: Higher rep = higher base earnings
-
🎁 Tip Probability: Better reputation increases tip chances
-
👑 Rank Progression: Unlock prestigious titles and benefits
-
🎭 Service Access: Higher ranks unlock exclusive content
-
💼 Client Quality: Better reputation attracts premium clients
Rank Benefits & Requirements
Rank
Reputation Required
Benefits
🆕 Rookie Escort
0+
Base payments, standard tips
💼 Pro Escort
10+
+10% earnings, better tip rates
👑 Elite Companion
25+
+25% earnings, premium clients
� VIP Escort
50+
+50% earnings, exclusive content
Progression Tips
-
🔄 Complete Regular Contracts: Steady reputation building
-
⭐ Provide Quality Service: Professional behavior increases tips
-
🎭 Accept Special Offers: Bonus reputation and payments
-
📈 Consistent Performance: Regular play maintains momentum
🚨 Important Information
Content Warnings
-
🔞 Mature Content: Script contains adult-themed dialogue and interactions
-
👥 Age Verification: Ensure players meet age requirements
-
📋 Server Guidelines: Verify compatibility with your server's rules
-
⚖️ Platform Compliance: Follow FiveM and Discord ToS guidelines
Best Practices
-
🛡️ Regular Backups: Backup your database before updates
-
📊 Monitor Performance: Check console for any error messages
-
🔄 Update Dependencies: Keep QBCore and other resources current
-
👥 Community Guidelines: Establish clear rules for mature content
Support & Compatibility
-
✅ Tested Compatibility: QBCore latest versions
-
🔄 Regular Updates: Ongoing maintenance and feature additions
-
🐛 Bug Reports: Use GitHub issues for problem reporting
-
💡 Feature Requests: Community feedback welcome
🆘 Troubleshooting
Script Details:
-
📦 Package Name: JM-Pimping
-
🏷️ Version: 1.0.0 (Enhanced with Photographer System)
-
👤 Author: JM Modifications
-
🎯 Framework: QBCore
-
🎮 Inspiration: GTA San Andreas Pimp Mission
-
📸 Photographer NPC System - Dynamic paparazzi with camera flash effects
-
🪑 Table-Based Intimate Animations - Enhanced scenes with prop spawning
-
🛡️ Advanced Ped Validation - Blacklist system for OneSync compatibility
-
🎯 Enhanced Animation System - Improved transitions and fallback mechanisms
-
🔧 Debug Command Expansion - Comprehensive testing and troubleshooting tools
-
🎨 Visual Effect Improvements - Better UI feedback and immersive experiences
-
⚡ Performance Optimizations - Memory management and resource cleanup
🆘 Troubleshooting
Common Issues & Solutions
🚫 Client Not Spawning
-
Check console for model loading errors and blacklisted model warnings
-
Verify database connection and table creation
-
Ensure QBCore is running properly
-
Use
/listblacklistedto check for problematic models -
Check if OneSync is causing ped model issues
📸 Photographer Not Appearing
-
Check
Config.Photographer.enabled = truein config -
Verify spawn chance percentage (default 75%)
-
Use
/testphotographerto manually test spawning -
Check
/photographerstatusfor system status
🪑 Table Animations Not Working
-
Ensure special services are enabled in config
-
Check console for prop spawning errors
-
Verify animation dictionaries are loading properly
-
Table scenarios have 33% random chance to trigger
🗺️ Navigation Not Working
-
Check
/navstatuscommand for system status -
Verify waypoints are being set on the map
-
Restart the resource if waypoints are not appearing
🎭 Addon Peds Not Loading
-
Verify addon ped resource is started
-
Check model names in config match exactly
-
Script automatically falls back to base game models
-
Use
/checkpedmodelto verify current ped information
🔊 No Speech/Audio
-
Check
Config.UIEffects.sound_effects = true -
Verify
Config.UIEffects.enabled = true -
Ensure client peds exist and are properly spawned
⚡ Performance Issues
-
Monitor server performance during peak usage
-
Check for conflicting scripts
-
Verify database optimization
📄 License & Credits
This script is provided as-is for educational and entertainment purposes. Please respect the author's work.
Credits:
-
Original concept inspired by GTA San Andreas
-
Enhanced for FiveM QBCore framework
-
Community feedback and testing contributions
⚠️ Mature Content Warning: This script contains adult-themed content and should only be used on servers with appropriate age verification, community guidelines, and platform compliance.