Config

This document covers all configuration options available in the 5s_skinmenu script.

Server Configuration

config/server/configServer.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:

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

For High-End Servers:

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.

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:

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.

{
    "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

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