🚗 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

Download the resource and place it in your resources folder
Import the SQL - Run the SQL file in your database:
```
-- Located in: sql/rental_history.sql
```

Add to server.cfg:

ensure ox_lib
ensure oxmysql
ensure F4-Rental

Configure - Edit config.lua to customize:
- Rental locations
- Available vehicles
- Rental durations
- Pricing
- And more...
Add required item (rental_contract)

ox_inventory

Add this item to your ox_inventory items file (for example ox_inventory/data/items.lua):

['rental_contract'] = {
    label = 'Rental Contract',
    weight = 0,
    stack = false,
    consume = 0,
    close = true,
    description = 'Vehicle rental contract',
    server = {
        export = 'F4-Rental.rental_contract'
    }
},

If you renamed this resource folder, replace F4-Rental with your actual resource name.

qb-inventory / qb-core shared items

Add this item to qb-core/shared/items.lua:

['rental_contract'] = {
    ['name'] = 'rental_contract',
    ['label'] = 'Rental Contract',
    ['weight'] = 0,
    ['type'] = 'item',
    ['image'] = 'rental_contract.png',
    ['unique'] = true,
    ['useable'] = true,
    ['shouldClose'] = true,
    ['description'] = 'Vehicle rental contract'
},

⚙️ 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 = {
    { days = 1, label = "1 Hour", multiplier = 0.5, minutes = 60 },
    { days = 1, label = "3 Hours", multiplier = 0.5, minutes = 180 },
    { days = 1, label = "6 Hours", multiplier = 0.8, minutes = 360 },
    { days = 1, label = "12 Hours", multiplier = 1.0, minutes = 720 },
    { days = 1, label = "1 Day", multiplier = 1.5, minutes = 1440 },
}

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

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
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
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

Accurate Accounting - Late fees are added only when charge succeeds
Retry Logic - If charge fails (insufficient funds), system retries next interval
🎯 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

New Update (Post v1.1.0)

Core Fixes

Fixed proximity fallback when TargetSystem = auto and no target script is running.
Added return interaction registration for ox_target and qb-target.
Synced initial vehicle spawn to server memory/database (vehicleSpawned flow).
Added stale vehicle_spawned recovery to prevent blocked retrieval states.
Added retrieve lock/pending flow to prevent duplicate vehicle spawn race conditions.
Plate is now generated and saved immediately on rental creation.

Security & Validation

Return callbacks now validate rental vehicle proof (netId + rental state checks).
Auto-return event now validates player ownership, vehicle state, and return proximity.
QBX key grant now verifies rental ownership before giving keys.
Added stronger return-location enforcement when Config.ReturnAtAnyLocation = false.

Data Integrity

Improved spawned vehicle lifecycle sync on disconnect and reconnect.
Added configurable reconnect behavior via Config.RespawnOnReconnect.
Position save now validates ownership from database and updates reliably.
Rental contract item is removed on successful return/cancel cleanup paths.

Inventory & UI

rental_contract in ox_inventory is now handled as non-consumable on use.
Added per-character favorites storage in NUI (localStorage scoping).
Fixed contract duration display to correctly use minutes/hours.
Updated price rounding consistency for rental total display.

Late Fee Policy

Late fee total now increases only when actual money removal succeeds.
If charge fails, player is warned and the system retries on next interval.

Defaults / Config

Config.Debug default changed to false for production.

RespawnOnReconnect Demo (Enabled)

This demo shows the behavior when Config.RespawnOnReconnect = true.
If the player disconnects and reconnects, the rented vehicle respawns where it was left.

FilesExpand file tree

README.md

Latest commit

History