Configuration

Page dedicated to how to configure our Skin Menu [V2]

Configuration Guide (config/config.lua & config/default_data.lua)

Targeting Integration The script detects third-eye targeting systems on its own — you normally do not have to touch this. If none is running, it falls back to proximity-based 'E' interactions.

Config.Target = {
    ox_target = GetResourceState('ox_target') == 'started' and true or false,
    qtarget   = GetResourceState('qtarget') == 'started' and true or false,
    qb_target = GetResourceState('qb-target') == 'started' and true or false,
    useE      = not (GetResourceState('ox_target') == 'started'
                  or GetResourceState('qtarget') == 'started'
                  or GetResourceState('qb-target') == 'started'),
}

Override a value only if you want to force one specific method. ox_target is the recommended one.

Shop Specialization Unlike older scripts where every clothing store allowed DNA changes, qf_skinmenu_v2 allows you to strictly segregate what players can modify based on the shop they interact with.

Config.ShopCategories = {
    ['clothing'] = { 'clothes', 'addons' }, -- Only apparel and props
    ['barber']   = { 'dna', 'face' },       -- Hair, makeup, and facial features
    ['tattoo']   = { 'tattoos' },           -- Exclusive to tattoo parlors
    ['surgeon']  = { 'dna', 'face' },       -- Plastic surgery (parents, structure)
    ['peds']     = { 'peds' },              -- Ped model switching
}

-- Which groups inside those pages a shop type may open.
Config.ShopGroups = {
    ['clothing'] = { 'top', 'bottom', 'props' },
    ['tattoo']   = { 'tattoos_torso', 'tattoos_head', 'tattoos_arms', 'tattoos_legs' },
    ['barber']   = { 'hair', 'makeup' },
    ['surgeon']  = { 'parents', 'features' }
}

Photo Studio Coordinates When a player creates a new character or takes a wardrobe photo, they are temporarily teleported to an isolated dimension. You must provide coordinates for a visually appealing, well-lit location. screenshot-basic is required for this feature.

Config.PhotoStudio = {
    coords = vector3(617.6306, 2766.3438, 42.0881),
    heading = 182.6283,
}

Interface & Language

Config.PrimaryColor = "#2F6AFE"
Config.Side = "left"                -- side of the menu: "left" or "right"
Config.Locale = "en"                -- en, de, es, fr, it, ja, ko, pl, pt
Config.DateFormat = "dd.MM.yyyy"
Config.RotateSides = false          -- flip the direction the ped rotates
Config.BlockNotifications = true    -- hide GTA notifications while the menu is open
Config.DisableIdleAnimations = true -- stop the ped fidgeting and the AFK camera
Config.OpenMenuOnFirstJoin = false  -- open the creator automatically for new players

Preview Images Thumbnails for clothes and props are loaded either from our CDN or from your own server.

Config.UseImages = true
Config.ImageSource = "remote" -- "local" or "remote"
Config.RemoteImagePath = "https://data.qfdevelopers.com/qf_skinmenu_v2/"

With "local" the images are served from the images/ folder inside the resource.

Outfits

Config.OutfitPrefix = "qf"   -- prefix of shared outfit codes, e.g. qf123
Config.Outfits = {
    MaxSavedOutfits = 20     -- per character
}

Tattoo Shop Integration If you already run a dedicated tattoo resource, hand the tattoo page over to it instead of using the built-in list. Enable exactly one of these.

Config.ScriptTattoos = {
    buildIn = true,          -- use the tattoos defined in config/tattoos.lua
    rcore_tattoos = false,
    vms_tattooshop = false,
}

Peds & Permissions

Config.AdminGroup = "admin"   -- group seeded as admin for the panel on first start
Config.PedPermission = false  -- Ace permission or framework group required for the Peds page
Config.AllowedPeds = {}       -- managed in the admin panel, seeded from DefaultData.AllowedPeds

Shop Interaction

Config.ShopInteractionDelay = 5000    -- ms before the interaction can be used
Config.ShopInteractionCooldown = 5000 -- ms between two interactions

Config.ShopBlips = {
    ['clothing'] = { sprite = 73,  color = 47, scale = 0.7, label = "Clothing Store",  targetIcon = "fas fa-shirt" },
    ['barber']   = { sprite = 71,  color = 0,  scale = 0.7, label = "Barber Shop",     targetIcon = "fas fa-scissors" },
    ['tattoo']   = { sprite = 75,  color = 0,  scale = 0.7, label = "Tattoo Salon",    targetIcon = "fas fa-pen-nib" },
    ['surgeon']  = { sprite = 102, color = 0,  scale = 0.7, label = "Plastic Surgeon", targetIcon = "fas fa-user-md" }
}

---

Shops, Prices & Commands

Config.Shops, Config.Prices, Config.Commands and Config.AllowedPeds are intentionally left empty in config.lua — they live in the database and are edited in game through /skinadmin. Their initial contents come from config/default_data.lua.

DefaultData.Prices = {
    ['clothing'] = 500,
    ['barber']   = 200,
    ['tattoo']   = 300,
    ['surgeon']  = 5000
}

DefaultData.Commands = {
    ['skinmenu']  = { name = 'skinmenu',  permission = false },
    ['outfits']   = { name = 'outfits',   permission = false },
    ['skinreset'] = { name = 'skinreset', permission = false },
    ['skingive']  = { name = 'skingive',  permission = "admin" },
    ['skinpeds']  = { name = 'skinpeds',  permission = "admin" },
}

DefaultData.Shops = {
    {
        type = 'clothing',                            -- clothing, barber, tattoo or surgeon
        coords = vec3(73.8728, -1392.0785, 29.3761),
        heading = 278.8409,
        range = 3.0,
        model = 'a_m_y_epsilon_01',                   -- ped standing at the shop
        label = "Clothing Store",
        jobs = { 'police' }                           -- optional, restricts the shop to jobs
    },
}

default_data.lua is only imported into an empty database. On the first start the shops, prices and commands are copied into the qf_skinmenu_locations and qf_skinmenu_settings tables, and from then on the database wins — later edits to the file do nothing.

Use /skinadmin to change them afterwards, or empty the corresponding table if you want the file to be imported again.