🖥️ Configurações do Client

Arquivo: config/client/config.lua Tudo que acontece no lado do jogador: teclas, comandos, a câmera da prova de roupa, a pose do personagem e a privacidade durante a prova.

Os pontos de loja e guarda-roupa não são configurados aqui. Eles são criados pelo painel administrativo dentro do jogo e ficam salvos no banco.

Visão geral

Opção	Padrão	O que faz
`debugMode`	`false`	Mostra o diagnóstico do client no console F8
`keybinds.openShop`	`"E"`	Abre o ponto em que o jogador está
`keybinds.toggleHands`	`"X"`	Alterna a animação de mãos com a interface aberta
`wardrobeCommand`	`"guardaroupa"`	Comando que abre o guarda-roupa em qualquer lugar
`copyClothesCommand`	`"lroupas"`	Comando que copia os comandos da roupa vestida
`devShop.enabled`	`true`	Libera a loja reduzida enquanto a licença não valida
`devShop.command`	`"skinshopdev"`	Comando dessa loja reduzida
`loadClothesOnSpawn.enabled`	`true`	Aplica a roupa salva quando o personagem carrega
`iconsFolder`	`nui://dk_skinshop/web/build/img`	Pasta dos ícones das categorias

Mudanças aqui só valem depois de reiniciar o recurso.

Teclas

keybinds = {
    openShop = "E",
    toggleHands = "X",
},

As duas são registradas via RegisterKeyMapping e o jogador pode remapeá-las em Configurações → Controles do FiveM.

O FiveM salva a tecla escolhida no perfil do jogador. Mudar o valor aqui afeta principalmente quem ainda não tem um bind salvo.

Os nomes válidos estão na referência de inputs do FiveM.

Comandos

wardrobeCommand = "guardaroupa",
copyClothesCommand = "lroupas",

Opção	O que abre
`wardrobeCommand`	O guarda-roupa na posição atual do jogador, sem depender de ponto no mapa
`copyClothesCommand`	Um painel com os comandos prontos das peças vestidas, para copiar (ex.: `jaqueta 1 4; maos 3 0;`)

Valor vazio ("") ou nil desativa o comando.

Modo de desenvolvimento

devShop = {
    enabled = true,
    command = "skinshopdev",
},

Enquanto a licença do recurso ainda não foi validada, a loja abre em uma versão reduzida: câmera e pose funcionam, o jogador troca peça e cor por setas e consegue salvar a roupa — mas não há fotos, compra, outfits nem guarda-roupa. Assim que a licença valida, a loja completa assume sozinha e o comando reduzido para de responder.

Valor	Comportamento
`enabled = true`	A loja abre em modo reduzido durante a espera
`enabled = false`	A loja simplesmente não abre até a autenticação terminar

Roupa no spawn

loadClothesOnSpawn = {
    enabled = true,
    events = {},
},

Aplica a roupa salva automaticamente quando o jogador entra no jogo. Funciona sem configuração extra — o script já escuta os eventos de login dos frameworks conhecidos:

"vRP:Active"                      -- vRP Creative Network
"vRP:playerActive"                -- vRP Creative V5
"esx:playerLoaded"                -- ESX
"QBCore:Client:OnPlayerLoaded"    -- QBCore / Qbox
"qbx_core:client:playerLoggedIn"  -- Qbox (variante nova)
"playerSpawned"                   -- Fallback universal do FiveM

Usa um sistema de spawn próprio? Adicione o nome do evento em events:

events = { "meuspawn:pronto" },

O script espera 500 ms antes de aplicar, dando tempo do framework terminar de montar o ped, e ignora chamadas repetidas dentro de 1,5 s — assim o jogador não é vestido duas vezes no mesmo login.

Pose

Deixa o personagem parado durante a prova, em vez de respirar e balançar.

pose = {
    enabled = true,
    dict = "anim@heists@heist_corona@team_idles@male_a",
    name = "idle",
    blendIn = 8.0,
    freeze = true,
    freezeTime = 0.0,
},

Campo	Descrição
`enabled`	`false` deixa o jogador na postura padrão
`dict` / `name`	Dicionário e nome da animação
`blendIn`	Velocidade de entrada na animação (`8.0` = imediato)
`freeze`	`true` trava a animação em um frame; `false` deixa em loop
`freezeTime`	Frame em que travar, de `0.0` a `1.0`

A animação de levantar as mãos (tecla toggleHands) substitui a pose enquanto está ativa, e a pose volta sozinha ao desativá-la.

Câmera

A câmera enquadra automaticamente a parte do corpo da categoria aberta.

Presets

Preset	Usado por
`head`	Chapéu, máscara, óculos e brinco
`chest`	Jaqueta, camiseta, colete, mochila, adesivos, mãos e acessórios
`legs`	Calças
`feet`	Sapatos
`left_wrist`	Relógio
`right_wrist`	Pulseira
`full`	Personagem inteiro

Cada preset aceita:

Campo	Descrição
`height`	Ajuste de altura em metros, somado à referência
`radius`	Distância da câmera até o personagem
`fov`	Campo de visão em graus. Menor = mais zoom
`bone`	Osso usado como referência de altura
`angleOffset`	Graus somados ao ângulo frontal, para orbitar lateralmente
`screenShift`	Desloca o ponto de mira, para o alvo não ficar atrás do painel

head = {
    height = 0.6,
    radius = 0.9,
    fov = 50.0,
    bone = "SKEL_Head",
},

O bone é o que faz a câmera acompanhar a pose real do personagem. Sem ele, a câmera usa a base do ped e desalinha em modelos mais altos ou mais baixos que o padrão.

Qual preset cada categoria usa

categories = {
    pants = "legs",
    shoes = "feet",
    hat = "head",
    watch = "left_wrist",
    bracelet = "right_wrist",
    torso = "chest",
    -- ...
},

Zoom e transição

minZoom = 0.5,
maxZoom = 5.0,
lerpSpeed = 8.0,

Campo	Descrição
`minZoom` / `maxZoom`	Limites do zoom pelo scroll do mouse
`lerpSpeed`	Velocidade da transição entre presets. Maior = troca mais rápida

Privacidade

Deixa os peds próximos invisíveis e sem colisão enquanto a interface está aberta, para ninguém atravessar na frente da câmera nem empurrar o personagem.

privacy = {
    enabled = true,
    radius = 15.0,
    hideVisibility = true,
    removeCollision = true,
    affectPlayers = true,
    affectNpcs = true,
    updateInterval = 500,
    byMode = {
        wardrobe = {
            affectPlayers = false,
        },
    },
},

Campo	Padrão	Descrição
`enabled`	`true`	Liga o recurso
`radius`	`15.0`	Raio, em metros, considerado “próximo”
`hideVisibility`	`true`	Torna os peds próximos invisíveis
`removeCollision`	`true`	Remove a colisão entre o jogador e esses peds
`affectPlayers`	`true`	Se outros jogadores são afetados
`affectNpcs`	`true`	Se NPCs são afetados
`updateInterval`	`500`	Intervalo da varredura, em ms
`byMode`	—	Sobrescritas por tipo de ponto

No guarda-roupa, affectPlayers vira false: os outros jogadores continuam visíveis, porque é para eles que o look é compartilhado. Os NPCs seguem escondidos.

Em byMode, só as chaves listadas mudam — o resto herda a configuração de cima. Os modos disponíveis são skinshop e wardrobe.

Hooks

O config/client/config.lua também traz os hooks de integração do client.

Hooks

Bloqueie a abertura, reaja a trocas de roupa e integre com outros scripts.

Informações Gerais

Scripts

Configurações do Client

🖥️ Configurações do Client

Visão geral

Teclas

Comandos

Modo de desenvolvimento

Roupa no spawn

Pose

Câmera

Presets

Qual preset cada categoria usa

Zoom e transição

Privacidade

Hooks

Hooks

​🖥️ Configurações do Client

​Visão geral

​Teclas

​Comandos

​Modo de desenvolvimento

​Roupa no spawn

​Pose

​Câmera

​Presets

​Qual preset cada categoria usa

​Zoom e transição

​Privacidade

​Hooks

Hooks

🖥️ Configurações do Client

Visão geral

Teclas

Comandos

Modo de desenvolvimento

Roupa no spawn

Pose

Câmera

Presets

Qual preset cada categoria usa

Zoom e transição

Privacidade

Hooks