O Gerenciador de Ativos, acessível através do menu Janela do Studio ou da guia Início, permite que você gerencie lugares e importe ativos em massa para o seu jogo, incluindo imagens, malhas, pacotes, áudio e modelos.
Atual
As seções a seguir descrevem o atual Gerenciador de Ativos. O V2 Beta está documentado abaixo.
Pastas de Ativos
Os ativos são organizados dentro de pastas com base em seu tipo. Você pode alternar entre a visão em grade e a visão em lista clicando no botão de alternância de visualização.
Importando Ativos
A ferramenta de importação em massa legada é 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ê em suas respectivas pastas 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.
| Tipo de Ativo | Detalhes |
|---|---|
| Imagem | Você pode importar imagens nos formatos .png, .jpg, .gif, .tga ou .bmp para uso como texturas/decalques em partes, rótulos de imagem, texturas de malha, texturas para materiais personalizados, texturas para efeitos especiais e muito mais. |
| Malha | Você pode importar malhas em massa nos formatos .fbx ou .obj, embora este 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 possui permissão para usar, nos formatos .ogg, .mp3, .flac ou .wav. Se você não tiver certeza se tem permissão para usar um arquivo de áudio, a Loja do Criador possui uma variedade de áudios gratuitos, incluindo mais de 100.000 ativos de áudio produzidos profissionalmente. Veja Ativos de Áudio para mais detalhes. |
Inserir Ativos
Você pode inserir ativos na hierarquia da janela Explorador arrastando-os ou clicando com o botão direito no nome/tiles do ativo e selecionando Inserir.
O comportamento de arrastar e soltar na área 3D varia conforme 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 daquele pai, com sua propriedade ColorMapContent pré-configurada para o ID do ativo. |
| Malha | Insere o ativo como um novo MeshPart no espaço de trabalho, com sua propriedade MeshId pré-configurada para o ID do ativo. |
| Áudio | Cria um novo objeto Sound no espaço de trabalho, com sua propriedade SoundId pré-configurada para o ID do ativo. |
| Pacote | Insere uma cópia do pacote no espaço de trabalho. |
Ações Rápidas
As ações rápidas estão acessíveis clicando com o botão direito no nome/tiles de um ativo e selecionando uma opção de contexto.
| Ação Rápida | Descrição |
|---|---|
| Renomear | Permite que você insira um novo nome para o lugar. |
| Copiar ID para a Área de Transferência | Copiar o ID do lugar para a área de transferência. |
| Ver Histórico | Abre o histórico de versões do lugar, permitindo que você visualize os commits anteriores (ações de publicação) e suas data/hora. Se desejado, você pode voltar 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 visão em grade e clicando no ícone "ampliar", ou clicando com o botão direito em seu nome na visã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 perspectiva de todos os ângulos. Para vídeos, você pode visualizar todo o vídeo no popup.
| Ação | Descrição |
|---|---|
| Botão esquerdo do mouse + arrastar | Girar em torno do objeto. |
| Botão direito do mouse + arrastar | Deslocar para a esquerda, direita, para cima ou para baixo. |
| Roda do mouse | Zoom in ou out. |
No canto inferior direito do quadro de visualização, o botão composição revela toda a hierarquia do ativo, incluindo Scripts, MeshParts, Animations e mais.
V2 Beta
Classificação de Inventário
Os ativos são classificados por vários inventários conforme selecionado no 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 pelo 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 do Criador.
Inventários de Grupo — Ativos importados para grupos que você possui ou grupos aos quais pertence (supondo que você tenha permissões suficientes dentro do grupo), ou ativos compartilhados com os grupos. Clicar com o botão direito sobre um grupo revela um menu de contexto com as seguintes opções:
Ocultar Grupo Oculta o grupo da barra lateral. Personalizar Grupos Permite que você escolha os grupos que aparecem na barra lateral e nas opções de filtro de pesquisa. Atualizar Grupos Atualiza a lista de grupos que você está apto a 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 dos Inventários de Grupo que suportam operações de pasta, e dentro do inventário do 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 ou inventário raiz único.
- Até 20.000 ativos por pasta.
- Até 20 níveis de aninhamento de pastas.
Na primeira vez em que as pastas são inicializadas para uma conta, pode ocorrer 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 poucos minutos.
Criar, renomear e excluir
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 | Cria uma nova pasta vazia na localização atual. Uma nova entrada aparece com um campo de nome em linha; 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 com um campo editável em linha preenchido com o nome atual. Pressione Esc para cancelar sem confirmar as 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 mostra 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 — Dê um duplo clique 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 para uma pasta de destino na visualização principal ou na árvore da barra lateral. Destinos de queda 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 pastas. Use a seta de expandir ou clique duas vezes para entrar em uma pasta, Voltar para subir um nível, em seguida, selecione um destino e clique em Mover. Atualizar recupera novamente a lista de pastas do servidor. |
Você pode mover vários itens ao mesmo tempo. Mover uma pasta para dentro de si mesma ou para um de seus descendentes é bloqueado, e destinos inválidos não são destacados como alvos de queda ou são cinza na caixa de diálogo Mover.
Pesquisa e Pastas
Quando você digita uma consulta de pesquisa, os resultados incluem uma seção separada Pastas listando pastas correspondentes ao lado dos resultados dos ativos. Dê um duplo clique em um resultado de pasta para sair do modo de pesquisa e navegar até essa pasta.
Arrastar e soltar e o diálogo Mover estão desativados enquanto visualiza os resultados de pesquisa. Navegue para uma pasta ou inventário primeiro, depois reorganize.
Escopos Não Suportados
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 de 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 visão em grade, os tiles de ativos podem ser redimensionados através do widget deslizante.
Na visualização Lista, clique no cabeçalho de uma coluna para ordenar ativos por aquele detalhe e redimensione colunas arrastando a barra de separação entre elas.
As colunas podem ser alternadas entre ligadas ou desligadas clicando com o botão direito na região da barra do cabeçalho. Embora as colunas não possam ser reorganizadas arrastando, você pode desligar qualquer coluna e depois ligá-la novamente para adicioná-la como a coluna mais à direita.
Na visualização Grade, a ordenação é controlada pelo botão classificar:
Filtros de Tipo de Ativo
O botão filtrar itens permite que você controle quais ativos são exibidos.
| Tipo de Filtro | Opções |
|---|---|
| Tipo de Ativo | Animação | Áudio | Decalque | Família de Fontes | Imagem | Malha | Parte de Malha | Modelo | Lugar | Plugin | Vídeo |
| Criador | |
| Fonte | Loja do Criador | Compartilhado Comigo | Carregado |
| É Pacote | |
| Somente Arquivados |
Importação de Ativos
O botão importar ativos permite que você importe um ou mais ativos de qualquer tipo de ativo. 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 a experiência.
Para mais informações sobre os tipos de arquivo suportados e outras funcionalidades, veja o Importador.
Inserir e Ações Rápidas
Ações rápidas estão acessíveis clicando com o botão direito no nome/tile de um ativo e selecionando uma opção do menu de contexto. Observe que os lugares oferecem ações exclusivas em comparação com 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 Família de Fontes ou Plugin. |
| Editar Ativo | Abre a janela de configuração de ativo para editar detalhes como o título do ativo, descrição e mais. Não aparece para ativos de Família de Fontes ou Plugin. |
| Mover | Abre o Diálogo de Mover para realocar o ativo em uma pasta dentro do mesmo inventário. Desabilitado enquanto visualiza 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 de 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 Plugin. Instala, atualiza ou reporta o plugin, respectivamente. |
Linguagem de Consulta de Pesquisa
Use a linguagem de consulta de pesquisa para refinar como você encontra ativos no seu inventário do 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 à 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 numérico do ativo → Tipo de áudio.
Recursos de Consulta
Os seguintes recursos podem ser combinados em uma única consulta:
| Recurso | Sintaxe | Como Funciona |
|---|---|---|
| Pesquisa Exata | "..." | Corresponde a uma frase exatamente. Correspondências exatas têm a maior prioridade e ignoram outros processos de tag. |
| Excluir Termos | -term excluir:term | Exclui resultados que contêm termos específicos. |
| Termos Opcionais | term? term! opcional:term | Por padrão, todos os termos são obrigatórios. Termos opcionais aumentam os resultados correspondentes sem excluir resultados que não os contenham. |
| Pesquisa de ID do Ativo | asset_id:123456 assetId:123456 123456 | Prende 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 no nome ou ID. Quando vários filtros de criador ou grupo são fornecidos, os resultados correspondentes a qualquer um deles são incluídos. |
| Tipo de Áudio | music sfx efeitos sonoros | Filtra ativos de áudio por tipo. Para restringir os resultados a um tipo de áudio específico, anexe o tipo ao final de sua consulta. |
Tags
As tags modificam como a pesquisa funciona, mas não são tratadas como termos de pesquisa em si. Elas apenas filtram ou ranqueiam seus resultados. Se uma tag tiver um erro de digitação ou uma data inválida, é 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, exclude:[rusty, broken] e asset_id:[123, 456].
Formatos de Data
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 2:30 PM] |
Exemplos de Consultas
"caixa de madeira" asset_id:99887766 created_after:2023-06-01 -danificada optional:colorida: Corresponde exatamente à "caixa de madeira", fixa um ativo específico pelo ID, filtra por data, exclui "danificada" e ranqueia resultados "colorida" mais alto.
explosão sfx -loop created_before:[31 de dezembro de 2023]: Filtra efeitos sonoros chamados "explosão", exclui variantes em loop e limita os resultados por data.
125447393891114 espada brilhante? -enferrujada: Fixa um ativo específico pelo ID, pesquisa "espada", aumenta "brilhante" e exclui "enferrujada".
árvore creator_name:construtor group_id:9876543: Pesquisa "á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 "espada", filtrada para ativos de criadores com IDs 1000001 ou 2000002, ou do grupo "Construtores do Estúdio".