📸 Fotos das Roupas

As fotos reais são o que transforma o guarda-roupa em uma coleção visual, em vez de uma lista de números. Esta página explica como ativá-las.

As fotos não vêm dentro do recurso. Elas precisam ser servidas por HTTP — um Apache, um nginx ou um CDN apontando para a pasta das imagens. O protocolo nui:// não funciona aqui.

Sem fotos configuradas, a interface continua funcionando normalmente e usa o ícone da categoria no lugar da imagem. Nada quebra.

Gerando as fotos

A DK publica gratuitamente o dk_autophoto, que fotografa cada peça de cada categoria e já salva os arquivos no formato esperado pelo skinshop.

Rode o dk_autophoto

Ele percorre as variações e gera as imagens.

Hospede a pasta gerada

Aponte um servidor HTTP (Apache, nginx, CDN) para ela.

Ajuste o baseUrl

Coloque o endereço público em itemImages.baseUrl.

Configuração

Arquivo: config/shared/config.lua

itemImages = {
    enabled = true,
    baseUrl = "http://localhost/clothes",
    pathTemplate = "{model}/{category}/{drawable}_{texture}.{ext}",
    ext = "webp",
    categoryMap = {},
    knownModels = {
        [GetHashKey("mp_m_freemode_01")] = "mp_m_freemode_01",
        [GetHashKey("mp_f_freemode_01")] = "mp_f_freemode_01",
    },
},

Opção	Padrão	Função
`enabled`	`true`	Liga o uso de fotos reais
`baseUrl`	`"http://localhost/clothes"`	Endereço HTTP base, sem barra no final
`pathTemplate`	veja abaixo	Monta o caminho de cada imagem
`ext`	`"webp"`	Extensão dos arquivos
`categoryMap`	`{}`	Traduz o id da categoria para outro nome de pasta
`knownModels`	2 modelos freemode	Liga o hash do ped ao nome usado no caminho

O padrão http://localhost/clothes só funciona se esse endereço realmente servir as imagens. Na maioria dos servidores ele precisa ser trocado.

O template de caminho

pathTemplate = "{model}/{category}/{drawable}_{texture}.{ext}"

As substituições disponíveis:

Marcador	Vira
`{model}`	Nome do modelo de ped (ex.: `mp_m_freemode_01`)
`{category}`	Id da categoria (ex.: `torso`)
`{drawable}`	Número da variação
`{texture}`	Número da textura
`{ext}`	A extensão definida em `ext`

Com o template padrão, a jaqueta 4 na textura 0 de um personagem masculino é buscada em:

http://localhost/clothes/mp_m_freemode_01/torso/4_0.webp

Se as suas fotos já estão organizadas de outro jeito, ajuste o template em vez de renomear os arquivos. Ele aceita qualquer combinação dos marcadores acima.

Nomes de pasta diferentes

Quando o id da categoria e o nome da pasta não batem, use o categoryMap:

categoryMap = {
    tshirt = "shirt",
    torso = "jacket",
},

Categoria fora dessa lista usa o mesmo id nos dois lados.

Peds addon

O {model} do caminho sai do knownModels:

knownModels = {
    [GetHashKey("mp_m_freemode_01")] = "mp_m_freemode_01",
    [GetHashKey("mp_f_freemode_01")] = "mp_f_freemode_01",
    [GetHashKey("meu_ped_addon")] = "meu_ped_addon",
},

Ped que não estiver na lista cai no mp_m_freemode_01. Se o servidor usa peds addon com roupas próprias, cadastre-os aqui — senão as fotos exibidas serão as do modelo padrão.

Desligando

itemImages = {
    enabled = false,
},

A interface passa a usar o ícone da categoria em todos os cards. Tudo continua funcionando: só o visual muda.

❓ As fotos não aparecem

Confira o endereço

Abra no navegador a URL completa de uma peça, montada pelo template:

http://SEU-ENDERECO/clothes/mp_m_freemode_01/torso/4_0.webp

Se ela não abre no navegador, também não vai abrir na interface.

Confira a barra final do baseUrl

O baseUrl não deve terminar com barra — o template já começa com o nome do modelo.

Confira a extensão

O ext precisa bater com os arquivos gerados. O dk_autophoto salva em webp por padrão.

Confira o modelo do ped

Se o servidor usa peds addon, eles precisam estar no knownModels. Caso contrário, o script busca as fotos do mp_m_freemode_01.

Confira o nome das pastas

Categorias com nome de pasta diferente do id precisam estar no categoryMap.

Configurações Compartilhadas

O restante do config/shared/config.lua.

Informações Gerais

Scripts

Fotos das Roupas

📸 Fotos das Roupas

Gerando as fotos

Configuração

O template de caminho

Nomes de pasta diferentes

Peds addon

Desligando

❓ As fotos não aparecem

Configurações Compartilhadas

​📸 Fotos das Roupas

​Gerando as fotos

​Configuração

​O template de caminho

​Nomes de pasta diferentes

​Peds addon

​Desligando

​❓ As fotos não aparecem

Configurações Compartilhadas

📸 Fotos das Roupas

Gerando as fotos

Configuração

O template de caminho

Nomes de pasta diferentes

Peds addon

Desligando

❓ As fotos não aparecem