Miniatura do seu item UGC: a câmera se escolhe antes de publicar, e só uma vez

A miniatura é a primeira coisa que alguém vê do seu item — na vitrine do Marketplace, no inventário e no editor de avatar. E ela tem uma propriedade que muda como se deve tratá-la: depois de enviar o asset, ela não muda mais.

Este guia cobre como controlar esse enquadramento antes do envio, e os dois defeitos que a documentação nomeia com conserto conhecido.

O problema

A miniatura dá a prévia do asset 3D em três lugares: Marketplace, inventário do usuário e editores de avatar. Não é um detalhe de vitrine — é a representação do item em todo lugar onde ele aparece sem estar vestido.

Dá para criar a própria e controlar exatamente o visual da prévia. A documentação classifica o passo como opcional, mas explica por que vale: a miniatura padrão pode não representar corretamente o item, e uma miniatura personalizada cria uma prévia mais precisa.

Na prática, "pode não representar corretamente" quer dizer coisas concretas: o item cortado, ou minúsculo no meio de um quadro vazio, ou visto de um ângulo que esconde justamente o que ele tem de bonito. A câmera padrão não sabe qual é a frente do seu acessório.

E aqui está a frase que define a urgência: a miniatura precisa ser criada antes de publicar o asset. Combinada com a de que ela não muda depois do envio, o resultado é claro — não existe "ajusto depois". Errar a miniatura significa reenviar o item inteiro, com taxa nova.

Passo a passo

1. Instale o plugin. O Custom Thumbnail Tool é o caminho oficial, e a instalação pode exigir reiniciar o Studio.

2. Selecione o acessório no Explorer.

3. Abra a ferramenta. Com o acessório selecionado, vá à aba Plugins e clique no UGC Thumbnail Tool. O viewport se atualiza e centraliza no acessório.

4. Enquadre. Os controles são quatro, e o quarto é o que faz diferença no resultado:

• W A S D desloca a câmera.
• Botão direito segurado gira a câmera.
• Botão do meio segurado também desloca.
• Shift segurado dá ajuste fino.

O ajuste fino é o que separa uma miniatura decente de uma boa. Enquadramento de item pequeno é sensível a alguns pixels, e sem o Shift a câmera anda em passos grandes demais.

5. Confirme. O botão Accept gera os objetos de configuração da miniatura.

Vale saber o que ele cria, porque isso torna o estado inspecionável: a informação fica num objeto ThumbnailConfiguration filho do acessório, que por sua vez tem um CameraTarget e um CameraValue. Se esses objetos sumirem, a miniatura volta a ser a padrão — e é bom saber disso antes de limpar a hierarquia.

6. Confira antes de enviar. Clicando com o botão direito no acessório e escolhendo salvar no Roblox, a janela de configuração do asset aparece mostrando a miniatura atual. Se não estiver bom, repita o enquadramento e sobrescreva.

Este passo é o único momento em que dá para ver o resultado real antes de ele virar definitivo. Pular esta conferência é apostar.

Uma observação sobre o que a miniatura precisa mostrar. O enquadramento não é uma foto bonita do item — é a informação que o comprador usa para decidir. Três coisas competem pelo quadro: a silhueta, que diz o que o item é; o detalhe, que diz se ele é bem feito; e a escala, que diz como ele vai ficar no avatar.

Nenhum ângulo entrega as três com o mesmo peso, e é aí que a decisão acontece. Item de silhueta forte — um chapéu de formato incomum, uma mochila grande — ganha mais de um ângulo que mostre o contorno. Item cujo valor está na textura ganha mais de uma aproximação. E item pequeno, como um acessório de rosto, quase sempre precisa de mais aproximação do que a câmera padrão dá, porque na vitrine ele vai aparecer pequeno de novo.

O teste honesto é olhar a miniatura no tamanho em que ela aparece de verdade — reduzida, numa grade com outras. Enquadramento que só funciona em tela cheia não funciona.

Artefato

O documento abaixo é o roteiro em formato de conferência, com uma seção de pré-requisitos que vem antes de abrir a ferramenta — porque os dois defeitos conhecidos não se consertam enquadrando a câmera.

No fim dele está a tabela dos dois defeitos, com sintoma, causa e conserto. Ela existe porque os dois têm uma característica em comum que os torna difíceis de achar, e é o assunto da próxima seção.

Vale ainda um cuidado com a hierarquia. Os três objetos que guardam o enquadramento vivem dentro do acessório, e qualquer operação que reconstrua o item — recriar o Accessory, colar uma versão antiga, reimportar a malha por cima — pode levá-los embora. Como a miniatura volta silenciosamente à padrão nesse caso, a conferência pela janela de configuração é o que pega.

E há um detalhe de ordem que economiza uma rodada: conferir a miniatura depois de toda alteração no Handle. Como a escala do enquadramento depende dele, um ajuste de tamanho feito depois de aceitar a câmera muda o resultado sem que nada avise.

Erro comum

Zoom errado. O item aparece cortado, ou minúsculo. A causa não está na câmera: a escala da miniatura depende do tamanho do Handle do acessório. Para a melhor miniatura, o Handle precisa cobrir o item inteiro.

É uma dependência que ninguém adivinha. O Handle é a peça funcional do acessório, e é comum deixá-lo pequeno — ele não precisa ser grande para o item funcionar. Só que o sistema de miniatura usa o tamanho dele para decidir o enquadramento.

E a correção vem com um alerta específico: ao mudar o tamanho do Handle, ajuste a propriedade Size, e não a ferramenta de escala do Studio. O motivo está escrito — a ferramenta de escala pode causar outras mudanças não intencionais no item. Ela mexe em mais coisa do que o tamanho.

Miniatura de costas. O item aparece virado. A causa: ao importar malha, o Studio pode mudar a orientação do modelo em 180 graus. O conserto é girar a malha 180 graus no programa de modelagem e reimportar.

E aqui está a característica que os dois defeitos compartilham, e que os torna traiçoeiros: independente da orientação de importação, o Studio equipa o acessório no personagem com o mesmo encaixe e attachment.

Ou seja: o item veste certo. Você testa no avatar, gira o personagem, olha de todos os lados, está perfeito. O defeito existe apenas na miniatura — e a miniatura é a única coisa que você não conferiu, porque parecia consequência automática do modelo.

É por isso que o passo 6 do roteiro não é opcional. Ele é o único lugar onde os dois defeitos aparecem antes de ser tarde.

Tratar como opcional de verdade. A documentação chama o passo de opcional, e isso é sobre exigência, não sobre valor. A miniatura padrão existe e funciona; ela só não sabe qual é a frente do seu item nem o que nele merece destaque. Num catálogo onde o comprador decide pela imagem, isso não é detalhe.

Confiar no teste vestindo. É o erro que engloba os dois anteriores e merece ser dito sozinho: testar o acessório no avatar não testa a miniatura. São dois caminhos independentes dentro do Studio, e o item pode estar perfeito num e errado no outro. Quem termina o trabalho vestindo o item no personagem, achando bom e enviando, nunca olhou a miniatura — e ela é a única parte irreversível.

Próximo passo

A ordem que economiza dinheiro é simples e contraria o instinto: enquadre a miniatura antes de considerar o item pronto, não depois.

Na prática, isso significa abrir a ferramenta assim que o acessório estiver montado no Studio — antes de texturizar o último detalhe, antes de escrever a descrição. Se o enquadramento revelar que o Handle está errado ou que o modelo está de costas, você descobre enquanto ainda é barato consertar.

Depois, vale guardar o enquadramento como parte do arquivo do item. Os objetos ThumbnailConfiguration, CameraTarget e CameraValue vivem dentro do acessório — então salvar o arquivo do Studio preserva a câmera. Para uma coleção de itens parecidos, isso permite reaproveitar o mesmo ângulo, o que dá consistência visual à vitrine inteira.

E guarde a regra que resume tudo: a miniatura é a única parte do item que você não pode consertar depois. Todo o resto — descrição, preço, disponibilidade — tem conserto. Ela não.

MINIATURA PERSONALIZADA DE ITEM UGC. Conferido em 23/09/2026.

!! A MINIATURA NAO MUDA DEPOIS DO ENVIO. Ela tem que estar certa ANTES
   de publicar o asset. Errou? o item inteiro precisa ser reenviado, com
   taxa nova.

== ANTES DE ABRIR A FERRAMENTA ==

  [ ] o HANDLE cobre o item inteiro?
        a escala da miniatura depende do tamanho do Handle. Handle
        pequeno demais = item cortado; grande demais = item minusculo
        no meio do vazio.
  [ ] ao ajustar o Handle, usou a propriedade SIZE?
        NAO use a ferramenta de escala do Studio: ela pode causar outras
        mudancas NAO INTENCIONAIS no item.
  [ ] o modelo esta virado para a frente?
        ao importar malha, o Studio pode virar o modelo em 180 graus.

== O ROTEIRO ==

  [ ] instalar o plugin Custom Thumbnail Tool
        (pode exigir REINICIAR o Studio)
  [ ] selecionar o Accessory no Explorer
  [ ] aba Plugins  >  UGC Thumbnail Tool
        o viewport se atualiza e centraliza no acessorio
  [ ] enquadrar a camera:
        W A S D ............ deslocar
        botao DIREITO ...... girar
        botao do MEIO ...... deslocar
        SHIFT .............. ajuste fino
  [ ] Accept
        gera os objetos de configuracao
  [ ] CONFERIR: botao direito no acessorio > Save To Roblox...
        a janela de configuracao aparece mostrando a miniatura ATUAL.
        Nao gostou? repita o enquadramento e sobrescreva.

== O QUE E GRAVADO ==

  Accessory
  └── ThumbnailConfiguration
      ├── CameraTarget
      └── CameraValue

  Sao esses dois que guardam o enquadramento. Se eles sumirem, a
  miniatura volta a ser a padrao.

== OS DOIS DEFEITOS CONHECIDOS ==

| Sintoma                  | Causa                    | Conserto                     |
|--------------------------|--------------------------|------------------------------|
| zoom errado, item        | o Handle nao cobre o     | ajustar o Handle pela        |
| cortado ou pequeno       | item inteiro             | propriedade Size             |
| item de COSTAS           | o Studio virou o modelo  | girar a malha 180 graus no   |
|                          | em 180 graus na          | programa de modelagem e      |
|                          | importacao               | reimportar                   |

  Nos dois casos o acessorio continua equipando CERTO no personagem --
  o Studio usa o mesmo encaixe e attachment independente da orientacao
  de importacao. Por isso o defeito so aparece na MINIATURA, e por isso
  passa despercebido em quem testa vestindo.