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

# Migrar scenes legadas do SDK6

Se tiver uma cena antiga do SDK6 que gostava de atualizar, pode migrá-la automaticamente para SDK7 com a ajuda de um assistente de IA. O [Decentraland SDK Skills](/creator/content-creator-pt/scenes-sdk7/comecar/vibe-coding.md#install-skills-for-any-ai-agent) inclui um fluxo de trabalho de migração dedicado que a IA segue passo a passo, para que não tenha de traduzir o código manualmente.

Este guia acompanha-o por todo o processo.

## 1. Criar uma nova cena vazia SDK7

Comece com um projeto SDK7 novo e vazio. A IA irá տեղափոխar o seu código e os seus assets antigos para esta estrutura limpa.

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

1. Abra o Creator Hub.
2. Selecione o **Scenes** separador e clique em **Create Scene**.
3. Escolha o **Empty Scene** template.

**Opção B — Linha de comando**

Execute 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 o SDK Skills

O SDK Skills ensina o seu agente de IA a trabalhar com o Decentraland SDK7, incluindo como realizar uma migração correta de SDK6 → SDK7.

Pode instalá-lo de duas formas.

**Opção A — Peça à IA para o instalar**

Abra o seu assistente de IA na pasta da cena e simplesmente diga:

> Instala o Decentraland SDK skills.

A IA conhece o comando e irá instalá-lo por si.

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

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

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

## 3. Peça à IA para migrar a cena

Coloque os ficheiros do seu projeto legado SDK6 num local que a IA possa ler — por exemplo, numa pasta separada no seu computador ou num repositório público no GitHub.

Depois, dê o seguinte prompt à IA:

> Migra esta cena SDK6 para SDK7.

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

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

## 4. Testar e iterar

Quando a passagem de migração terminar, faça preview da cena e interaja com ela.

* No Creator Hub, clique em **Preview**.
* Na linha de comando, execute `npm run start`.

Enquanto testa, procure:

* Problemas visuais — modelos em falta, posições ou escalas incorretas, materials danificados.
* Problemas de interação — clicks que não funcionam, triggers que não ativam, diálogos que não aparecem.
* Problemas de multiplayer ou networking, se a sua cena os utilizava.
* Erros de console na janela de preview.

Quando encontrar um bug, descreva-o à IA em linguagem simples:

> O botão vermelho na mesa já não abre a porta. Costumava reproduzir um som e rodar a porta 90 graus.

A IA pode usar as skills adjacentes (interactivity, animations, audio, etc.) para corrigir os problemas um a um. Itere até a cena se comportar como a original.

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

## Próximos passos

* [Vibe Coding com IA](/creator/content-creator-pt/scenes-sdk7/comecar/vibe-coding.md) — Referência completa para trabalhar com assistentes de IA e SDK Skills.
* [SDK Quick Start](/creator/content-creator-pt/scenes-sdk7/comecar/sdk-101.md) — Aprenda os fundamentos do SDK7 para poder 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:

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

The question should be specific, self-contained, and written in natural language.
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.