> 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/configuration-overview.md).

# Configuration Overview

DZ Customs is configured from:

```
dz_customs/shared/config.lua
```

The config is split into sections so you can quickly control how the resource behaves.

***

### Main Config Sections

```lua
Config.Debug
Config.ResourceName
Config.ScriptName
Config.Language
Config.NotifyPosition

Config.Interaction
Config.RequireDriver
Config.FreezeVehicleInShop
Config.RepairVehicleOnOpen

Config.AdminCommand
Config.AdminGroups

Config.UI
Config.DefaultCategories

Config.PaymentMethods
Config.DefaultPaymentMethod
Config.Currency
Config.JobPricing
Config.SocietyPayment

Config.Persistence
Config.Paint
Config.Preview
Config.Camera

Config.Blips
Config.Markers
Config.Shops
Config.Logging
```

***

### Core Settings

```lua
Config.Debug = false
```

Enables extra console debug prints.

Recommended for live servers:

```lua
Config.Debug = false
```

Recommended while setting up or debugging:

```lua
Config.Debug = true
```

***

```lua
Config.ResourceName = 'dz_customs'
```

This should match the resource folder name.

Only change this if you rename the resource folder.

***

```lua
Config.ScriptName = 'DZ Customs'
```

This is used in notifications and UI labels.

***

```lua
Config.Language = 'en'
```

Sets the active locale.

Available examples:

```lua
Config.Language = 'en'
Config.Language = 'de'
Config.Language = 'fr'
Config.Language = 'es'
Config.Language = 'tr'
```

Make sure the matching locale file exists in:

```
locales/
```

***

```lua
Config.NotifyPosition = 'top'
```

Sets the ox\_lib notification position.

Common options:

```lua
'top'
'top-right'
'top-left'
'bottom'
'bottom-right'
'bottom-left'
'center-right'
'center-left'
```

***

### Interaction Settings

```lua
Config.Interaction = 'textui'
```

Controls how players interact with customs shops.

Valid options:

```lua
'textui'
'target'
```

Use TextUI / zone interaction:

```lua
Config.Interaction = 'textui'
```

Use ox\_target interaction:

```lua
Config.Interaction = 'target'
```

`target` mode requires `ox_target`.

***

```lua
Config.RequireDriver = true
```

If enabled, only the driver of the vehicle can open the customs UI.

Recommended:

```lua
Config.RequireDriver = true
```

***

```lua
Config.FreezeVehicleInShop = true
```

Freezes the vehicle while the player is using the customs menu.

Recommended:

```lua
Config.FreezeVehicleInShop = true
```

***

```lua
Config.RepairVehicleOnOpen = false
```

Repairs the vehicle when the customs menu opens.

Recommended:

```lua
Config.RepairVehicleOnOpen = false
```

Leaving this disabled prevents customs shops being used as a free repair exploit.

***

### Admin Settings

```lua
Config.AdminCommand = 'customs'
```

Admin command name.

Example command:

```
/customs
```

***

```lua
Config.AdminGroups = {
    admin = true,
    superadmin = true
}
```

Groups allowed to use the admin command.

Add more groups if needed:

```lua
Config.AdminGroups = {
    admin = true,
    superadmin = true,
    owner = true,
    management = true
}
```

***

### UI Settings

```lua
Config.UI = {
    accentColour = '#7c3aed',
    showPrices = true,
    showBasket = true,
    enableSounds = true,
    enableAnimations = true
}
```

#### accentColour

Main UI accent colour.

Example:

```lua
accentColour = '#7c3aed'
```

#### showPrices

Shows prices in the NUI.

```lua
showPrices = true
```

#### showBasket

Shows the basket panel.

```lua
showBasket = true
```

#### enableSounds

Reserved for UI sound effects if implemented.

```lua
enableSounds = true
```

#### enableAnimations

Reserved for UI animations if implemented.

```lua
enableAnimations = true
```

***

### Currency

```lua
Config.Currency = '£'
```

Currency symbol shown in the NUI, notifications, and logs.

Examples:

```lua
Config.Currency = '$'
Config.Currency = '€'
Config.Currency = '£'
```

This only changes display text. It does not change the economy/account logic.