> For the complete documentation index, see [llms.txt](https://nodemods.gitbook.io/nodemods-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://nodemods.gitbook.io/nodemods-docs/ls-customs.md).

# LS Customs

Welcome to the LS Customs documentation! This resource brings a full Los Santos Customs vehicle upgrade experience to your server, with persistent, framework-agnostic customization and a suite of performance and security add-ons.

## Overview

LS Customs is built around one core idea: everything a player buys or installs is saved server-side and restored automatically, across every supported framework.

* Full LS Customs-style mod shop (paint, wheels, liveries, tuning) with persistent selections
* Nitro system with canisters, tiered refills, purge, and an Unlimited Nitro overlay
* Anti-Lag exhaust pops synced across all clients
* Config-driven Advanced Systems catalog (Rocket Boost, Jump, Parachute, and custom owner-defined entries)
* Vehicle security suite: Remote Locator, Remote Dashcam, and Biometric Lock with an authorized-user list
* Test Drive mode with a configurable time limit and return reminders
* Persistent vehicle tunings and placeable objects
* Works with QBCore, QBox, ESX, and Standalone out of the box, with vRP/vRPv2 adapter templates

## Key Features

* **Persistent Everything**: Mods, tunings, and placed objects are stored in the database and reapplied automatically, surviving resource restarts.
* **Multi-Framework Support**: QBCore, QBox, and ESX are fully supported, including the security suite's persistent-ownership requirement. Standalone and the vRP/vRPv2 templates cover the rest of the customization flow.
* **Config-Driven Advanced Systems**: Add your own purchasable vehicle flag or handling-override entries without touching any code, in `config/config_advanced_systems.lua`.
* **Vehicle Security Suite**: Owners can locate, watch through a dashcam, and biometric-lock their vehicle to a list of authorized drivers.
* **Nitro & Anti-Lag**: A full nitro economy (canisters, refill tiers, purge) alongside synced anti-lag exhaust effects, sharing the same underlying exhaust system for consistent visuals.
* **Test Drive Mode**: Lets players try a build before buying, with a time limit, early-return reminders, and isolated vehicle buckets so test drives never interfere with other players.

## Documentation Sections

* [Configuration Guide](/nodemods-docs/ls-customs/config.md)
* [Framework Setup Guide](/nodemods-docs/ls-customs/framework-setup.md)
* [Troubleshooting Guide](/nodemods-docs/ls-customs/troubleshooting.md)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://nodemods.gitbook.io/nodemods-docs/ls-customs.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
