> For the complete documentation index, see [llms.txt](https://docs.decentraland.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/dev-workflow.md).

# 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**](https://decentraland.org/download/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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) oficial para que conheça os padrões verificados do SDK7: `npx skills add decentraland/sdk-skills`
3. **A** [**CLI**](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/using-the-cli.md) é 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.

* [Guia de instalação](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/editor-installation.md)

Se pretende trabalhar com código, certifique-se também de que instala o [Visual Studio Code](https://code.visualstudio.com/) ou o [Cursor AI](https://www.cursor.com/).

{% hint style="info" %}
**💡 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) para saber como começar a desenvolver com a ajuda da IA.
{% endhint %}

## 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:

* [Guia de UX e UI](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/conceber-a-experiencia/ux-ui-guide.md)
* [Restrições de conceção para jogos](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/conceber-a-experiencia/design-games.md)
* [Diretrizes para o MVP de cenas](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/conceber-a-experiencia/mvp-guidelines.md)

## 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 [Worlds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds)de 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-worlds) para saber mais.

Consulte [Opções de publicação](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md) 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](https://docs.decentraland.org/creator/content-creator-pt/tutoriais-e-exemplos/examples.md): 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](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library): 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](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/3d-models.md) 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/useful-resources.md) 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md) para obter mais detalhes.
* Consulte [Depurar uma scene](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/depuracao/debug-in-preview.md) 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/preview-scene.md#preview-with-optimized-assets).

{% hint style="info" %}
**💡 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.
{% endhint %}

## 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](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing.md) para obter instruções sobre como o fazer.

Em alternativa, pode publicar em [Worlds](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/publicacao/publishing-options.md#decentraland-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](https://dcl.gg/discord)
* Envie-a para ser destacada em [events.decentraland.org](https://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](https://github.com/decentraland-scenes/Awesome-Repository).

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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/dev-workflow.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
