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

# Duddzy Customs

Version 1.0.0

DZ Customs is an advanced ESX vehicle customisation system for FiveM. It allows players to visit configured custom shop locations, preview vehicle modifications live, add selected upgrades to a basket, and checkout using supported payment methods.

The resource is designed to be clean, optimised, easy to configure, and suitable for public server use.

***

### Key Features

* Custom NUI built with HTML, CSS, and JavaScript
* ESX framework support
* ox\_lib interaction support
* Optional ox\_target interaction support
* Configurable custom shop locations
* Configurable shop blips and markers
* Live vehicle modification preview
* Smooth vehicle preview camera
* Mouse camera controls
* Basket checkout system
* Cash, bank, and optional society payments
* Job discounts
* Free customisations for configured jobs
* Server-side trusted price validation
* Owned vehicle persistence
* Discord webhook logging
* Configurable currency symbol
* Optional chameleon paint support
* Admin command support
* Client exports for external integrations

***

### Requirements

DZ Customs requires the following resources:

```
es_extended
ox_lib
oxmysql
```

Optional resources:

```
ox_target
esx_society / esx_addonaccount
dz_chameleonpaints
```

`ox_target` is only required if you use target interaction mode.

`esx_society` or an equivalent society account system is only required if you enable society payments.

`dz_chameleonpaints` is only required if you want chameleon paint support.

***

### Resource Names

Main resource:

```
dz_customs
```

Optional paint resource:

```
dz_chameleonpaints
```

Make sure your folder names match the resource names used in your config and `server.cfg`.

***

### Support Notes

When requesting support, please provide:

* Your `shared/config.lua`
* Any server console errors
* Any client F8 errors
* Your ESX version
* Your interaction mode
* Whether society payments are enabled
* Whether chameleon paints are enabled
* Your owned vehicle database structure if persistence is not working