> 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/common-errors.md).

# Common Errors

## ❌ The resource does not start / is not found

**Error message:** `Couldn't start resource MS_Madonne_CarSpawner` or similar.

**Possible causes:**

* The resource folder is not named exactly `MS_Madonne_CarSpawner`
* The `ensure MS_Madonne_CarSpawner` line is missing from your `server.cfg`
* The resource was placed in a sub-folder not scanned by FiveM

**Fix:** Verify the folder name matches exactly, check your `server.cfg`, then restart your server.

***

## ❌ CFX Portal entitlement error — resource refuses to start

**Error message:** `Couldn't load resource MS_Madonne_CarSpawner` or `Escrow: invalid entitlement`.

This error means the FiveM account linked to your server's license key does not have access to this resource.

Please verify the following:

* The CFX key in your `server.cfg` contains no typo
* The key belongs to the FiveM account used to purchase the resource
* The resource has been successfully purchased on our store
* The key belongs to you and not to your hosting provider

> ⚠️ Hosts offering shared CFX keys in their packages prevent the use of any resource protected by FiveM's Escrow system, without exception.

***

## ❌ Menu opens but no vehicles are displayed

**Possible causes:**

* `vehicles.lua` is empty or contains a syntax error
* The `category` field in a vehicle entry does not match any `name` in `categories.lua`
* The player's department doesn't match the restrictions set in the area's `departments` table

**Fix:** Check that category names match exactly between `vehicles.lua` and `categories.lua`. Enable `DEBUG = true` in `config.lua` to print loaded permission codes in the console.

***

## ❌ Vehicle delivery is stuck "en route"

The NPC was spawned but the vehicle never arrives and the status stays blocked.

**Fix:** Use the debug command (default `/debug`) to manually reset the delivery. If this happens frequently, check that:

* `ParkingSlotDectionRange` is not set too high
* No other resource is deleting NPC-driven vehicles before they arrive
* The NPC ped model defined in `Mechano_Ped` is valid and loadable

***

## ❌ Vehicle spawns far from the player / NPC delivery triggered unexpectedly

**Possible causes:**

* No parking slot was found within `ParkingSlotDectionRange`, so the NPC delivery fallback was triggered (expected behavior when `Ship_Vehicle_If_Zero_Slot_Available = true`)

**Fix:** If you want vehicles to always spawn nearby, add custom parking slots near your most-used areas in `parkings.lua`, or increase `ParkingSlotDectionRange` slightly.

***

## ❌ Players can access vehicles they should not

**Possible causes:**

* `whitelist = false` is set on a vehicle or category that should be restricted
* `permissionCode` does not exactly match the code returned by your permission system
* The `departments` table in the area config is set to `{}` instead of a specific list, allowing all departments

**Fix:** Review the `whitelist` and `permissionCode` values in `vehicles.lua` and `categories.lua`. Check `permissions.lua` to confirm the codes being assigned to players match what you expect.

***

## ❌ Notifications are not displayed

**Possible causes:**

* `Notifications_Type` is set to an unrecognized value — valid values are `"notification"`, `"chat"`, and `"other"`
* The `MS_Madonne_Notify` resource is not started before `MS_Madonne_CarSpawner` in `server.cfg`

**Fix:** Set `Notifications_Type = "notification"` to use native FiveM notifications, or ensure `MS_Madonne_Notify` is ensured first in your `server.cfg`.

***

## ❌ ESX jobs are not recognized as permission codes

**Possible causes:**

* `Framework` is still set to `"standalone"` in `config.lua`
* The `permissionCode` in categories or vehicles doesn't exactly match the ESX job name

**Fix:** Set `Framework = "esx"` in `config.lua`, then set `permissionCode` to the ESX job name (e.g. `"police"`). The ESX integration is handled automatically via `framework/esx.lua`.

***

## 💬 Need further help?

Join our support server on Discord: [discord.gg/madonne](https://discord.gg/madonne)