LV Persistent Vehicles Lite

Introduction

LV Persistent Vehicles Lite is the official LV Scripts resource for servers that need real vehicle persistence without heavy external dependencies. Every purchased or spawned vehicle is stored in the database with position, damage, fuel, colors and lock state.

Unlike basic solutions, this script never deletes abandoned vehicles, restores the world after server or resource restarts, and optimizes performance with OneSync-compatible distance streaming.

Features

Requirements

Installation

1. Copy the resource into your resources/ folder:

   resources/lv-persistent-vehicles-lite/

2. Database — run the SQL (also auto-installs on start):

   lv-persistent-vehicles-lite/sql/install.sql

3. server.cfg — recommended order:

   set mysql_connection_string "mysql://user:pass@localhost/dbname?charset=utf8mb4"
   ensure oxmysql
   ensure lv-persistent-vehicles-lite

4. Configure config.lua with your license, framework and garage/dealership locations.
5. Restart the server and check the console for successful license verification.

License

The license is generated in your LV Scripts panel after purchase. It must be bound to your FiveM server public IP.

Config.License = {
    Key = 'LV-XXXX-XXXX-XXXX',
    ApiBase = 'https://lvscripts.net',
    RecheckInterval = 300000,
}

Enable Config.General.Debug = true temporarily to see the verification URL and API response in the server console.

Script strings (notifications, UI) are edited in locale.lua (plaintext file). Language: Config.UI.Locale = 'es' or 'en'.

Configuration

Persistence

Config.Persistence = {
    SaveInterval = 60,
    SaveOnExitVehicle = true,
    SaveOnPlayerDrop = true,
    SaveOnResourceStop = true,
    FullVehicleState = true,
    DeleteAbandoned = false,
    SpawnOnStart = true,
    UseRoutingBuckets = true,
}

Streaming (OneSync)

Config.Streaming = {
    Enabled = true,
    SpawnRadius = 350.0,
    DespawnRadius = 450.0,
    TickMs = 2500,
}

Dealership

Default location: PDM Legion Square. Customize in Config.Dealership:

• Entrance — player entry point
• Showroom — vehicle, camera and player preview position
• TestDrive — duration, spawn and return point
• PaymentAccount — 'bank' or 'cash' (ESX/QBCore)
• UseAllGtaVehicles — full GTA catalog or filtered list

Garages

Define garages in config/garages.lua. Each garage includes menu coords, store zones, spawn points and blips.

Keys

Config.Keys = {
    LockToggle = 'U',
    Interact = 38,
}

Dealership catalog

Edit config/gta_vehicles.lua or use Config.VehicleOverrides / Config.VehicleBlacklist.

Frameworks

Config.Framework = {
    Type = 'auto',
    AutoDetect = true,
}

With auto, detection order is: QBCore → ESX → Standalone.

In-game usage

After restart

• Vehicles outside garage respawn at their last saved position.
• Vehicles in garage (stored = 1) stay in DB without a world entity.
• When the resource stops, entities are removed but data persists in MySQL.

Commands

Exports (server)

Integrate with other resources using server exports:

local data = exports['lv-persistent-vehicles-lite']:GetVehicleData(vehicleId)
local vehicle = exports['lv-persistent-vehicles-lite']:GetVehicleByPlate('ABC 123')

Returned data includes owner, model, position, garage state, fuel, damage and JSON properties.

Database

The SQL installer creates indexes on owner and plate for fast queries with many vehicles.

Troubleshooting

Script won't start / invalid license

• Ensure the server public IP matches the license at lvscripts.net.
• Check Config.License.Key has no extra spaces or quotes.
• Enable Config.General.Debug = true and review the server console.

Vehicles don't persist

• Confirm oxmysql is connected (ensure oxmysql before the resource).
• Check that lv_pv_vehicles tables exist in your DB.
• Verify Config.Persistence.SpawnOnStart = true.

Dealership or garage not showing

• License must be active (without it all gameplay is disabled).
• Review coords in Config.Dealership and config/garages.lua.
• Check Config.Blips.Enabled and Config.WorldMarkers.Enabled.

Performance with many vehicles

• Adjust SpawnRadius / DespawnRadius for your population and hardware.
• Increase SaveInterval if you have thousands of active vehicles.
• Use garages often to keep vehicles at stored = 1.