Migrar cenas legadas do SDK6

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

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

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

npx skills add decentraland/sdk-skills

Para mais detalhes sobre que skills estão disponíveis e como funcionam, veja Vibe Coding com IA.

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.

💡 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.

Próximos passos

• Vibe Coding com IA — Referência completa para trabalhar com assistentes de IA e SDK Skills.

• SDK Quick Start — Aprenda os fundamentos do SDK7 para poder rever e refinar o código migrado.