> 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/scene-editor/expandir-com-codigo/overview.md).

# Combine com código

Combine conteúdo criado no Scene Editor com o poder de escrever código.

{% embed url="<https://www.youtube.com/watch?v=55H37rygD7M>" %}

O Creator Hub e o código personalizado formam uma combinação muito poderosa para criar conteúdo. Pode usar o canvas para posicionar itens visualmente e de forma intuitiva e, em seguida, escrever código que interaja com esses itens com total liberdade. Pode até colocar um smart item, que tem o seu próprio comportamento predefinido, e escrever código que reaja à ativação do item.

Por exemplo, pode tirar partido de um smart item de alavanca existente, que já inclui sons, animações e estados, e escrever código que detete quando a alavanca é puxada para executar a sua própria lógica personalizada.

Consulte [Referenciar itens no código](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/reference-items.md) para saber como obter itens pelo nome ou por etiquetas a partir do seu código.

## Editar código

Tem de instalar um editor de código no seu computador para editar o código da sua Scene. As opções recomendadas são:

* <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-38ec445a6fa4d8c8b4e5f5c7b80ea1e58b35b6df%2Fvscode.webp?alt=media" alt="VS Code" data-size="line"> [Visual Studio Code](https://code.visualstudio.com/): esta é a opção recomendada para programadores experientes.
* <img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-96c78b13a696e8a70912e19e76551a23ec486a5b%2Fcursor-icon.webp?alt=media" alt="Cursor" data-size="line"> [Cursor AI](https://www.cursor.com/): este é um editor de código potente com IA integrada. Permite escolher diferentes modelos de IA para ajudar a escrever código; existe um plano gratuito, e os modelos mais avançados requerem um plano pago. É uma boa opção para programadores que estão a começar com Decentraland ou TypeScript, ou se quiser poupar tempo a escrever código.

{% hint style="warning" %}
**📔 Nota**: se utilizar macOS, certifique-se de que a aplicação do editor de código está na pasta Aplicações.
{% endhint %}

Depois de instalar o editor, poderá ter de o selecionar nas definições do Creator Hub. Para tal,

1. Clique no logótipo do Creator Hub, no canto superior esquerdo do ecrã, e selecione **Definições**.
2. Abra o separador **EDITOR** .
3. Em **Editor de código preferido**, selecione o seu editor de código. Poderá encontrá-lo na lista pendente ou talvez tenha de selecionar **Escolher no dispositivo...** para o localizar.

![A caixa de diálogo Preferências da aplicação, no separador EDITOR, mostra a lista pendente «Editor de código preferido» com Visual Studio Code selecionado.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f029dfd5bb1c2065716584e240489cba215873d8%2Fsettings-editor.webp?alt=media)

## Abrir o código de uma Scene

Depois de instalar um editor de código no seu computador e de o selecionar nas definições do Creator Hub, pode clicar no botão **< > CODE** para o abrir no projeto da sua Scene.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533a4b014b14355abfb053041727f76f80af1bf0%2Fcode-button.webp?alt=media)

Esta ação abre uma janela separada com o editor de código. Na margem esquerda, pode percorrer a estrutura de ficheiros e pastas do seu projeto.

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8edff2d8b3628c0a40ddc86186b306e09d36923a%2Ffiles-on-vs-studio.webp?alt=media)

Adicione o seu código personalizado ao ficheiro `index.ts` em `/src`, dentro da função `main()` . Em alternativa, pode adicionar código personalizado fora dessa função ou criar novos ficheiros `.ts` na pasta `/src` , mas estes têm de ser referenciados de alguma forma dentro da função `main()` de `index.ts`.

{% hint style="warning" %}
**📔 Nota**: se tiver o VS Code ou o Cursor instalado, mas o botão **CODE** não o abrir, talvez o VS Code não esteja configurado corretamente no seu computador para abrir através da linha de comandos. Na maioria dos casos, esta configuração é feita durante a instalação predefinida; caso contrário, consulte [estas instruções do VS](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line) para ativar o VS Code a partir da linha de comandos.
{% endhint %}

Se tiver uma janela de Preview aberta com a sua Scene, sempre que alterar o código nos seus ficheiros e guardar, a Scene é recarregada automaticamente com as alterações.

## Utilizar IA

O Creator Hub tem uma funcionalidade integrada [Assistente de IA](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/ai-assistant.md) que vê a cena aberta e a edita por si, sem ter de sair da aplicação. É uma funcionalidade experimental, desativada por predefinição.

Também pode recorrer a assistentes de IA, como o Cursor ou o Claude Code, para ajudar a escrever o código da cena. Por exemplo, para usar o Cursor, faça o seguinte:

1. Abra o assistente de IA do Cursor clicando no botão **IA** no canto superior direito do ecrã
2. Aí, pode pedir ao assistente de IA que o ajude a escrever código. Os seus pedidos podem incluir links para páginas da documentação, caminhos para ficheiros específicos do projeto ou até imagens. Também pode selecionar um modelo específico no menu pendente.

Para dar contexto do Decentraland ao seu assistente de IA, instale as SDK Skills oficiais do Decentraland. São conjuntos de instruções prontos a usar, mantidos pela Decentraland Foundation, que ensinam ao seu agente de IA padrões verificados do SDK7 para todos os tópicos: criar a estrutura de cenas completas, adicionar modelos 3D, multijogador, implementação e muito mais.

```bash
npx skills add decentraland/sdk-skills
```

Consulte [Vibe Coding com IA](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) para ver o guia completo, incluindo a lista completa de skills disponíveis.

{% hint style="warning" %}
**📔 Nota**: projetos de cenas mais antigos podem conter uma pasta `/dclcontext` transferida através do comando obsoleto `npx sdk-commands get-context-files` . Esse contexto já não é mantido e foi substituído pelas SDK Skills. Pode eliminar a pasta sem problemas.
{% endhint %}

## Controlo de versões

Recomendamos que crie um repositório para o seu projeto no GitHub e o utilize para acompanhar as versões do projeto e colaborar com outras pessoas.

Se não sabe bem como fazê-lo, consulte [Início rápido para repositórios](https://docs.github.com/en/repositories/creating-and-managing-repositories/quickstart-for-repositories), ou utilize a [aplicação de ambiente de trabalho do GitHub](https://desktop.github.com/download/) para um processo mais simples, baseado na UI.

{% hint style="warning" %}
**📔 Nota**: carregue a pasta completa do projeto para um repositório do GitHub, mas certifique-se de que as pastas `/node_modules` ou `/bin` e o ficheiro `package-lock.json` estão incluídos no ficheiro `.gitignore` , para evitar sincronizá-los. Isto deverá acontecer se configurar o repositório como sendo do tipo `node`. Estes ficheiros são gerados automaticamente e o conteúdo pode variar entre máquinas.
{% endhint %}

## Ver também

* [Vibe Coding com IA](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md): crie cenas descrevendo o que pretende a um assistente de IA.
* [Smart items - Noções básicas](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md)
* [Smart items - Avançado](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md)
* [Estados e condições](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md)
* [Tornar qualquer item inteligente](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md)
* [Início rápido do SDK](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/sdk-101.md): siga este breve tutorial para uma introdução rápida.
* [Fluxo de trabalho de desenvolvimento](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/primeiros-passos/dev-workflow.md): leia isto para compreender todo o processo de criação de cenas.
* [Exemplos](https://docs.decentraland.org/creator/content-creator-pt/tutoriais-e-exemplos/examples.md): explore diretamente cenas de exemplo funcionais.


---

# 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/scene-editor/expandir-com-codigo/overview.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.
