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

Fluxo de Trabalho de Desenvolvimento

Fluxo de trabalho recomendado para criar uma scene do Decentraland com o Creator Hub, da ideação até os testes e a publicação.

Este documento descreve os passos recomendados para desenvolver uma cena para Decentraland, desde a conceção até à publicação e além.

Como posso criar uma cena de Decentraland?

  1. Instale o Creator Hub, a aplicação oficial para computador para criar, pré-visualizar e publicar cenas. É a ferramenta recomendada para criadores de todos os níveis de experiência.

  2. Se utilizar um assistente de programação com IA (como Claude Code, Cursor ou Copilot), instale o Decentraland SDK Skills oficial para que conheça os padrões verificados do SDK7: npx skills add decentraland/sdk-skills

  3. A CLI é uma alternativa para utilizadores avançados e fluxos de trabalho automatizados.

As secções abaixo aprofundam cada etapa deste fluxo de trabalho.

Instalar o Creator Hub

Certifique-se de que tem o Decentraland Creator Hub instalado.

Se pretende trabalhar com código, certifique-se também de que instala o Visual Studio Code ou o Cursor AI.

💡 Dica: também pode usar assistentes de IA para gerar código de cenas a partir de descrições em linguagem natural. Consulte Programação intuitiva com IA para saber como começar a desenvolver com a ajuda da IA.

Conceber a sua experiência

Pense no espaço de que precisa, no tipo de distribuição, nas mecânicas que quer que os jogadores possam executar, etc. Os documentos seguintes podem servir de guia:

Onde publicar

Em Decentraland, o conteúdo é publicado em parcelas de terreno adjacentes, num espaço limitado. Os jogadores podem deslocar-se livremente de uma parcela para outra. Cada cena é um pequeno mundo autónomo: os elementos de uma cena não podem estender-se a outra, e o código de cada cena está isolado dos restantes.

A permissão para publicar em cada uma destas parcelas é controlada por tokens. Não precisa de terreno para desenvolver uma cena, mas precisará de acesso a terreno quando estiver pronto para publicar.

Em alternativa, pode publicar em Worldsde Decentraland, que são cenas autónomas e isoladas.

Estão disponíveis as seguintes opções:

  • Alugar LAND

  • Comprar LAND

  • Obter autorização de um proprietário de terreno

  • Publicar num World de Decentraland. Consulte Worlds para saber mais.

Consulte Opções de publicação para mais informações.

Modelos e exemplos

Ao criar uma cena, pode escolher entre vários modelos base que incluem código e modelos 3D básicos. Utilize-os para começar mais rapidamente.

  • Cenas de exemplo: aqui pode encontrar uma coleção selecionada de cenas e repositórios funcionais, cada um com mecânicas que pode reutilizar ou consultar como referência.

  • Bibliotecas auxiliares: podem simplificar muitas tarefas comuns.

Recursos artísticos

Se for um artista experiente ou tiver acesso a alguém que o seja, pode criar modelos personalizados .gltf ou .glb para a sua cena. Consulte Fundamentos dos modelos 3D para obter dicas sobre como criar modelos 3D para Decentraland.

No entanto, não precisa de criar os seus próprios recursos. Consulte Recursos úteis para bibliotecas de recursos e ferramentas de IA generativa que pode usar para obter modelos 3D, bem como outras ferramentas que podem acelerar o seu fluxo de trabalho.

Executar uma pré-visualização local

Para pré-visualizar a sua scene, abra-a no Creator Hub e clique no botão Play . Em alternativa, se estiver a trabalhar na linha de comandos, execute npm run start na pasta raiz do seu projeto.

  • Pré-visualizar a sua scene para obter mais detalhes.

  • Consulte Depurar uma scene para obter dicas sobre como depurar eventuais problemas.

  • O Desktop Explorer pré-visualiza os seus modelos 3D como pacotes de recursos otimizados, convertidos no seu computador, para que a pré-visualização seja mais fluida e os modelos tenham exatamente o mesmo aspeto que terão depois de publicados. Consulte Pré-visualizar com recursos otimizados.

💡 Dica: Ao usar o Creator Hub, sempre que faz uma alteração na sua scene, a pré-visualização é atualizada automaticamente, mesmo enquanto está em execução.

Publicar na Decentraland

Quando estiver satisfeito com a sua scene, é altura de a publicar na Decentraland. Para isso, precisa de possuir LAND, um NAME da Decentraland ou um nome ETH ENS, ou de ter autorização concedida por alguém que possua um desses itens.

Consulte a publicação para obter instruções sobre como o fazer.

Em alternativa, pode publicar em Worlds, um espaço 3D pessoal que não requer LAND.

Promover

Agora que a sua scene está disponível, divulgue-a! Aqui ficam algumas formas de o fazer:

  • Partilhe-a nas redes sociais (#DCL)

  • Anuncie-a no Discord

  • Envie-a para ser destacada em events.decentraland.org

  • Organize um evento na sua scene

  • Adicione um spawn point numa zona movimentada que tenha uma ligação para a sua scene

Iterar

Quando a sua scene estiver disponível há algum tempo e tiver recebido feedback dos jogadores, estará numa ótima posição para iterar sobre ela!

Atualize o seu conteúdo com melhorias e novas funcionalidades, implementando novas versões da sua scene nas mesmas coordenadas.

Contribuir para a comunidade

Se criar uma scene, um jogo ou uma aplicação de que se orgulha, considere torná-la open source! Assim, outras pessoas poderão aprender com o seu código e desenvolver o seu trabalho. Também pode partilhar o projeto completo em Awesome Repository.

Se criar uma funcionalidade reutilizável, pode transformá-la numa biblioteca que outras pessoas possam importar para os seus projetos.

Atualizado