nice work pleb
```markdown
🚗 **RDE | Car Service**
**Premium Vehicle Delivery & Pickup System for FiveM (ox_core)**
Ultra-realistic AI drivers • Full property preservation • Cinematic animations • Production-ready
**License:** MIT
---
🎯 **Overview**
RDE Car Service transforms vehicle management into an immersive experience. Request professional valet drivers to deliver your stored vehicles directly to your location, or have them picked up and safely stored in your garage. Every customization, every modification, perfectly preserved.
🌟 **Why Choose RDE Car Service?**
✅ 100% Property Preservation - All mods, colors, and customizations intact
✅ Ultra-Realistic AI - Professional drivers with natural behavior
✅ Cinematic Animations - Phone calls, parking sequences, key handovers
✅ ox_core Native - Built specifically for ox_core's architecture
✅ Performance Optimized - <0.05ms active, <0.01ms idle
✅ Multi-Language - English & German (easily expandable)
✅ Production Ready - Enterprise-grade error handling & security
✨ **Features**
🚘 **Vehicle Delivery System**
**Intelligent Spawn System**
- Spawns 200m from player on actual roads
- 25-iteration pathfinding for perfect placement
- Ground level verification & collision detection
- Navmesh-based road snapping
**Professional Drivers**
- 9 realistic driver models (valet, pilot, business)
- Follows traffic laws & signals
- Realistic parking sequences
- Natural walk-away behavior
**Full Property Preservation**
- Engine, brakes, transmission upgrades
- All visual mods (bumpers, spoilers, exhausts)
- Custom colors & paint jobs
- Neon lights, window tints, wheels
- Extras (turbo, xenon headlights)
- 5-method extraction for ox_core compatibility
**Cinematic Experience**
- Phone call animations with props
- 4-second precision parking
- 3-second key handover
- Particle effects on arrival
📞 **Vehicle Pickup System**
- On-Demand Retrieval - Right-click any owned vehicle (ox_target)
- AI Driver Response - Professional driver navigates to vehicle location
- Automatic Storage - Vehicle properties saved in configured garage
- Complete Cleanup - Entities removed after timeout
🎨 **Advanced UI/UX**
- ox_lib Context Menus - Beautiful, responsive vehicle selection
- Animated Blips - Pulsating markers with route paths
- Progress Bars - Visual feedback for phone calls & actions
- Sound Effects - Native GTA V audio integration
- Notification System - 4-tier alerts (info, success, warning, error)
💰 **Economy Integration**
- Configurable Pricing - Delivery: $750, Pickup: $500 (customizable)
- ox_core Inventory - Direct integration with character_inventory
- Revenue Tracking - Built-in statistics for deliveries, pickups, earnings
- Admin Commands - /carservice_stats for server monitoring
🔒 **Security & Performance**
- Ownership Validation - Database verification before any operation
- Anti-Spam Protection - 5-second cooldown between requests
- Service Timeout - 10-minute max duration with auto-cleanup
- Error Handling - Comprehensive error codes & fallback systems
- Performance - Optimized threads, entity cleanup, minimal overhead
📦 **Installation**
**Prerequisites**
Ensure you have these resources installed and started before rde_vehicles:
✅ ox_core (latest version)
✅ ox_lib (latest version)
✅ oxmysql (latest version)
⚠️ ox_target (optional, for vehicle interaction)
**Quick Setup**
1. Download & Extract
```
cd resources
git clone https://github.com/RedDragonElite/rde_carservice.git
```
2. Add to server.cfg
```
# Core dependencies (start first)
ensure ox_core
ensure ox_lib
ensure oxmysql
# Optional
ensure ox_target
# RDE Car Service (start after dependencies)
ensure rde_vehicles
```
**Database Verification**
Your vehicles table must have these columns:
- plate (VARCHAR)
- owner (INT)
- model (VARCHAR/INT)
- data (JSON/TEXT)
- stored (VARCHAR)
No additional tables needed! Works with your existing ox_core database structure.
**Configuration (Optional)**
Edit config.lua:
```lua
Config.DeliveryCost = 750 -- Delivery price
Config.PickupCost = 500 -- Pickup price
Config.DefaultGarage = 'legion_garage' -- Your garage name
Config.Locale = 'en' -- 'en' or 'de'
Config.Debug = false -- Debug mode (dev only)
```
**Restart & Test**
```
refresh
restart rde_vehicles
```
Test with: `/carservice`
🎮 **Usage**
**For Players**
**Requesting Delivery:**
- Type `/carservice` or press F7 (if configured)
- Select vehicle from your garage list
- Confirm $750 payment
- Wait for professional driver (ETA displayed)
- Receive vehicle with all mods intact!
**Requesting Pickup:**
- Approach your vehicle
- Right-click with ox_target or use /carservice menu
- Select "Request Pickup"
- Confirm $500 payment
- Driver arrives, takes vehicle to garage
**For Developers**
Trigger Delivery Programmatically:
```lua
local success, vehicleData = lib.callback.await('rde_carservice:requestDelivery', false, plate)
if success then
print('Vehicle delivery initiated:', json.encode(vehicleData))
end
```
Trigger Pickup:
```lua
local netId = NetworkGetNetworkIdFromEntity(vehicle)
local success, coords = lib.callback.await('rde_carservice:requestPickup', false, netId)
```
Cancel Active Service:
```lua
TriggerServerEvent('rde_carservice:cancelService')
```
🔧 **Configuration Examples**
Adjust Delivery Pricing
```lua
Config.DeliveryCost = 1000 -- Premium pricing
Config.PickupCost = 750 -- Higher pickup cost
```
Change Driver Models
```lua
Config.DriverModels = {
`s_m_m_valet_01`, -- Valet uniform
`s_m_m_pilot_01`, -- Pilot outfit
`a_m_m_business_01`, -- Business suit
}
```
Modify Spawn Distance
```lua
Config.SpawnDistance = 150.0 -- Closer spawn (faster delivery)
```
Timing Adjustments
```lua
Config.Timings = {
driverParkDelay = 3000, -- Faster parking
serviceTimeout = 900, -- 15-minute timeout
}
```
Disable Visual Effects (Performance)
```lua
Config.Effects = {
enableParticles = false,
enableSounds = false,
enableBlipAnimation = false,
}
```
🌐 **Localization**
Supported: English (en), German (de)
Add new language in config.lua and set `Config.Locale`
🐛 **Troubleshooting**
- Vehicle Properties Not Applying? → Enable debug & check console
- Driver Not Spawning? → Verify model names & loading
- Money Not Deducting? → Check character_inventory & money item format
📊 **Performance**
- Idle: 0.01ms
- Active: 0.03–0.05ms
- Memory: ~2.5 MB
🛣️ **Roadmap (v2.0)**
- [ ] Multiple Garage Support
- [ ] Express Delivery
- [ ] Delivery Tracking (GPS)
- [ ] Custom Driver Uniforms
- [ ] Helicopter Delivery
- [ ] Damage Compensation
- [ ] VIP Subscription
🤝 **Contributing**
Bugs → Issues
Features/Code → Fork → PR
📄 **License**
MIT License – commercial use allowed
🙏 **Credits**
ox_core • ox_lib • oxmysql
FiveM Community
💬 **Support**
https://github.com/RedDragonElite/rde_carservice
⭐ If you like it – star the repo!
**Made with ❤️ by .:: RedDragonElite ::. | SerpentsByte**
https://github.com/RedDragonElite/rde_carservice
```
Discussion
No replies yet.