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 Framework (Latest version)
• ✅ MySQL Database (MariaDB 10.3+ or MySQL 5.7+)
• ✅ oxmysql (Database connector for QBCore)
• ✅ qb-menu (For menu interfaces)
• ⚠️ qb-target (Optional - for interaction system, not fully integrated yet)

Optional Enhancements

For enhanced experience, consider installing:

• 📋 ox_lib - Modern notification system with better UI
• 📞 qb-phone - Phone-based notifications (if using qb-phone)

✨ Latest v1.0 Features & Enhancements

🎬 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

1. 🗺️ Find Pickup Locations: Visit pink blips on the map (8 locations available)
2. 🤝 Request Client: Press E at any pickup location when no contract is active
3. ⏳ Wait for Assignment: A client will spawn with random appearance and personality
4. 🚗 Vehicle Preparation: Get a vehicle and wait for the client to approach

During Contracts

1. 🚪 Client Entry: Client will automatically enter your vehicle when you get in
2. 🧭 Navigation: Follow GPS waypoints or turn-by-turn directions (if available)
3. 💬 Transit Conversation: Enjoy realistic dialogue during the ride
4. 📍 Destination Arrival: Drive within 15m of the dropoff location
5. 👋 Client Departure: Client will exit and walk away naturally

Special Interactions

• 🎭 Service Offers: Some clients may offer additional services (configurable)
• ✅ Accept/Decline: Use G to accept or H to 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

• E Key: Request client at pickup locations / Start contracts
• G Key: Accept special service offers
• H Key: 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 /listblacklisted to check for problematic models
• Check if OneSync is causing ped model issues

📸 Photographer Not Appearing

• Check Config.Photographer.enabled = true in config
• Verify spawn chance percentage (default 75%)
• Use /testphotographer to manually test spawning
• Check /photographerstatus for 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 /navstatus command 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 /checkpedmodel to 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.