🚙VEHICLE RENTAL
📖 Description
Vehicle rental script for FiveM compatible with ESX and QB-Core. This script allows players to rent vehicles at different locations on the map, with an automatic hourly billing system and damage management.
✨ Features
✅ Compatible with ESX and QB-Core
✅ Modern and intuitive NUI interface
✅ Automatic hourly billing system
✅ Damage management with financial penalties
✅ Vehicle return system
✅ Map blips for rental locations
✅ NPCs with customizable props
✅ Support for multiple simultaneous locations
✅ Maximum 10 vehicles per location
✅ Automatic license plate generation
🚀 Installation
Prerequisites
ESX or QB-Core framework installed and functional
FiveM Server with base resources
Installation Steps
Download the script and place it in your
resourcesfolderRename the folder to
rental(or your preferred name)Configure the framework in
shared/_main.lua:ConfigShared.Core = "ESX" -- or "QB-Core"Add the script to your
server.cfg:ensure rentalRestart your server
⚙️ Configuration
Framework Configuration
Open shared/_main.lua to configure your framework:
ConfigShared.Core = "ESX" -- "ESX" or "QB-Core"
ConfigShared.CoreExport = function()
return exports['es_extended']:getSharedObject()
-- or for QB-Core:
-- return exports['qb-core']:GetCoreObject()
end
ConfigShared.Debug = true -- Enable debug messagesLocation Configuration
All main configurations are located in shared/config.lua:
General Settings
Config = {
Fee = 150, -- Price per rental hour
SetBlip = true, -- Show blips on map
MaxTime = 10, -- Maximum time before billing (in seconds)
Locations = {
-- Your locations here
}
}Location Structure
["LOCATION_NAME"] = {
coords = {
model = "s_f_y_baywatch_01", -- NPC model (Ped)
rent = vector3(x, y, z), -- NPC position
spawn = vector3(x, y, z), -- Vehicle spawn position
teleport = vector3(x, y, z), -- Teleport position after return
heading = 190.0 -- NPC orientation
},
spawn2 = {
pos = vector3(x, y, z) -- Alternative spawn position
},
prop = {
model = "prop_surf_board_01", -- Prop model (nil to disable)
coordEntity = vector3(0, 0, 0), -- Offset from entity center
coordAxis = vector3(-80, 0, 0), -- Axis rotation
},
Vehicles = {
{name = "seashark", label = "Seashark", price = 500},
-- Maximum 10 vehicles
},
Blip = {
sprite = 409, -- Blip sprite
color = 36, -- Blip color
name = "Rental Test 1" -- Blip name
}
}Text Configuration
Texts are configurable in shared/dialogue.lua:
Config.Dialogue = {
Location = "Press [~o~E~s~] to Rent",
Return = "Press [~o~E~s~] to Return the Rental",
MessageLocation = "You are renting equipment...",
VehicleBlocked = "A vehicle is blocking the exit...",
Bill = "The rental service has charged you...",
NoReturn = "You have not returned your last rental...",
Damage = "You have damaged the equipment...",
GoodReturn = "Thank you for your return..."
}🎮 Usage
For Players
Approach a rental NPC (visible on the map with a blip)
Press E to open the rental menu
Select a vehicle from the list
Pay the rental price
Pick up your vehicle at the indicated spawn point
Return the vehicle at the return point before the time expires
Billing System
Automatic billing: If the player exceeds the allowed time, they are automatically billed
Damage management: Vehicle damage is charged upon return
Payment priority: The system first withdraws from the bank, then from cash
📁 File Structure
rental/
├── client/
│ ├── _main.lua # Main client script
│ └── function.lua # Client functions
├── server/
│ └── _main.lua # Main server script
├── shared/
│ ├── _main.lua # Framework configuration
│ ├── config.lua # Location configuration
│ ├── dialogue.lua # Texts and dialogues
│ └── function.lua # Shared functions
├── html/
│ ├── index.html # NUI interface
│ ├── css/
│ │ └── style.css # CSS styles
│ ├── js/
│ │ └── index.js # JavaScript script
│ └── img/ # Vehicle images
└── fxmanifest.lua # FiveM manifest🔧 Customization
Adding a New Location
Open
shared/config.luaAdd a new entry in
Config.Locations:
["MY_NEW_LOCATION"] = {
coords = {
model = "a_m_y_cyclist_01",
rent = vector3(-1204.074707, -1554.830811, 4.359009),
spawn = vector3(-1204.048340, -1542.659302, 4.291626),
teleport = vector3(-1205.525269, -1551.942871, 4.359009-0.97),
heading = 0.0
},
spawn2 = {
pos = vector3(-1204.048340, -1542.659302, 4.291626)
},
prop = {
model = nil,
coordEntity = vector3(0, 0, 0),
coordAxis = vector3(0, 0, 0),
},
Vehicles = {
{name = "zentorno", label = "Zentorno", price = 800},
},
Blip = {
sprite = 409,
color = 36,
name = "My Rental"
}
}Changing NPC Models
Check the list of Ped models at: https://wiki.rage.mp/index.php?title=Peds
Changing Props
Check prop models at: https://gtahash.ru/
Modifying Blips
Check blip sprites and colors at: https://wiki.rage.mp/index.php?title=Blips
🐛 Troubleshooting
Menu doesn't open
Check that the script is started (
ensure rental)Check for errors in the F8 console
Make sure you are close enough to the NPC (< 2.5 units)
Vehicle doesn't spawn
Check that the spawn point is not blocked
Check that the vehicle name is correct
Check for errors in the server console
Billing doesn't work
Check the framework configuration in
shared/_main.luaCheck that the player has enough money
Enable debug to see logs:
ConfigShared.Debug = true
📝 Important Notes
⚠️ Maximum 10 vehicles per location in configuration
⚠️ The system checks rentals every 30 seconds
⚠️ Make sure spawn coordinates are free and accessible
⚠️ The script automatically generates plates in "LOC XXX" format
Note: This script is compatible with ESX and QB-Core frameworks. Make sure to properly configure the framework in shared/_main.lua before use.
Last updated