> 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="https://1860794455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCvAynUdbw9243yqwmbdR%2Fuploads%2F4CKaptlltZm5IXJo55mx%2Fvlcsnap-2023-09-04-10h32m51s297.png?alt=media&amp;token=f69b9c0f-ba70-48d4-901e-a721757118b4" 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="https://1860794455-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FCvAynUdbw9243yqwmbdR%2Fuploads%2FAyrZjlqEZISfuBUrNiU4%2Fvlcsnap-2023-09-04-10h36m51s851.png?alt=media&amp;token=db6d7f39-d5f9-4b17-a2ee-26e8b13375ce" 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)