Asset ID, Universe ID e Place ID no Roblox: qual é qual

Três IDs, três coisas

A documentação de ativos do Creator Hub abre com uma frase que ajuda a organizar tudo: quase tudo no Roblox é representado como um ativo na nuvem com um ID único correspondente. Imagens, áudios, malhas e modelos são ativos, e o ID é o que você cola em propriedades como a textura de uma partícula. Já o jogo como um todo tem outra camada. A página de publicação explica que, ao publicar pela primeira vez, o Roblox atribui ao jogo um Universe ID único, e que um jogo pode ter um place ou vários, comparáveis a cenas no Unity ou mapas na Unreal.

O guia de publicação de lugares resume a relação numa linha: o Place ID identifica o lugar e o Universe ID identifica o jogo, e cada um é único mesmo quando o jogo tem um só place. O guia também lembra que um jogo pode ter vários lugares, que o lugar inicial é o ponto de entrada dos jogadores e que os outros são opcionais, alcançados por teleportes.

Onde achar cada ID no Creator Hub

1. Universe IDNo Painel do Criador, passe o mouse sobre a miniatura do jogo, clique em ⋯ e escolha "Copy Universe ID". A documentação também aponta a página de visão geral da experiência.
2. Place IDNa mesma página de criações, abra o jogo, entre na aba Places, clique na miniatura do lugar. O Place ID está na URL para a qual você é redirecionado.
3. Passe e emblemaEm Monetization > Passes (ou na seção de emblemas do jogo), passe o mouse sobre a miniatura, clique em ⋯ e escolha "Copy Asset ID".
4. Asset ID de itemAparece na URL da página do item no Creator Store ou no catálogo; é o número que o Extrator de Asset ID aceita sozinho ou dentro do link.

https://create.roblox.com/dashboard/creations/experiences/0000000/places/111111/configure
                                                         ^^^^^^^         ^^^^^^
                                                         universo        place

O exemplo vem do guia de publicação, que mostra a URL com 0000000 antes de /places/ e 111111 depois, e diz que o Place ID é o segundo. A mesma página de documentação também pede a chave de API: ao criar uma chave, o guia de chaves de API permite restringi-la a um jogo específico (ou a todos os que você possui), e nem todos os escopos aceitam essa restrição.

Onde cada ID é usado

A documentação de Data Stores pela API de nuvem é direta: como as APIs de nuvem aberta não guardam estado e podem vir de qualquer lugar, você sempre precisa fornecer o Universe ID, o identificador único do seu jogo. O Place ID não aparece ali. Esse é o erro clássico de quem copia o número da URL do jogo no site (que é de um place) e o usa onde se espera o Universe ID: o número não é o que a API espera.

rbxassetid://

Prefixo de ativo enviado por um usuário. Segundo o Creator Hub, é a forma recomendada para ativos usados em vários jogos; rbxgameasset só funciona dentro do jogo atual.

Lugar inicial (start place)

O lugar em que os jogadores entram. Pode ser substituído publicando outro lugar por cima, com "Publish As".

Tipo de ativo (AssetType)

Enumeração numérica do Roblox que classifica cada ativo: Image 1, TShirt 2, Audio 3, Mesh 4, Place 9, Model 10, Shirt 11, Pants 12, Decal 13, Badge 21, Animation 24, GamePass 34.

A armadilha do decal: o ID certo para a coisa certa

O erro mais comum com Asset IDs é confundir o decal com a imagem que ele contém. Na enumeração de tipos do Creator Hub, Image vale 1 e Decal vale 13: são ativos diferentes, com IDs diferentes. Muitas propriedades esperam o ID da imagem, e colar o ID do decal faz a textura não aparecer. Camisa (Shirt, 11), calça (Pants, 12) e camiseta (TShirt, 2) seguem a mesma lógica, e o extrator também resolve o ID da imagem delas.

O Extrator de Asset ID resolve isso e é honesto sobre o grau de certeza. Para um decal, camisa, calça ou camiseta, ele devolve o ID da imagem por um de três caminhos, e a interface mostra uma nota de confiança diferente para cada um:

O que o Extrator de Asset ID realmente faz

A ferramenta é híbrida: a análise do que você cola (link, rbxassetid://, rbxthumb://, chamada Content.fromAssetId, @usuário ou número solto) acontece no navegador, e a consulta ao Roblox passa por uma rota do servidor deste site. Essa rota fala apenas com hosts fixos do Roblox (economia, catálogo, Creator Store, miniaturas, emblemas, passes, jogos, usuários, avatares e grupos), valida cada parâmetro antes de qualquer chamada de rede, limita o ritmo por visitante e guarda respostas em cache. Você nunca recebe a resposta crua do Roblox, e nenhum endereço é montado a partir do texto que você digita.

• Consultar: identifica um número. No modo automático, tenta ativo, emblema, passe e pacote, nessa ordem; você também pode forçar o tipo (ativo, place, universe, emblema, passe, pacote, usuário ou grupo).
• Em lote: consulta até 100 IDs de uma vez e devolve nome, tipo, criador e miniatura de cada um.
• Buscar IDs: pesquisa no Creator Store (áudio, modelo, decal, malha, plugin, vídeo, fonte) e no marketplace de avatar.
• Referência: a tabela completa de tipos de ativo, com nomes e números.

Para a ponte entre place e universe, a ferramenta consulta o serviço de universos do Roblox: dado um Place ID, obtém o Universe ID correspondente, depois lê os dados do jogo (nome, criador, jogadores, visitas, favoritos, lugar raiz). Se você começou de um universe, o lugar raiz é o place de entrada. O conversor dedicado faz só essa conversão, em lote de até 50 números, e a calculadora de game pass cobre a parte de preço que vem depois do ID. Para a economia por trás de preço e saque, veja Robux por dentro.

Erros comuns e acesso aos ativos

• Open Cloud pediu o Universe ID? Não use o número da URL do jogo no site: ele é um Place ID.
• A textura não aparece? Confira se o ID é de uma Image (tipo 1) e não de um Decal (tipo 13).
• O ativo é seu? Ativos de terceiros podem ser restritos: um ativo restrito só aparece em tempo de execução se tiver permissão explícita.
• Vai usar o ativo em vários jogos? Prefira rbxassetid:// a rbxgameasset://.
• Copiou o ID de passe ou emblema? Use o menu "Copy Asset ID" do painel, não o número de outra tela.

Quanto ao acesso, a página de privacidade de ativos diz que, por padrão, imagens, decals e malhas são criados como Open Use, e que a Asset Privacy os torna Restricted; um ativo restrito precisa de permissão explícita para ser visto ou ouvido em execução, e um jogo precisa de permissão própria para salvar ou publicar um lugar que o inclua. Áudio, vídeo, modelos, MeshParts, animações e pacotes mantêm padrões próprios. A página geral de ativos acrescenta que, para dar acesso a todos pelo ID, é preciso distribuir o ativo no Creator Store. Por isso o extrator mostra, nos áudios, se o item aparece no Creator Store ou provavelmente é restrito, e deixa claro que isso é um sinal, não uma garantia.