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

# Config

### Server Configuration

#### config/server/configServer.lua

```lua
ConfigServer = {
    TileLoadingThreads = 4, -- Number of threads used to load tiles faster
}
```

**Configuration Options**

| Option               | Type   | Default | Description                               |
| -------------------- | ------ | ------- | ----------------------------------------- |
| `TileLoadingThreads` | number | 4       | Number of threads for loading tile images |

**TileLoadingThreads Details:**

* **Recommended:** Set below your server's CPU thread count
* **Higher values:** Faster tile loading, but increased CPU usage
* **Lower values:** Slower loading, but less CPU impact
* **Range:** 1-8 (practical maximum)

**Performance Considerations**

**For Low-End Servers:**

```lua
ConfigServer = {
    TileLoadingThreads = 2, -- Reduced for lower CPU usage
}
```

**For High-End Servers:**

```lua
ConfigServer = {
    TileLoadingThreads = 6, -- Increased for faster loading
}
```

### Data Configuration

#### data/pedModels.lua

This file defines available character models for selection. **Note!**: If you change this, make sure to also change it in `fivem-greenscreener\client.lua` and regenerate all ped tiles.

```lua
PedModels = {
    [1] = "mp_m_freemode_01",  -- Default male
    [2] = "mp_f_freemode_01",  -- Default female
    [3] = "a_m_m_afriamer_01", -- Custom male model
    -- Add more models here...
}
```

**Adding New Models**

1. **Add to PedModels table:**

```lua
PedModels = {
    -- ... existing models
    [31] = "your_custom_model", -- New model
}
```

**Model Requirements**

* Models must be valid GTA V ped models
* Ensure models are available on client-side
* Test models in-game before adding to production

### Localization

#### locales/en.json

Default English translations for UI elements.

```json
{
    "errorWhileSaving": "Error while saving skin data",
    "keyhint_rotateCharacter": "Rotate Character",
    "keyhint_changeCameraHeight": "Change Camera Height",
    "keyhint_moveCamera": "Move Camera",
    "keyhint_zoomCamera": "Zoom Camera"
}
```

#### locales/pl.json

Polish translations (example of additional language).

**Adding New Languages**

1. **Create new locale file:** `locales/yourlang.json`
2. **Copy structure from en.json**
3. **Translate all strings**
4. **Configure ox\_lib to use new locale (defaults to en.json, if any key is missing)**

**Locale Structure**

```json
{
    "ui_element_key": "Translated text",
    "another_key": "Another translation",
    "keyhint_action": "Action description"
}
```