🚗 Installation Guide - Vehicle Rental System

🔧 Installation Steps

📂 1. Upload the script to your server

Place the script folder inside resources/ on your FiveM server.

⚙ 2. Configure the config.lua file

Customize the script to fit your server’s needs. You can modify:

• 🌎 Language: es | en | fr (Config.Locale)

Config.Locale = 'en'  --es | en | fr

• 💵 Rental Payment Item: Set the in-game item used for payment (Config.BillItem)

Config.BillItem = 'bill' --Put the name of the item you want here

• ⏳ Max Rental Time: Define the max rental duration in minutes (Config.MaxMinutes)

Config.MaxMinutes = 120  --Put here what you want the maximum rental amounts to be

• 🔗 Discord Webhook: Log transactions and events (Config.Webhook)

  • Customizable name, color, and images.

  Config.Webhook = {
      URL = 'https://discord.com/api/webhooks/your-webhook-url', --Put your Webhook here
      Name = 'Alquiler de Vehículos', --Put the name of the webhook here
      Color = 16711680, -- Set the color of your webhook (html) here
      Image = 'https://example.com/image.png', --Put your webhook image here
      Thumbnail = 'https://example.com/thumbnail.png' --Put your webhook image here
  

🚶‍♂️ 4. Configure NPCs & Locations

• Set NPC spawn locations (Config.NPCs).

• Define vehicle spawn points.

• Customize blips (map icons) and 3D text (multilingual).

Config.NPCs = {
    {
        coords = { x = -1034.61, y = -2733.6, z = 20.17, heading = 328.5 }, --Put here the coordinates where the NPC is
        model = 'a_m_y_business_01', --Put the ped model here, you can search for them at https://wiki.rage.mp/wiki/Peds
        vehicleSpawn = { x = -1037.0, y = -2730.0, z = 20.0, heading = 328.5 }, --Put here where you want the car to respawn
        blip = {
            sprite = 225,
            color = 3,
            scale = 1.0,
            text = 'Alquiler de Vehículos'
        },
        text3D = {
            visible = true, 
            text = {
                en = 'Vehicle Rental',
                es = 'Renta de Vehículos',
                fr = 'Location de Véhicules'
            },
            distance = 10.0 
        }
    },
    
}

🚘 5. Configure Rental Vehicles & Prices

• Add or remove vehicles in Config.Vehicles.

• Set per-minute rental prices for each car.

Config.Vehicles = {
    { label = 'Adder', model = 'adder', pricePerMinute = 100 },
    { label = 'Zentorno', model = 'zentorno', pricePerMinute = 150 },
    { label = 'T20', model = 't20', pricePerMinute = 200 }
}

⛏️ 6. Add the item to the ox_inventory

• Go to ox_inventory\data\items.lua

• Go to the last line and add the following:

	["bill"] = {
		label = "Rental Bill",
		weight = 10,
		stack = true,
		close = true,
	},

📍7. Add the image of the item in ox_inventory

• Go to \syntax_rental[Images] and copy the image

• Now go to \ox_inventory\web\images and paste the image

📜 8. Add the script to your server.cfg

Inside server.cfg, add:

ensure syntax_rental

🔄 9. Restart your server & enjoy!

✅ Players can now rent vehicles seamlessly and explore the city with ease!