> 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/outros/migrate-legacy-sdk6-scenes.md).

# Migrar Scenes Legadas do SDK6

Migre uma scene legada do SDK6 para SDK7 usando um assistente de IA.

Se tiveres uma scene SDK6 antiga que gostarias de atualizar, podes migrá-la automaticamente para SDK7 com a ajuda de um assistente de IA. A [Decentraland SDK Skills](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md#install-skills-for-any-ai-agent) incluem um fluxo de trabalho de migração dedicado que a IA segue passo a passo, para que não tenhas de traduzir o código manualmente.

Este guia orienta-te ao longo de todo o processo.

## 1. Cria uma nova scene SDK7 vazia

Começa com um projeto SDK7 novo e vazio. A IA irá mover o teu código legado e os teus assets para esta estrutura limpa.

**Opção A — Creator Hub**

1. Abre o Creator Hub.
2. Seleciona o **Scenes** separador e clica em **New Scene**.
3. Escolhe o **Empty Scene** template.

**Opção B — linha de comandos**

Executa o seguinte numa pasta vazia:

```bash
npx @dcl/sdk-commands init
```

Isto preenche a pasta com os ficheiros predefinidos de um projeto SDK7.

## 2. Instalar as SDK Skills

As SDK Skills ensinam o teu agente de IA a trabalhar com o Decentraland SDK7, incluindo como realizar uma migração adequada de SDK6 → SDK7.

Podes instalá-las de duas formas.

**Opção A — Pede à IA para as instalar**

Abre o teu assistente de IA na pasta da scene e diz simplesmente:

> Instala as Decentraland SDK skills.

A IA conhece o comando e irá instalá-las por ti.

**Opção B — Instalar pela linha de comandos**

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

A `--all` flag instala todas as skills disponíveis. Se o omitires, abre-se um seletor interativo para escolheres quais skills instalar.

Para mais detalhes sobre que skills estão disponíveis e como funcionam, consulta [Vibe Coding with AI](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md#install-skills-for-any-ai-agent).

## 3. Pede à IA para migrar a scene

Coloca os ficheiros do teu projeto legado SDK6 algures onde a IA os possa ler — por exemplo, numa pasta separada no teu computador ou num repositório público no GitHub.

Depois, pede à IA:

> Migra esta scene SDK6 para SDK7.

As skills incluem o playbook completo de migração, por isso a IA irá:

* Identificar o ponto de entrada e os components usados na scene SDK6.
* Traduzir entities, components e systems para os respetivos equivalentes em SDK7.
* Mover modelos 3D, áudio e outros assets para o novo projeto.
* Atualizar `scene.json` e a configuração do projeto.
* Substituir APIs descontinuadas pelos respetivos equivalentes atuais em SDK7.

## 4. Testa e itera

Quando a passagem de migração terminar, faz preview da scene e percorre-a.

* No Creator Hub, clica em **Preview**.
* Na linha de comandos, executa `npm run start`.

Enquanto testas, procura:

* Problemas visuais — modelos em falta, posições ou escalas incorretas, Materials corrompidos.
* Problemas de interação — cliques que não disparam, triggers que não ativam, diálogos que não aparecem.
* Problemas de Multiplayer ou networking, se a tua scene os tiver usado.
* Erros de console na janela de preview.

Quando encontrares um bug, descreve-o à IA em linguagem simples:

> O botão vermelho na mesa já não abre a porta. Antes, reproduzia um som e rodava a porta 90 graus.

A IA pode usar as skills circundantes (interatividade, animations, audio, etc.) para corrigir os problemas um a um. Itera até a scene se comportar como a original.

{% hint style="info" %}
**💡 Dica**: Corrige um bug de cada vez e faz preview após cada alteração. É muito mais fácil detetar regressões quando as mudanças são pequenas.
{% endhint %}

## Próximos passos

* [Vibe Coding with AI](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md) — Referência completa para trabalhar com assistentes de IA e SDK Skills.
* [Início rápido do SDK](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/sdk-101.md) — Aprende os fundamentos do SDK7 para poderes rever e refinar o código migrado.


---

# 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/outros/migrate-legacy-sdk6-scenes.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.