# Configuration

> Configuration reference for ML Shops

Category: SHOPS SYSTEM · Source: https://miciomods.it/docs/ml-shops-configuration · Last updated: 2026-07-05

## Overview

Configuration is split into two files:

- `shared/config.lua`: General settings, admin, blips, NPC spawn distance
- `server/config_server.lua`: Logger backend, Discord webhook URLs

Shops, traders, items, categories, stock, and NPC positions are all managed through the **admin panel** and stored in the database.

## General

**shared/config.lua**

```lua
Config.Settings = {
    Locale = 'en',
    Debug = false,
    Theme = 'classic',
    MainColor = '#D9794D',
    InventoryImagePath = 'nui://ox_inventory/web/images/',
    ImageExtension = '.png',
}
```

- `Theme`: UI theme
- `MainColor`: Primary accent color for the shop UI
- `InventoryImagePath`: Path to item images (defaults to ox_inventory)

## Admin

**shared/config.lua**

```lua
Config.Settings.AdminCommand = 'shopadmin'
Config.Settings.AdminPermission = 'admin'
Config.Settings.AdminJob = 'admin'
Config.Settings.EnableAdminCheck = true
Config.Settings.AdminCheckDistance = 5.0
```

- `AdminCommand`: Chat command to open the admin panel
- `AdminPermission`: Required permission group
- `AdminJob`: Alternative job-based access
- `AdminCheckDistance`: Max distance for admin interactions with traders

## NPC & Interaction

**shared/config.lua**

```lua
Config.Settings.PedSpawnDistance = 100.0
Config.Settings.EnableTarget = true
```

- `PedSpawnDistance`: Distance at which trader NPCs spawn/despawn
- `EnableTarget`: Enable target interactions on NPCs

## Blips

**shared/config.lua**

```lua
Config.Settings.EnableBlips = true
```

Blip sprite, color, and label are configured per-shop through the admin panel. Available blip colors are listed in `Config.BlipColors`.

## Logger Backend

**server/config_server.lua**

```lua
Config.Logger = 'discord'
```

- `'discord'`: Uses Discord webhook URLs
- `'ox_lib'`: Routes logs to DataDog, FiveManage, or Loki based on your ox_lib config

## Discord Webhooks

**server/config_server.lua**

```lua
Config.DiscordWebhook = {
    StaffActions     = 'INSERT_WEBHOOK_LINK_HERE',
    PlayerActions    = 'INSERT_WEBHOOK_LINK_HERE',
    Purchases        = 'INSERT_WEBHOOK_LINK_HERE',
    TraderManagement = 'INSERT_WEBHOOK_LINK_HERE',
    ItemManagement   = 'INSERT_WEBHOOK_LINK_HERE',
    StockChanges     = 'INSERT_WEBHOOK_LINK_HERE',
    CategoryChanges  = 'INSERT_WEBHOOK_LINK_HERE',
    ExploitDetected  = 'INSERT_WEBHOOK_LINK_HERE',
}
```

Replace each placeholder with a Discord webhook URL. Set to `false` to disable that log entirely.