O Gerenciador de Ativos, acessível pelo menu Janela do Studio ou pela guia Início, permite gerenciar lugares e importar ativos em massa para o seu jogo, incluindo imagens, malhas, pacotes, áudio e modelos.
Atual
As seções a seguir descrevem o Gerenciador de Ativos atual. A Versão Beta V2 está documentada abaixo.
Pastas de ativos
Os ativos são organizados em pastas com base em seu tipo. Você pode alternar entre visualização em grade e visualização em lista clicando no botão de alternância de visualização.
Importando ativos
A ferramenta legada de importação em massa é ideal para importar até 50 arquivos em um único lote. Os ativos importados entram na fila de moderação e são visíveis apenas para você dentro de sua respectiva pasta e na guia Inventário da Caixa de Ferramentas. Esta ferramenta de importação em massa está disponível apenas na versão atual do Gerenciador de Ativos. A versão mais recente do Gerenciador de Ativos utiliza o Importador do Studio.
| Tipo de Ativo | Detalhes |
|---|---|
| Imagem | Você pode importar imagens nos formatos .png, .jpg, .gif, .tga ou .bmp para uso como texturas/decals em partes, rótulos de imagem, texturas de malha, texturas para materiais personalizados, texturas para efeitos especiais e muito mais. |
| Malha | Você pode importar em massa malhas nos formatos .fbx ou .obj, embora esse fluxo de trabalho não suporte malhas complexas, como aquelas com rigging, skinning ou dados de animação. Para malhas complexas, é recomendado que você use o Importador. |
| Áudio | Você pode importar ativos de áudio dos quais tem certeza que tem permissão para usar nos formatos .ogg, .mp3, .flac ou .wav. Se você não tem certeza se tem permissão para usar um arquivo de áudio, a Loja de Criadores tem uma variedade de áudios gratuitos, incluindo mais de 100.000 ativos de áudio produzidos profissionalmente. Veja Ativos de Áudio para detalhes. |
Inserir ativos
Você pode inserir ativos na hierarquia da janela Explorador arrastando e soltando ou clicando com o botão direito no nome/tile do ativo e selecionando Inserir.
O comportamento de arrastar e soltar no viewport 3D varia de acordo com o tipo de ativo:
| Tipo de Ativo | Comportamento de Arrastar e Soltar |
|---|---|
| Imagem | Se estiver pairando sobre um objeto pai válido como um BasePart, cria um novo Decal dentro desse pai com sua propriedade ColorMapContent pré-definida para o ID do ativo. |
| Malha | Incorpora o ativo como um novo MeshPart no workspace com sua propriedade MeshId pré-definida para o ID do ativo. |
| Áudio | Cria um novo objeto Sound no workspace com sua propriedade SoundId pré-definida para o ID do ativo. |
| Pacote | Insere uma cópia do pacote no workspace. |
Ações rápidas
A ações rápidas são acessíveis clicando com o botão direito no nome/tile do ativo e selecionando uma opção de contexto.
| Ação Rápida | Descrição |
|---|---|
| Renomear | Deixa você inserir um novo nome para o lugar. |
| Copiar ID para a Área de Transferência | Copia o ID do lugar para a área de transferência. |
| Ver Histórico | Abrirá o histórico de versões do lugar, permitindo que você veja commits anteriores (ações de publicação) e suas datas/horas. Se desejado, você pode reverter para uma versão anterior selecionando-a e clicando no botão Abrir. |
| Remover do Jogo | Remove completamente o lugar do jogo. Não aplicável ao lugar inicial. |
Inspeção de Ativos
Você pode inspecionar de perto uma imagem, malha, pacote ou arquivo de áudio pairando sobre sua miniatura na visualização em grade e clicando no ícone de "lupa", ou clicando com o botão direito em seu nome na visualização em lista e selecionando Pré-visualização de Ativo.
Ao visualizar ativos 3D como malhas, você pode mover a câmera virtual para obter uma melhor visão de todos os ângulos. Para vídeos, você pode pré-visualizar o vídeo inteiro no pop-up.
| Ação | Descrição |
|---|---|
| Botão esquerdo do mouse + arrastar | Rotaciona ao redor do objeto. |
| Botão direito do mouse + arrastar | Desloca para a esquerda, direita, para cima ou para baixo. |
| Roda do mouse | Faz zoom para dentro ou para fora. |
No canto inferior direito da tela de pré-visualização, o botão de composição revela toda a hierarquia do ativo, incluindo Scripts, MeshParts, Animations e mais.
Versão Beta V2
Classificação de Inventário
Os ativos são classificados por vários inventários conforme selecionado pelo menu colapsável no lado esquerdo da janela. Se você não vê a lista de classificação, clique no botão de expandir/recolher na área inferior esquerda da janela.
<Nome da Experiência> — O inventário do jogo aberto, exibido por seu nome, com ativos compartilhados com o jogo listados sob Projeto.
Lugares na Experiência — Os lugares do jogo.
Meu Inventário — Ativos importados para sua própria conta de usuário, compartilhados com você, ou adquiridos na Loja de Criadores.
Inventários de Grupos — Ativos importados para grupos que você possui ou grupos aos quais você pertence (assumindo que você tenha permissões suficientes dentro do grupo), ou ativos compartilhados com os grupos. Clicar com o botão direito em um grupo revela um menu de contexto com as seguintes opções:
Ocultar Grupo Oculta o grupo da barra lateral. Personalizar Grupos Permite escolher os grupos que aparecem na barra lateral e nas opções de filtro de pesquisa. Atualizar Grupos Atualiza a lista de grupos que você pode mostrar ou ocultar.
Pastas
As pastas permitem que você organize ativos e outras pastas em uma hierarquia dentro de um inventário. Você pode criar pastas dentro de Meu Inventário, dentro de Inventários de Grupos que suportam operações de pastas, e dentro de um inventário de jogo aberto sob Projeto.
As pastas têm os seguintes limites:
- Até 50.000 pastas por conta ou inventário raiz.
- Até 100 pastas filhas em qualquer pasta única ou inventário raiz.
- Até 20.000 ativos por pasta.
- Até 20 níveis de aninhamento de pastas.
Na primeira vez que as pastas são inicializadas para uma conta, pode haver um breve período de configuração. Se as operações de pasta ainda não estiverem disponíveis, a barra lateral mostrará um ícone de aviso ao lado da conta afetada; clique nele para atualizar a prontidão. A configuração geralmente é concluída em alguns minutos.
Criar, renomear e deletar
Clique com o botão direito na barra lateral ou na visualização principal para acessar as ações de pasta.
| Ação | Descrição |
|---|---|
| Criar Pasta | Criará uma nova pasta vazia no local atual. Uma nova entrada aparece com um campo de nome inline; digite um nome e pressione Enter para confirmar ou Esc para cancelar. |
| Agrupar Seleção como Pasta | Disponível quando um ou mais ativos estão selecionados. Cria uma nova pasta e move os ativos selecionados para ela. |
| Renomear | Substitui o nome da pasta por um campo editável inline pré-preenchido com o nome atual. Pressione Esc para cancelar sem confirmar alterações. |
| Excluir Pasta | Remove a pasta. As pastas devem estar vazias antes de serem excluídas; mova ou exclua o conteúdo primeiro. Quando várias pastas vazias são selecionadas, o menu exibe Excluir Pastas. |
Os nomes das pastas não podem conter \, /, :, *, ?, ", <, >, ou |, e não podem terminar com um ponto. Nomes que começam com um ponto (por exemplo, .hidden) são permitidos.
Navegar
Você pode navegar pela hierarquia de pastas de qualquer um dos painéis:
- Barra lateral — Use a seta de expandir para revelar subpastas ou clique uma vez em uma pasta para abri-la.
- Visualização principal — Clique duas vezes em uma pasta para entrar nela. Clique na entrada pai na barra lateral ou use a seta de voltar para retornar.
Mover itens
Você pode mover ativos e pastas, mas apenas dentro do mesmo inventário. Movimentos entre inventários (por exemplo, de Meu Inventário para um inventário de grupo) não são suportados.
| Método | Descrição |
|---|---|
| Arrastar e soltar | Arraste os itens selecionados sobre uma pasta de destino na visualização principal ou na árvore da barra lateral. Os alvos de drop válidos são destacados enquanto você paira. |
| Diálogo de Mover | Clique com o botão direito em uma seleção e escolha Mover para abrir um seletor de pasta. Use a seta de perfuração ou clique duas vezes para entrar em uma pasta, Voltar para subir um nível, depois selecione um destino e clique em Mover. Atualizar faz uma nova busca da lista de pastas no servidor. |
Você pode mover vários itens de uma vez. Mover uma pasta para dentro de si mesma ou em um de seus próprios descendentes é bloqueado, e destinos inválidos não são destacados como alvos de drop ou são exibidos em cinza no diálogo de Mover.
Pesquisa e pastas
Quando você digita uma consulta de pesquisa, os resultados incluem uma seção separada de Pastas listando as pastas correspondentes ao lado dos resultados de ativos. Clique duas vezes em um resultado de pasta para sair do modo de pesquisa e navegar para essa pasta.
Arrastar e soltar e o diálogo de Mover estão desativados enquanto estiver visualizando resultados de pesquisa. Navegue para uma pasta ou inventário primeiro, e depois reorganize.
Escopos não suportados
As operações de pasta não estão disponíveis nas seguintes visualizações:
- Lugares na Experiência — Lugares não podem ser organizados em pastas.
- Uploads Recentes — Somente leitura para fins organizacionais.
Opções de exibição dos Ativos
No painel principal, os ativos do inventário selecionado são exibidos. Para alternar o tipo de visualização, clique no botão de tipo de visualização e selecione Lista ou Grade. Enquanto estiver na visualização em grade, os tiles dos ativos podem ser redimensionados através do widget deslizante.
Na visualização Lista, clique no cabeçalho da coluna para ordenar os ativos por esse detalhe e redimensione as colunas arrastando a barra separadora entre elas.
As colunas podem ser ativadas ou desativadas clicando com o botão direito na região da barra de cabeçalho. Embora as colunas não possam ser reordenadas pelo arrasto, você pode desativar qualquer coluna e, em seguida, reativá-la para adicioná-la como a coluna mais à direita.
Na visualização Grade, a ordenação é controlada pelo botão de classificação:
Filtros por Tipo de Ativo
O botão de filtrar itens permite que você controle quais ativos são exibidos.
| Tipo de Filtro | Opções |
|---|---|
| Tipo de Ativo | Animação | Áudio | Decal | FontFamily | Imagem | Malha | MeshPart | Modelo | Lugar | Plugin | Vídeo |
| Criador | |
| Fonte | Loja do Criador | Compartilhado Comigo | Carregado |
| É Pacote | |
| Somente Arquivados |
Importação de Ativos
O botão de importar ativos permite que você importe um ou mais ativos de qualquer tipo de ativo. Os ativos importados entram na fila de moderação e, após aprovação, são adicionados ao inventário do usuário/grupo que possui o jogo.
Para mais informações sobre os tipos de arquivo suportados e outras funcionalidades, consulte Importador.
Inserir e Ações Rápidas
As ações rápidas são acessíveis clicando com o botão direito no nome/tile do ativo e selecionando uma opção do menu de contexto. Observe que lugares oferecem ações exclusivas em relação a outros ativos.
| Ação | Descrição |
|---|---|
| Inserir | Permite que você selecione entre Inserir na Câmera ou Inserir na Posição do Ativo para ativos 3D espaciais (ativos não espaciais como áudio são simplesmente inseridos no Workspace ou na instância atualmente selecionada do Explorador). Não aparece para ativos de FontFamily ou Plugin. |
| Editar Ativo | Abrirá a janela de configuração do ativo para editar detalhes como título do ativo, descrição e mais. Não aparece para ativos de FontFamily ou Plugin. |
| Mover | Abre o diálogo de Mover para realocar o ativo em uma pasta dentro do mesmo inventário. Desativado enquanto estiver visualizando resultados de pesquisa. |
| Copiar ID do Ativo | Copia o ID do ativo para a área de transferência, conveniente para colar o ID no valor da propriedade de um objeto como AudioPlayer.AssetId ou MeshPart.MeshId. |
| Ver no Navegador | Abre seu navegador na página do ativo. |
| Instalar / Atualizar / Reportar | Aplicável apenas para ativos de Plugin. Instala, atualiza ou reporta o plugin, respectivamente. |
Linguagem da consulta de pesquisa
Use a linguagem de consulta de pesquisa para refinar como você encontra ativos no inventário do Seu Gerenciador de Ativos. Você pode combinar palavras-chave, operadores e tags para filtrar, priorizar ou excluir resultados.
Ao combinar vários recursos, os termos de pesquisa são processados na seguinte ordem (da maior para a menor prioridade): Pesquisa Exata → Termos Excluídos → Termos Opcionais → Tag de ID do Ativo → Criado antes → Criado depois → Atualizado antes → Atualizado depois → Nome do Criador → ID do Criador → Nome do Grupo → ID do Grupo → ID do Ativo Numérico → Tipo de Áudio.
Recursos da consulta
Os seguintes recursos podem ser combinados em uma única consulta:
| Recurso | Sintaxe | Como funciona |
|---|---|---|
| Pesquisa Exata | "..." | Corresponde exatamente a uma frase. Correspondências exatas têm a maior prioridade e ignoram o processamento de outras tags. |
| Excluir termos | -termo excluir:termo | Exclui resultados que contêm termos específicos. |
| Termos Opcionais | termo? termo! opcional:termo | Por padrão, todos os termos são obrigatórios. Termos opcionais aumentam os resultados correspondentes sem excluir resultados que não os contêm. |
| Pesquisa por ID do Ativo | asset_id:123456 assetId:123456 123456 | Anexa ativos correspondentes ao topo dos resultados. |
| Filtros de Data | created_before created_after updated_before updated_after | Filtra resultados por data de criação ou atualização. |
| Filtros de Criador | creator_name creator_id group_name group_id | Filtra resultados pelo usuário criador ou grupo criador com base em seu nome ou ID. Quando vários filtros de criador ou grupo são fornecidos, resultados correspondentes a qualquer um deles são incluídos. |
| Tipo de Áudio | música fx efeitos sonoros | Filtra ativos de áudio por tipo. Para restringir resultados a um tipo específico de áudio, anexe o tipo ao final da sua consulta. |
Tags
Tags modificam como a pesquisa funciona, mas não são tratadas como termos de pesquisa em si. Elas apenas filtram ou classificam seus resultados. Se uma tag tem um erro de digitação ou uma data inválida, ela é tratada como um termo de pesquisa regular.
As tags podem usar os formatos tag:value ou tag=value, e não são sensíveis a maiúsculas.
Algumas tags aceitam múltiplos valores quando você usa colchetes. Por exemplo, excluir:[enferrujado, quebrado] e asset_id:[123, 456].
Formatos de data
Os filtros de data suportam os seguintes formatos:
| Formato | Exemplo |
|---|---|
| ISO 8601 | 2026-03-10 |
| ISO com hora | 2026-03-10T14:30:00Z |
| Formato dos EUA | 03/10/2026 |
| Forma longa (requer colchetes) | [10 de março de 2026] |
| Com hora (requer colchetes) | [03/10/2026 14:30] |
Consultas de exemplo
"caixa de madeira" asset_id:99887766 created_after:2023-06-01 -danificado opcional:pintado: Corresponde exatamente a "caixa de madeira", anexa um ativo específico pelo ID, filtra por data, exclui "danificado" e classifica resultados "pintados" mais alto.
explosão fx -loop created_before:[31 de dezembro de 2023]: Filtra efeitos sonoros nomeados "explosão", exclui variantes de looping e limita os resultados por data.
125447393891114 espada brilhante? -enferrujada: Anexa um ativo específico pelo ID, pesquisa "espada", aumenta a prioridade de "brilhante" e exclui "enferrujada".
árvore creator_name:construtor group_id:9876543: Pesquisa por "árvore", filtrada para ativos do criador "construtor" ou do grupo com ID 9876543.
espada creator_id:1000001,2000002 group_name:[Construtores do Estúdio]: Pesquisa por "espada", filtrada para ativos de criadores com IDs 1000001 ou 2000002, ou do grupo "Construtores do Estúdio".