Migrar escenas heredadas de SDK6

Migra una escena heredada de SDK6 a SDK7 usando un asistente de IA.

Si tienes una escena antigua de SDK6 que te gustaría poner al día, puedes migrarla a SDK7 automáticamente con la ayuda de un asistente de IA. Las Decentraland SDK Skills incluyen un flujo de trabajo de migración dedicado que la IA sigue paso a paso, así que no tienes que traducir el código a mano.

Esta guía te lleva por todo el proceso.

1. Crea una nueva escena vacía de SDK7

Empieza con un proyecto SDK7 nuevo y vacío. La IA moverá tu código y assets heredados a esta estructura limpia.

Opción A — Creator Hub

1. Abre Creator Hub.

2. Selecciona la Scenes pestaña y haz clic en New Scene.

3. Elige la Empty Scene plantilla.

Opción B — Línea de comandos

Ejecuta lo siguiente en una carpeta vacía:

npx @dcl/sdk-commands init

Esto llena la carpeta con los archivos predeterminados de un proyecto SDK7.

2. Instala las SDK Skills

Las SDK Skills enseñan a tu agente de IA cómo trabajar con Decentraland SDK7, incluyendo cómo realizar una migración adecuada de SDK6 → SDK7.

Puedes instalarlas de dos maneras.

Opción A — Pídele a la IA que las instale

Abre tu asistente de IA en la carpeta de la escena y simplemente di:

Instala las Decentraland SDK Skills.

La IA conoce el comando y las instalará por ti.

Opción B — Instalar desde la línea de comandos

npx skills add decentraland/sdk-skills --all

La --all bandera instala todas las skills disponibles. Si la omites, se abre un selector interactivo para elegir qué skills instalar.

Para más detalles sobre qué skills están disponibles y cómo funcionan, consulta Vibe Coding con IA.

3. Pídele a la IA que migre la escena

Coloca los archivos de tu proyecto SDK6 heredado en algún lugar que la IA pueda leer, por ejemplo en una carpeta separada de tu máquina o en un repositorio público de GitHub.

Luego dile a la IA:

Migra esta escena de SDK6 a SDK7.

Las skills incluyen el playbook completo de migración, así que la IA:

• Identificará el entry point y los components usados en la escena de SDK6.

• Traducirá entities, components y systems a sus equivalentes de SDK7.

• Moverá los modelos 3D, el audio y otros assets al nuevo proyecto.

• Actualiza scene.json y la configuración del proyecto.

• Sustituye las APIs obsoletas por sus equivalentes actuales de SDK7.

4. Prueba e itera

Una vez que termine la pasada de migración, previsualiza la escena y recórrela.

• En Creator Hub, haz clic en Preview.

• Desde la línea de comandos, ejecuta npm run start.

Mientras pruebas, busca:

• Problemas visuales — modelos faltantes, posiciones o escalas incorrectas, materiales rotos.

• Problemas de interacción — clics que no se disparan, triggers que no se activan, diálogos que no aparecen.

• Problemas de Multiplayer o de networking, si tu escena los usaba.

• Errores de consola en la ventana de Preview.

Cuando encuentres un bug, descríbelo a la IA en lenguaje claro:

El botón rojo de la mesa ya no abre la puerta. Antes reproducía un sonido y rotaba la puerta 90 grados.

La IA puede usar las skills circundantes (interactividad, animations, audio, etc.) para corregir los problemas uno por uno. Itera hasta que la escena se comporte como la original.

💡 Consejo: Corrige un bug a la vez y previsualiza después de cada cambio. Es mucho más fácil detectar regresiones cuando los cambios son pequeños.

Siguientes pasos

• Vibe Coding con IA — Referencia completa para trabajar con asistentes de IA y SDK Skills.

• Inicio rápido de SDK — Aprende los fundamentos de SDK7 para que puedas revisar y refinar el código migrado.