🚗 F4-Rental - Professional Car Rental System

A modern, fully-featured car rental system for FiveM servers with a beautiful UI, contract system, and automatic expiry management.

✨ Features

• 🎨 Modern Dark UI - Beautiful, responsive interface with smooth animations
• 📋 Digital Contracts - Usable rental contract items with all rental details
• ⏰ Automatic Expiry System - Warnings before expiry and late fee management
• 🚙 My Rentals Tab - Track all your active rentals in one place
• 💰 Flexible Pricing - Hourly-based pricing with customizable durations
• 🔑 Vehicle Keys Integration - Automatic key assignment (qb-vehiclekeys/qbx_vehiclekeys)
• 💾 Vehicle Persistence - Rented vehicles persist across reconnects
• 🗺️ Return Location GPS - Automatic waypoint to return location on expiry

📸 Screenshots

Click to view screenshots

Main Rental Interface

My Rentals

Rental Contract

Expiry Warning

Return Location GPS

📦 Dependencies

• ox_lib
• oxmysql
• Framework: QBCore / QBox / ESX Legacy

Optional

• ox_target / qb-target / interact
• ox_inventory / qb-inventory
• qb-vehiclekeys / qbx_vehiclekeys

🛠️ Installation

1. Download the resource and place it in your resources folder

2. Import the SQL - Run the SQL file in your database:

   -- Located in: sql/rental_history.sql

3. Add to server.cfg:

   ensure ox_lib
   ensure oxmysql
   ensure F4-Rental

4. Configure - Edit config.lua to customize:

   • Rental locations
   • Available vehicles
   • Rental durations
   • Pricing
   • And more...

⚙️ Configuration

Rental Locations

Config.Locations = {
    {
        name = "Premium Rentals",
        coords = vector3(-50.0, -1090.0, 26.5),
        spawnPoint = vector4(-47.0, -1095.0, 26.5, 160.0),
        blip = { sprite = 56, color = 5, scale = 0.8 },
    },
}

Rental Durations

Config.RentalDurations = {
    { label = "1 Hour", hours = 1, multiplier = 1.5 },
    { label = "3 Hours", hours = 3, multiplier = 1.3 },
    { label = "6 Hours", hours = 6, multiplier = 1.2 },
    { label = "12 Hours", hours = 12, multiplier = 1.1 },
    { label = "24 Hours", hours = 24, multiplier = 1.0 },
}

Vehicles

Config.Vehicles = {
    {
        model = "sultan",
        label = "Sultan",
        manufacturer = "Karin",
        category = "Sports",
        price = 500,
        image = "https://docs.fivem.net/vehicles/sultan.webp",
        stats = { speed = 75, acceleration = 70, braking = 65, handling = 72 },
    },
}

🔧 Framework Support

Framework	Status
QBox (qbx_core)	✅ Full Support
QBCore	✅ Full Support
ESX Legacy	✅ Full Support

📝 License

This resource is free to use and redistribute. Resale is not permitted.

💬 Support

For support, please open an issue on GitHub or contact the author

🔧 Fixed Issues

Issue	Status
Vehicle duplication after server restart	✅ Fixed
Multiple rentals bypass after disconnect	✅ Fixed
Retrieve spawning duplicate vehicles	✅ Fixed
Return not updating database	✅ Fixed

🆕 Latest Updates (v1.1.0)

🎥 Update Showcase

✅ Major Fixes & Improvements

Customer Reported Issues - RESOLVED

1. DoesEntityExist Script Error (interact/sleepless_interact)

   • ✅ Fixed entity parameter validation in return vehicle event
   • ✅ Added comprehensive type checking and conversion
   • ✅ No more script errors when using target systems

2. Rental Data Not Deleting After Return

   • ✅ Changed database operation from UPDATE to DELETE
   • ✅ Rentals now properly removed from database on return
   • ✅ Clean database without leftover rental records

3. QBCore Callback Data Handling

   • ✅ Fixed callback bridge for QBCore framework
   • ✅ Proper data passing between client and server
   • ✅ DELETE operations now work correctly in QBCore

Late Fee System Enhancements

• 💰 Negative Balance Support - Late fees apply even with insufficient funds
• 🔄 Continuous Charging - Fees continue until vehicle is returned
• 🎯 Smart Detection - Only charges online players
• 🗑️ Auto-Cleanup - Offline expired rentals are deleted without fees

Database Management

• 🗄️ Clean Records - All returns now DELETE instead of UPDATE status
• 🚀 Better Performance - Fewer database records to query
• 📊 Accurate Tracking - Only active rentals in database

Code Quality Improvements

• 🐛 Enhanced Debugging - Comprehensive debug logging for troubleshooting
• ✅ Better Validation - Improved entity and data validation
• 🔒 Safer Operations - Proper error handling and fallbacks

📋 Technical Changes

// Before (Old Code)
UPDATE rental_history SET status = 'returned' WHERE id = ?

// After (New Code)
DELETE FROM rental_history WHERE id = ? AND citizenid = ?

🎮 Player Experience

• ✅ Smoother return process without errors
• ✅ Clear balance warnings when going negative
• ✅ Fair system: only online players pay late fees
• ✅ Offline players don't accumulate charges

---

Demo Videos