> 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 o SDK7 usando um assistente de IA. Se você tem uma cena antiga do SDK6 que gostaria de atualizar, pode migrá-la automaticamente para SDK7 com a ajuda de um assistente de IA. As [Decentraland SDK Skills](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/vibe-coding.md#install-skills-for-any-ai-agent) incluem um fluxo de migração dedicado que a IA segue passo a passo, para que você não precise traduzir o código manualmente. Este guia orienta você por todo o processo. ## 1. Crie uma nova cena SDK7 vazia Comece com um projeto SDK7 novo e vazio. A IA moverá seu código legado e assets para essa estrutura limpa. **Opção A — Creator Hub** 1. Abra o Creator Hub. 2. Selecione a aba **Scenes** aba e clique em **New 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 ``` Isso preenche a pasta com os ficheiros padrão de um projeto SDK7. ## 2. Instale os SDK Skills Os SDK Skills ensinam o seu agente de IA a trabalhar com o Decentraland SDK7, incluindo como realizar uma migração adequada do SDK6 → SDK7. Pode instalá-los de duas formas. **Opção A — Peça à IA para os instalar** Abra o seu assistente de IA na pasta da cena e simplesmente diga: > Instale as SDK Skills do Decentraland. A IA conhece o comando e irá instalá-las para si. **Opção B — Instalar pela linha de comando** ```bash npx skills add decentraland/sdk-skills --all ``` O `--all` A flag --all instala todas as skills disponíveis. Se a omitir, abre-se um seletor interativo para escolher quais skills instalar. Para mais detalhes sobre quais skills estão disponíveis e como funcionam, consulte [Vibe Coding com IA](/creator/content-creator-pt/scenes-sdk7/primeiros-passos/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 em algum lugar que a IA possa ler — por exemplo, numa pasta separada na sua máquina ou num repositório público no GitHub. Depois, dê à IA o seguinte prompt: > Migre esta cena SDK6 para SDK7. As skills incluem o manual completo de migração, portanto a IA irá: * Identificar o ponto de entrada e os components usados na cena SDK6. * Converter entities, components e systems para os respetivos equivalentes em SDK7. * Mover os 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. Teste e itere Quando a passagem de migração terminar, faça Preview da cena e jogue-a. * No Creator Hub, clique em **Play**. * Na linha de comando, execute `npm run start`. À medida que testa, procure: * Problemas visuais — modelos em falta, posições ou escalas erradas, materiais quebrados. * 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 sua cena os usava. * 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. Antes tocava um som e rodava a porta 90 graus. A IA pode usar as skills relacionadas (interatividade, animations, áudio, 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 regressões quando as alterações são pequenas. {% endhint %} ## Próximos passos * [Vibe Coding com IA](/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) — 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 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/outros/migrate-legacy-sdk6-scenes.md?ask=&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.