🔌 Exports

Os exports permitem integrar o dk_skinshop com o resto do servidor: abrir uma loja a partir de um NPC, de um item ou de um menu próprio, checar se o jogador comprou uma peça, aplicar um uniforme por script.

O arquivo types.lua do recurso descreve todos os exports para o Lua LSP. Ele não é carregado em runtime — serve só para o seu editor sugerir e validar as assinaturas enquanto você escreve a integração.

Formatos usados

ClotheData — mapa por categoria

Usado por todos os exports de roupa.

{
    torso = { drawable = 4, texture = 0 },
    pants = { drawable = 10, texture = 0 },
}

pieces — lista de peças

Usado pelos hooks de outfit.

{
    { categoryId = "torso", drawable = 4, texture = 0 },
    { categoryId = "pants", drawable = 10, texture = 0 },
}

BlipConfig — um ponto no mapa

Campo	Tipo e uso
`id`	Número do ponto persistido. Opcional
`mode`	`"skinshop"` ou `"wardrobe"`
`label`	Nome do ponto. Vazio esconde o ícone, mantendo o ponto utilizável
`coords`	`vector4` com posição e direção
`radius`	Raio de interação, em metros
`permission`	`"all"`, `"vip"`, `"admin"` ou `"group"`
`disabledCategories`	Categorias bloqueadas na loja. Opcional
`disabledFeatures`	Recursos bloqueados no guarda-roupa. Opcional
`maxOutfitSlots`	Limite de outfits do ponto. Opcional
`leaderLabels` / `memberLabels`	Listas de permissões para pontos de grupo

Client

Export	Assinatura	Retorno
`toggle`	`toggle(config: BlipConfig, open?: boolean)`	—
`openShop`	`openShop(overrides?: BlipConfig)`	—
`openWardrobe`	`openWardrobe(overrides?: BlipConfig)`	—
`openBlip`	`openBlip(blipId: number)`	`boolean`
`closeShop`	`closeShop()`	—
`isShopOpen`	`isShopOpen()`	`boolean`
`wearClothes`	`wearClothes(clothes: ClotheData, ped?: number)`	—
`loadSavedClothes`	`loadSavedClothes()`	`boolean`
`getEquippedClothes`	`getEquippedClothes()`	`ClotheData`

toggle

Abre ou fecha um ponto a partir do config dele.true força abrir, false força fechar, nil alterna.

openShop / openWardrobe

Abrem a loja ou o guarda-roupa na posição atual do jogador, sem exigir um ponto cadastrado.O overrides sobrescreve campos do ponto gerado — label, permission, radius, disabledCategories, disabledFeatures.

openBlip

Abre um ponto já cadastrado pelo id, de qualquer lugar do mapa, sem exigir proximidade.Retorna false quando o id não existe localmente.

closeShop

Fecha a interface e reverte a prova de roupa ao estado anterior — o mesmo que o botão cancelar.Útil para interromper a prova de fora do script: combate, prisão, cutscene de outro recurso.

wearClothes

Veste um conjunto de roupas no ped. Apenas visual: não persiste.Sem o segundo argumento, usa o ped do jogador local.

loadSavedClothes

Busca a roupa salva do jogador no banco e a veste. Retorna false quando não há roupa salva.

getEquippedClothes

Devolve a roupa vestida no momento, lida direto dos componentes e props do ped — não depende de consultar o servidor.

Server

Export	Assinatura	Retorno
`fetchPlayerClothes`	`fetchPlayerClothes(source: number)`	—
`getPlayerClothes`	`getPlayerClothes(source: number)`	`ClotheData` ou `nil`
`setPlayerClothes`	`setPlayerClothes(source: number, clothes: ClotheData)`	`boolean`
`getPlayerPurchases`	`getPlayerPurchases(source: number)`	`table<categoria, drawables[]>`
`hasPurchased`	`hasPurchased(source: number, categoryId: string, drawable: number)`	`boolean`
`getPlayerOutfits`	`getPlayerOutfits(source: number)`	Tabela indexada pelo slot
`isVip`	`isVip(source: number)`	`boolean`
`isAdmin`	`isAdmin(source: number)`	`boolean`
`getBlips`	`getBlips()`	Lista de `BlipConfig`

fetchPlayerClothes

Busca a roupa salva do jogador e manda o client dele vestir.

setPlayerClothes

Sobrescreve a roupa salva e aplica no client. Retorna true quando a gravação dá certo.

getPlayerPurchases / hasPurchased

Consultam o histórico de compras do jogador. O hasPurchased responde por categoria e variação — a textura não entra na conta.

isVip / isAdmin

Usam a mesma checagem do script, pela bridge do dk_snippets. Lembre que admins sempre contam como VIP.

Exemplos

Abrir uma loja bloqueando categorias

exports.dk_skinshop:openShop({
    permission = "all",
    disabledCategories = { "mask", "hat" },
})

Fechar a prova quando outra interface precisar do foco

if exports.dk_skinshop:isShopOpen() then
    exports.dk_skinshop:closeShop()
end

Conferir se o jogador já comprou uma variação

local ownsTorso = exports.dk_skinshop:hasPurchased(source, "torso", 4)

Aplicar um uniforme por script

exports.dk_skinshop:setPlayerClothes(source, {
    torso = { drawable = 55, texture = 0 },
    pants = { drawable = 31, texture = 0 },
    shoes = { drawable = 25, texture = 0 },
})

Guardar o look atual antes de trocar

local previous = exports.dk_skinshop:getEquippedClothes()

exports.dk_skinshop:wearClothes({
    torso = { drawable = 55, texture = 0 },
})

-- Mais tarde, devolver a roupa anterior:
exports.dk_skinshop:wearClothes(previous)

Hooks

Reaja a compras, outfits, compartilhamentos e criação de pontos.

Informações Gerais

Scripts

Exports

🔌 Exports

Formatos usados

ClotheData — mapa por categoria

pieces — lista de peças

BlipConfig — um ponto no mapa

Client

Server

Exemplos

Abrir uma loja bloqueando categorias

Fechar a prova quando outra interface precisar do foco

Conferir se o jogador já comprou uma variação

Aplicar um uniforme por script

Guardar o look atual antes de trocar

Hooks

​🔌 Exports

​Formatos usados

​ClotheData — mapa por categoria

​pieces — lista de peças

​BlipConfig — um ponto no mapa

​Client

​Server

​Exemplos

​Abrir uma loja bloqueando categorias

​Fechar a prova quando outra interface precisar do foco

​Conferir se o jogador já comprou uma variação

​Aplicar um uniforme por script

​Guardar o look atual antes de trocar

Hooks

🔌 Exports

Formatos usados

ClotheData — mapa por categoria

pieces — lista de peças

BlipConfig — um ponto no mapa

Client

Server

Exemplos

Abrir uma loja bloqueando categorias

Fechar a prova quando outra interface precisar do foco

Conferir se o jogador já comprou uma variação

Aplicar um uniforme por script

Guardar o look atual antes de trocar