> For the complete documentation index, see [llms.txt](https://documentation.madonnestudio.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.madonnestudio.com/paid-scripts/madonne-car-spawner.md).

# Madonne Car Spawner

Spawn your vehicles the right way! **Madonne Car Spawner** gives your players an intuitive and fully configurable vehicle spawning interface, with realistic NPC delivery, parking slot detection, department restrictions, and permission-based limits.

{% embed url="<https://www.youtube.com/watch?v=SFFCjfyGqb8>" %}

***

## 📖 About Madonne Car Spawner

Madonne Car Spawner allows players to browse and spawn their vehicles through a clean NUI interface — **without relying on ESX, QBCore, or any other framework**. Vehicles are delivered to one of the **11,000+ pre-listed parking slots** present in the game. If no slot is available nearby, a configurable **NPC mechanic** will drive the vehicle directly to the player.

Server owners can define **spawn areas** with markers and NPCs, restrict vehicles by **department**, configure **per-player vehicle limits** with VIP tier overrides, and fully customize categories, vehicle lists, and parking zones. A **badge system** allows locked vehicles to remain visible in the interface with a visual indicator.

<figure><img src="/files/6UnlHE4BvapgFPmCPA4b" alt=""><figcaption></figcaption></figure>

***

## ✨ Main Features

* 🖥️ **Intuitive NUI Interface** — Players browse vehicles by category with photos, names, and livery previews
* 🅿️ **Smart Parking Detection** — Vehicles spawn on the nearest available slot out of 11,000+ pre-listed locations
* 🚶 **NPC Delivery System** — If no slot is found nearby, a configurable NPC mechanic brings the vehicle to the player
* 📍 **Spawn Areas** — Restrict menu access to defined map zones, with optional markers and NPC attendants
* 🏢 **Department Restrictions** — Each area can be limited to specific departments (LSPD, LSSD, SAFR…)
* 🔒 **Vehicle & Category Whitelisting** — Vehicles and categories can be locked behind a permission code
* 🏅 **Badge System** — Locked vehicles can remain visible in the interface with a custom badge (icon, color, label)
* 🚗 **Vehicle Limit per Player** — Configurable default limit with VIP-tier overrides
* 🎨 **Livery, Extras & Colors** — Define livery index, extras to enable/disable, and primary/secondary colors per vehicle
* ⚙️ **Framework Support** — Works standalone or with **ESX** (job-based permissions via `Framework = "esx"`)
* 🌍 **Full Translation Support** — All in-game strings are editable in a dedicated `TRANSLATIONS` table

<figure><img src="/files/qEzu3GBrjfz01CofPtJr" alt=""><figcaption></figcaption></figure>

***

## 🔗 Quick Links

* [📥 Installation](/paid-scripts/madonne-car-spawner/installation.md)
* [⚙️ Configuration](/paid-scripts/madonne-car-spawner/configuration.md)
* [❓ Common Errors](/paid-scripts/madonne-car-spawner/common-errors.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:

```
GET https://documentation.madonnestudio.com/paid-scripts/madonne-car-spawner.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.