⚙️Configuration

All configuration for Rentals V2 is handled inside config.lua. Below is a breakdown of every option and what it does.

Framework Integrations

Config.Locale = "en"
Config.Notifications = "ox_lib"
Config.Target = "auto"
Config.VehicleKeys = "auto"
Config.Inventory = "auto"

Option	Description	Values
Locale	Language used across the script	"en" "es" "fr" "de"
Notifications	Notification system	"qb-core" "ox_lib" "auto"
Target	Target system	"ox_target" "qb-target" "auto"
VehicleKeys	Vehicle key system	"auto" "qb" "wasabi" "MrNewb"
Inventory	Inventory system for cash handling	"auto" "ox_inventory" "origen_inventory" "tigann-inventory" "qb-inventory" "ps-inventory" "core_inventory"

💡 Setting any of the above to "auto" will let the script detect your framework automatically. This works for most servers and is recommended unless you run into issues.

---

Screenshot / Image Upload

Config.Screenshot = {
    url      = 'https://api.fivemanage.com/api/image',
    apiKey   = 'Place_Your_API_HERE',
    encoding = "webp",
}

Option	Description
url	The API endpoint images are uploaded to
apiKey	Your authorization key for the image API
encoding	Format images are saved in: "webp" "jpg" "png"

💡 You don't have to use FiveManage — however it is what we recommend. It's one of the most popular and completely free image APIs available right now and the easiest to get set up. → Guide: Getting your FiveManage API Key

---

Feature Flags

Config.allowJGfinanced = false
Config.CanEditVehicleName = true

Option	Description
allowJGfinanced	If true, vehicles financed through JG-Dealership can be listed for rent
CanEditVehicleName	If true, players can rename their vehicle in the listing UI before posting

---

World Locations

These coordinates define where the rental hub, vehicle submission zone, garage, and display vehicles are placed in the world. You can adjust these to fit your server's map.

Config.Pedcoords = vector4(268.8051, -1155.2830, 29.2912, 92.0342)

The main NPC the player interacts with at the rental hub.

Config.listVehicle = {
    zone = {
        coords = vector3(315.0757, -1162.1981, 29.2919),
        radius = 4.0
    }
}

The zone where players drive up and submit their vehicle to be listed for rent.

Config.Garage = {
    zone = {
        coords = vector3(262.2166, -1162.7422, 29.1806),
        radius = 6.0
    },
    spawnVehicle = { ... }
}

The zone where renters interact to retrieve a rented vehicle. spawnVehicle defines the spots the vehicle can spawn at when collected.

Config.DisplayVehicles = { ... }

A list of vector4 coordinates where listed vehicles are physically spawned in the world for players to browse.

---

Blacklists

Specific Vehicles

Config.BlacklistedVehicles = {
    jubilee = true,
}

Add any vehicle spawn name here set to true to prevent it from being listed for rent.

Vehicle Classes

Config.BlacklistedClasses = {
    [15] = true, -- Helicopters
    [16] = true, -- Planes
    [14] = true, -- Boats
    [17] = true, -- Service
    [18] = true, -- Emergency
    [20] = true, -- Commercial
    [19] = true, -- Military
    [22] = true, -- Open Wheel
}

Entire vehicle classes can be blacklisted by their class ID. By default, aircraft, boats, service, emergency, military, and commercial vehicles are all restricted. For a full list of class IDs see the FiveM natives reference.

---

Blip

Config.Blip = {
    enabled = true,
    label = 'Vehicle Rentals',
    sprite = 523,
    color = 2,
    scale = 0.75,
    display = 4,
    shortRange = true,
}

Controls the map blip placed at the rental hub NPC location.

Option	Description
enabled	Show or hide the blip
label	Text shown when hovering over the blip
sprite	Blip icon ID
color	Blip color ID (2 = green)
scale	Size of the blip
shortRange	If true, only shows on the minimap when nearby

---

Markers

Config.Markers = {
    enabled = true,
    dist = 20.0,
    type = 0,
    scale = { x = 1.9, y = 1.9, z = 1.9 },
    color = { r = 35, g = 230, b = 18, a = 235 },
    zOffset = -2.15
}

Ground markers drawn at interaction zones to help guide players to the right spots.

Option	Description
enabled	Show or hide markers
dist	Distance at which markers start rendering
type	Marker shape ID
scale	Size of the marker on each axis
color	RGBA color of the marker
zOffset	Vertical offset to position the marker flush with the ground

---

Photo Bay

⚠️ This is a technical section. You rarely need to change anything here unless you know what you're doing.

Config.PhotoBay = {
    vehicleCoords = vector4(-83.2946, -819.8212, 227.3457, 343.2858),
    camSettings = { ... }
}

The photo bay is an off-screen location used to automatically render thumbnail images of listed vehicles. The camera settings control the angle, distance, and framing of the shot and are calculated dynamically based on each vehicle's bounding box.