🤖 Configuration

⌨️ Key Mapping

Config.KeyMapping = 'K'

This determines which key opens/closes the clothing menu.

Option	Description
KeyMapping	The keyboard key used to toggle the clothing menu UI.

🎥 Camera Settings

Config.Camera = {
    distance = 3.6,
    zOffset  = 0.75
}

Setting	Description
distance	How far the camera sits from the player.
zOffset	Vertical offset (camera height above the player).

These values adjust the UI preview camera when the menu is open.

🌐 Locales (Translations)

Config.Locales = {
    menu_toggle_label = "Open/Close Clothing Menu",
    close_hint        = "Press %s or X to close",
    error_title       = "Clothing",
    not_wearing       = "You are not wearing this item.",

    -- Individual clothing items
    toggle_mask       = "Toggle Mask",
    toggle_gloves     = "Toggle Gloves",
    toggle_pants      = "Toggle Pants",
    toggle_shoes      = "Toggle Shoes",
    toggle_accessory  = "Toggle Accessory",
    toggle_undershirt = "Toggle Undershirt",
    toggle_armor      = "Toggle Armor",
    toggle_top        = "Toggle Top",
    toggle_hat        = "Toggle Hat",
    toggle_glasses    = "Toggle Glasses",
    toggle_ears       = "Toggle Ears",
    toggle_watch      = "Toggle Watch",
    toggle_bracelet   = "Toggle Bracelet",

    -- Item groups
    group_headwear    = "Headwear",
    group_torso       = "Torso",
    group_handwear    = "Handwear",

    -- Fallbacks (do not remove)
    toggle_component  = "Toggle Clothing",
    toggle_prop       = "Toggle Accessory",
    group_generic     = "Options",
}

All user-facing text is fully editable for translation/localization.

🎨 Icons

Defines the FontAwesome icons displayed for each clothing slot.

Component Icons

Config.Icons = {
    Components = {
        [1]  = "fa-mask-face",
        [3]  = "fa-hand",
        [4]  = "fa-person-walking",
        [6]  = "fa-shoe-prints",
        [7]  = "fa-gem",
        [8]  = "fa-shirt",
        [9]  = "fa-shield-halved",
        [11] = "fa-vest-patches",
    },

Prop Icons

    Props = {
        [0] = "fa-hat-cowboy-side",
        [1] = "fa-glasses",
        [2] = "fa-headphones",
        [6] = "fa-clock",
        [7] = "fa-arrows-spin",
    }
}

These match GTA clothing component/prop IDs.

👕 Default Component Values (When Removing Clothing)

Defines the drawable IDs applied when the user removes a clothing item.

Male Defaults

Config.Drawables = {
    male = {
        [1]  = 0,
        [3]  = 15,
        [4]  = 14,
        [6]  = 34,
        [7]  = 0,
        [8]  = 15,
        [9]  = 0,
        [11] = 15,
    },

Female Defaults

    female = {
        [1]  = 0,
        [3]  = 15,
        [4]  = 15,
        [6]  = 35,
        [7]  = 0,
        [8]  = 15,
        [9]  = 0,
        [11] = 15,
    }
}

These control fallback clothing to prevent players turning invisible.

💍 Default Prop Values (When Removing Accessories)

Defines what prop index to apply when accessories are toggled off.

Male Props

Config.Props = {
    male = {
        [0] = -1,
        [1] = -1,
        [2] = -1,
        [6] = -1,
        [7] = -1,
    },

Female Props

    female = {
        [0] = -1,
        [1] = -1,
        [2] = -1,
        [6] = -1,
        [7] = -1,
    }
}

-1 means the prop is completely removed (no accessory equipped).