For the complete documentation index, see llms.txt. This page is also available as Markdown.

Publicar uma Scene

Como publicar sua scene em LAND ou em um NAME.

Antes de começar

Certifique-se do seguinte:

  • A sua scene cumpre todas as limitações da scene. A maioria destas é validada sempre que executa um preview da sua scene.

  • Tem uma Metamask conta, com os seus LAND Parcels ou NAME atribuídos a ela.

  • Possui a quantidade necessária de LAND Parcels adjacentes ou um Decentraland NAME. Caso contrário, pode comprar LAND no Marketplace ou um NAME no Marketplace.

Verifique os detalhes da sua scene, certifique-se de fornecer um nome apelativo, descrição, thumbnail, categorias, etc.

Publique a sua scene

Para publicar a sua scene:

  1. Abra a sua scene no Scene Editor e clique em Publicar. Isto abre uma janela com detalhes sobre a publicação.

  2. Selecione se quer publicar para LAND ou para um WORLD. Consulte Tipos de projetos para compreender melhor as diferentes opções.


  1. Se publicar para LAND, selecione a localização no mapa. Verá os seus Parcels elegíveis assinalados a vermelho. Se publicar para um WORLD, verá os seus NAMEs elegíveis num dropdown.

💡 Dica: Se não vir os seus Parcels ou NAMEs, certifique-se de que está ligado ao Creator Hub com a conta de utilizador correta. Caso contrário, saia do projeto e clique no ícone de definições do utilizador no canto superior direito, depois selecione Terminar sessão e volte a iniciar sessão.

  1. O ecrã seguinte mostra todos os ficheiros que está atualmente a carregar e os respetivos tamanhos; confirme a operação.

  2. O processo de publicação irá então começar. As etapas 1 e 2 são necessárias para que a sua scene seja jogável; quando terminarem, um Jump In botão aparece. Não precisa de esperar por Etapa 3 para experimentar a sua scene. 

📔 Nota: As três etapas do deployment incluem:

  • 1. Carregamento: Carregamento dos ficheiros para os servers.

  • 2. Conversão: Os modelos 3D da scene são comprimidos em Asset Bundles para uma renderização mais rápida. Isto pode demorar 15 minutos ou menos. Pode demorar mais em scenes muito grandes, ou se os servers estiverem ocupados a converter outras scenes.

  • 3. Otimização: São geradas versões de Low Level of Detail (LOD) dos seus assets. Estas só são usadas para renderizar a sua scene à distância, o que significa que não precisa de esperar que isto termine para entrar e testar a sua scene.

Quanto tempo demora a publicação?

  • O carregamento em si: de segundos a alguns minutos. Escala com o tamanho total da sua scene e com a largura de banda de carregamento.

  • Até poder testá-la: o Jump In botão aparece assim que a scene fica jogável, quando as etapas 1 e 2 terminarem.

  • Até ser jogável de forma fiável por toda a gente: planeie entre 30 e 60 minutos. A conversão dos modelos 3D é executada separadamente para cada plataforma (Windows e Mac), e a nova versão da scene também precisa de se propagar por todos os content servers.

  • Antes de um evento em direto: publique a sua versão final pelo menos 2 horas antes de o evento começar.

Os seguintes fatores podem tornar uma publicação mais lenta:

  • Tamanho total da scene: afeta tanto o carregamento como a conversão.

  • O número e a complexidade de modelos 3D distintos: os modelos são convertidos um a um.

  • O quão ocupados estão os servers de conversão: a sua scene pode ficar em fila atrás de outras scenes publicadas por volta da mesma altura. Esta é muitas vezes a maior variável, e pode ver a fila diretamente.

  • Republicar repetidamente: cada publicação cria uma nova versão da scene que reinicia todo o processo, no fim da fila. Publicar três vezes em dez minutos é mais lento do que publicar uma vez.

Gerir Worlds

O Creator Hub permite a gestão de Worlds através do separador Manage no seu painel principal. O separador Manage permite o acompanhamento e a edição de Worlds. Aqui, pode editar as Definições do World, Permissões e Scenes. Manage Worlds.

Orçamento de armazenamento do World

As scenes publicadas em Worlds contam para um orçamento de armazenamento partilhado por todos os Worlds detidos pela sua wallet. O orçamento cresce com os seus ativos: cada Decentraland NAME ou LAND Parcel que possui concede 100 MB, e cada 2.000 MANA mantidos na sua wallet concede mais 100 MB. Os Worlds publicados em domínios ENS têm, em vez disso, um limite fixo de 36 MB.

O Manage separador mostra quanto do seu orçamento de armazenamento está a utilizar. Clique em Ver detalhes para ver como as suas participações em MANA, LAND e NAME se somam.

Também pode verificar o orçamento restante no separador Worlds do Builder.

Consulte Limites de tamanho dos Worlds para detalhes sobre como o orçamento é calculado e o que acontece se o exceder.

Definições do World

Um World Owner pode editar as suas definições ao entrar no World pretendido Definições no Manage painel, ou ao aceder durante o processo de publicação clicando em Definições se Multi-Scene World (Avançado) estiver ativado.

  • Detalhes: Informação geral do World:

    • Título do World

    • Descrição

    • Classificação de conteúdo

    • Categorias

A informação adicionada em Detalhes será mostrada em Decentraland Places e nas informações do World no World assim que for publicada. Tenha em conta que, se o World contiver uma única scene, estes detalhes são substituídos pelos metadados da scene em cada publicação. Consulte metadados do World vs metadados da scene abaixo.

  • Layout: Apenas acessível em Worlds Multi-Scene. Contém informação sobre todas as scenes publicadas do World.

    • Remova scenes individuais clicando nos três pontos e selecionando Remover do World.

    • Mapa do World mostra o layout do World e identifica os Parcels com conteúdo e os restantes Parcels livres.

  • Diversos: Outras configurações úteis do World:

    • World Spawn Coordinate: Isto define o Parcel (X,Y) em que o utilizador fará spawn dentro do World. A scene localizada nesse Parcel determina a posição exata em que o utilizador fará spawn (por exemplo, Parcel 1,1 é o World Spawn, e a scene em 1,1 tem um Spawn point de 1,0,1 dentro dessa scene).

    • Definições do skybox

📔 Nota: As World Settings só estão acessíveis ao World Owner (o endereço que fez mint do NAME). Para mais detalhes sobre como obter um NAME, consulte a secção NAMEs do Marketplace.

metadados do World vs metadados da scene

Um World e cada scene publicada nele têm dois conjuntos separados de metadados. Ambos incluem um nome, uma descrição e uma thumbnail:

  • Metadados da scene: Pertence ao projeto da scene, armazenado no seu scene.json ficheiro. Edite-o através das definições da scene no Scene Editor, e é carregado juntamente com a scene sempre que publica.

  • Metadados do World: Pertence ao próprio World. Edite-o nas Definições, no Manage separador do Creator Hub. Esta é a informação mostrada em Decentraland Places e nas informações do World no World.

A forma como estes dois se relacionam depende de quantas scenes o World contém:

  • World vazio: Quando publica uma scene num World vazio, os metadados do World são preenchidos a partir dos metadados da scene.

  • World de uma única scene: Sempre que publica a scene, os metadados do World são atualizados para corresponder aos metadados da scene.

  • World de múltiplas scenes: Os metadados do World são totalmente independentes dos metadados de cada uma das suas scenes. Publicar uma scene nunca altera os metadados do World. A única forma de os alterar é através dos Definições no Manage separador.

Na prática, se o seu World contiver uma única scene, não precisa de pensar nos metadados do World como algo separado: basta editar as definições da sua scene e publicar, e o World refletirá sempre isso.

Num Multi-Scene World, o Definições no Manage separador é o único local para editar os metadados do World.

Multi-Scene Worlds

Um World pode ter várias scenes, publicadas pelo World Owner ou por outros criadores. Isto permite um ambiente colaborativo onde cada parcela pode ser gerida por diferentes Collaborators.

Tornar um World Multi-Scene

Um World Owner pode optar por tornar o World Multi-Scene ao ativar Multi-Scene World (Avançado) ao publicar para um World de uma única scene.

Uma vez publicado o Multi-Scene World, o World Owner pode publicar scenes adicionais ou adicionar Collaborators para publicar dentro do World.

📔 Nota: O tamanho de um World Multi-Scene adapta-se automaticamente para conter todas as scenes publicadas, crescendo e diminuindo dinamicamente em cada publicação. O espaço deixado entre diferentes scenes no Multi-World é preenchido com o ambiente.

Adicionar Collaborators a um Multi-Scene World

No Manage painel, um World Owner pode aceder às Permissions clicando nos três pontos. O World Owner pode gerir colaboradores na Collaborators separador.

Um Collaborator pode ter direitos de deploy para All Parcels ou para coordenadas personalizadas específicas. As coordenadas personalizadas podem ser selecionadas e confirmadas através de um mapa interativo do World, semelhante ao das World Settings.

Fazer deploy para um Multi-Scene World como Collaborator

Os World Collaborators não podem editar as suas Settings ou Permissions. No Manage separador, um criador pode ver o World em que é Collaborator, mas não pode aceder a Definições ou Permissions.

Ao passar pelo processo de publicação, o criador pode selecionar publicar apenas para as parcelas em que é Collaborator (conforme definido pelo World Owner).

No Collaborators secção, se o World Owner tiver definido Custom Coordinates para o criador, apenas as parcelas atribuídas estarão disponíveis para publicação. Se o acesso tiver sido definido como All Parcels, o criador poderá selecionar qualquer Parcel do World para publicar a sua scene.

Worlds privados

Um WORLD pode ter diferentes Acesso definições. Pode estar acessível a qualquer pessoa, ou ser restringido de diferentes formas.

Definir o Acesso de um WORLD

No Manage painel, um World Owner pode aceder às Permissions clicando nos três pontos. O World Owner pode gerir as restrições de acesso na Acesso separador.

Tipos de Acesso

Um World Owner pode escolher entre três tipos de Acesso ao World:

Público

Qualquer pessoa pode aceder ao World. Esta é a definição padrão de um World.

Protegido por palavra-passe

Apenas os utilizadores com a palavra-passe podem entrar no World.

As palavras-passe devem ter pelo menos 8 caracteres e conter pelo menos 2 números. Depois de criada, a palavra-passe não ficará acessível, por isso certifique-se de guardar uma cópia.

Apenas por convite

Apenas os endereços e Communities adicionados em Endereços aprovados podem aceder ao World.

Para adicionar novos endereços ou comunidades ao Endereços aprovados, siga estes passos:

  1. Clique em + Novo convite botão.

  2. Pode adicionar endereços de três formas diferentes:

  • Endereço da wallet: Adicione wallets individuais, uma de cada vez.

  • Comunidade: Pesquise e adicione qualquer Comunidade Pública. Isto adiciona todos os endereços da Community a Endereços aprovados.

  • Importar CSV: Use um CSV existente com uma lista de endereços ou IDs de comunidades para adicionar a Endereços aprovados. A estrutura é uma wallet por linha, por exemplo:

Depois de importado, acompanha cada Address individualmente, como mostrado na imagem.

  1. Após confirmar, o(s) endereço(s) ficam em Endereços aprovados.

  2. Com um novo + Novo convite, os endereços são adicionados à lista existente, ajudando o World Owner a gerir e expandir a lista se necessário.

  1. Endereços individuais ou conjuntos de Endereços (no caso de uma Community) podem ser removidos selecionando Eliminar nos três pontos na Endereços aprovados secção.

Entrar em Worlds privados

Existem diferentes cenários se um utilizador entrar num World que não tem Público acesso:

  • O seu endereço na Endereços aprovados: Poderá entrar normalmente. Caso contrário, receberá informação de que o World está Apenas por convite.

  • O World está Protegido por palavra-passe: Os utilizadores poderão introduzir a palavra-passe. O limite máximo é de dez (10) tentativas.

Publicar a partir de uma hardware wallet

Em vez de armazenar os seus tokens LAND numa conta Metamask, pode ser mais seguro guardá-los num dispositivo de hardware wallet, como um Ledger ou um Trezor, que está fisicamente ligado ao seu computador.

Se estiver a usar um destes dispositivos, pode ligar a hardware wallet ao Metamask para permitir a assinatura de mensagens, mantendo os tokens mais seguros. Consulte este artigo da Metamask para instruções sobre como ligar a sua conta.

Uma vez que a sua hardware wallet possa ser usada via Metamask, pode fazer deploy seguindo os mesmos passos como se os seus tokens estivessem numa conta Metamask.

Substituição de scene

Quando uma nova scene é deployada, substitui o conteúdo mais antigo que existia nas parcelas que ocupa.

Se uma scene que ocupa várias parcelas for apenas parcialmente substituída por outra, todos os seus Parcels são substituídos ou apagados.

Suponha que fez deploy da sua scene A em duas parcelas [100, 100] e [100, 101]. Depois vende a parcela [100, 101] a um utilizador que possui terreno adjacente e que faz deploy de uma scene grande (B) em várias parcelas, incluindo [100, 101].

A sua scene A não pode ser renderizada parcialmente num único Parcel, por isso [100, 100] não mostrará qualquer conteúdo. Tem de construir uma nova versão da scene A que ocupe apenas um Parcel e fazer deploy apenas nesse Parcel. [100, 100].

Publicar em terreno concedido

Se estiver a publicar em terreno pertencente à Decentraland Foundation que lhe foi concedido através de um grant, clique normalmente no botão Publicar e depois selecione Publicar para um server diferente na parte inferior. Depois selecione Custom Server no dropdown e introduza o seguinte endereço do server: https://linker-server.decentraland.org.

Servers personalizados

Pode fazer deploy de conteúdo para um server personalizado que não pertence à rede oficial de catalyst servers gerida pela DAO. Para fazer isto, não precisa de possuir quaisquer tokens LAND ou NAME, pois pode configurar o server para usar qualquer lógica de validação que prefira para controlar quem pode fazer deploy e onde. Os servers personalizados podem optar por ter conteúdo dos servers oficiais, que pode substituir, ou começar do zero e publicar conteúdo totalmente novo.

Para publicar num server personalizado, clique no Publicar e depois selecione Publicar para um server diferente na parte inferior. Depois selecione Custom Server no dropdown e introduza o endereço do server.

Consulte Como executar o seu próprio Catalyst Node para mais informações sobre o que pode fazer com o seu próprio server e como o configurar.

Os jogadores nunca são direcionados para este server; a única forma de aceder é escrever explicitamente o URL para se ligar a ele.

Verificar o sucesso do deploy

Depois de fazer deploy da sua scene, estas alterações levarão alguns minutos a propagar-se por todos os vários content servers da network. Se entrar em Decentraland logo após fazer deploy, ainda poderá ver a versão anterior do seu conteúdo, ou os modelos 3D podem estar completamente em falta.

O Creator Hub mostra o progresso da publicação à medida que esta passa pelas etapas de Carregamento, Conversão e Otimização e mostra um Jump In botão assim que a scene fica jogável.

Para verificar como a nova versão do seu conteúdo se propaga através dos servers que compõem a rede de conteúdo da Decentraland, pode usar o catalyst monitor screen. Cada um destes servers refere-se a um realm diferente.

Verificar o estado da conversão

Enquanto os modelos 3D de uma nova versão estão a ser convertidos, os jogadores recebem deliberadamente a última versão totalmente funcional da sua scene. Pode consultar o estado da conversão diretamente num browser:

  • https://asset-bundle-registry.decentraland.org/entities/status/<pointer>: substitua <pointer> por uma das coordenadas da sua scene (por exemplo 20,-34) ou com o ID da entity do deployment. A resposta mostra o estado da conversão para cada plataforma em assetBundles, e o estado dos LODs em lods. Quando complete é true, a scene está totalmente convertida para todas as plataformas. Para uma scene num World, adicione o nome do World como um parâmetro de query, por exemplo .../entities/status/0,0?world_name=myname.dcl.eth.

  • https://asset-bundle-registry.decentraland.org/queues/status: lista os IDs de todas as scenes que estão atualmente à espera de ser convertidas, por plataforma. Se o seu ID de entity aparecer aqui, a sua scene está em fila atrás de outras conversões e só precisa de esperar.

Atualizado