> 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-es/scene-editor/extender-con-codigo/overview.md).

# Combinar con código

Combina el contenido creado en el Scene Editor con la potencia de escribir código.

{% embed url="<https://www.youtube.com/watch?v=55H37rygD7M>" %}

Creator Hub y el código personalizado forman una combinación muy potente para crear contenido. Puedes usar el Canvas para colocar elementos visualmente de forma intuitiva y, después, escribir código que interactúe con ellos con total libertad. Incluso puedes colocar un Smart item, que ya tiene su propio comportamiento predeterminado, y escribir código que reaccione cuando se active el elemento.

Por ejemplo, puedes aprovechar un Smart item de palanca existente, que ya incluye sonidos, animaciones y estados, y escribir código que detecte cuándo se tira de la palanca para ejecutar tu propia lógica personalizada.

Consulta [Referenciar elementos en el código](https://docs.decentraland.org/creator/content-creator-es/scene-editor/extender-con-codigo/reference-items.md) para saber cómo obtener elementos por nombre o por etiquetas desde tu código.

## Editar código

Debes instalar un editor de código en tu equipo para editar el código de tu Scene. Las opciones recomendadas son:

* <img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-38ec445a6fa4d8c8b4e5f5c7b80ea1e58b35b6df%2Fvscode.webp?alt=media" alt="VS Code" data-size="line"> [Visual Studio Code](https://code.visualstudio.com/): Es la opción recomendada para desarrolladores con experiencia.
* <img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-96c78b13a696e8a70912e19e76551a23ec486a5b%2Fcursor-icon.webp?alt=media" alt="Cursor" data-size="line"> [Cursor AI](https://www.cursor.com/): Es un potente editor de código integrado con IA. Te permite elegir distintos modelos de IA para ayudarte a escribir código; hay un plan gratuito y los modelos más avanzados requieren un plan de pago. Es una buena opción para quienes recién comienzan a desarrollar con Decentraland o TypeScript, o si quieres ahorrar tiempo al escribir código.

{% hint style="warning" %}
**📔 Nota**: Si usas macOS, asegúrate de que la aplicación del editor de código esté en la carpeta Aplicaciones.
{% endhint %}

Una vez instalado, quizá tengas que seleccionar tu editor de código en la configuración de Creator Hub. Para hacerlo,

1. Haz clic en el logotipo de Creator Hub, en la esquina superior izquierda de la pantalla, y selecciona **Configuración**.
2. Abre la pestaña **EDITOR** .
3. En **Editor de código preferido**, selecciona tu editor de código. Puede que aparezca en el menú desplegable o que tengas que seleccionar **Elegir desde tu dispositivo...** para encontrarlo.

![El cuadro de diálogo Preferencias de la aplicación, en la pestaña EDITOR, muestra el menú desplegable Editor de código preferido con Visual Studio Code seleccionado.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f029dfd5bb1c2065716584e240489cba215873d8%2Fsettings-editor.webp?alt=media)

## Abrir el código de una Scene

Una vez que hayas instalado un editor de código en tu equipo y lo hayas seleccionado en la configuración de Creator Hub, puedes hacer clic en el botón **< > CODE** para abrir el proyecto de tu Scene.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533a4b014b14355abfb053041727f76f80af1bf0%2Fcode-button.webp?alt=media)

Se abrirá una ventana aparte con el editor de código. En el margen izquierdo puedes explorar los archivos y la estructura de carpetas de tu proyecto.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8edff2d8b3628c0a40ddc86186b306e09d36923a%2Ffiles-on-vs-studio.webp?alt=media)

Añade tu código personalizado al archivo `index.ts` dentro de `/src`, en la función `main()` . También puedes añadir código personalizado fuera de esa función o crear nuevos archivos `.ts` dentro de la carpeta `/src` , pero de algún modo tendrás que hacer referencia a ellos dentro de la función `main()` de `index.ts`.

{% hint style="warning" %}
**📔 Nota**: Si tienes VS Code o Cursor instalado, pero al hacer clic en el botón **CODE** no se abre, es posible que VS Code no esté configurado correctamente en tu equipo para abrirse desde la línea de comandos. En la mayoría de los casos, esto se configura durante la instalación predeterminada, pero si no es así, consulta [estas instrucciones de VS](https://code.visualstudio.com/docs/setup/mac#_launching-from-the-command-line) para habilitar VS Code desde la línea de comandos.
{% endhint %}

Si tienes abierta una ventana de Preview con tu Scene en ejecución, cada vez que cambies el código de tus archivos y los guardes, la Scene se volverá a cargar automáticamente con los cambios.

## Usar IA

Creator Hub incluye una función integrada [Asistente de IA](https://docs.decentraland.org/creator/content-creator-es/scene-editor/extender-con-codigo/ai-assistant.md) que ve la escena que tienes abierta y la edita por ti, sin que tengas que salir de la aplicación. Es una función experimental y está desactivada de forma predeterminada.

También puedes aprovechar asistentes de IA como Cursor o Claude Code para que te ayuden a escribir código para escenas. Por ejemplo, para usar Cursor, haz lo siguiente:

1. Abre el asistente de IA de Cursor haciendo clic en el botón **IA** en la esquina superior derecha de la pantalla
2. Desde allí, puedes pedirle al asistente de IA que te ayude a escribir código. Tus indicaciones pueden incluir enlaces a páginas de documentación, rutas a archivos específicos de tu proyecto o incluso imágenes. También puedes seleccionar el modelo que quieras usar en el menú desplegable.

Para dar contexto de Decentraland a tu asistente de IA, instala las Skills oficiales del SDK de Decentraland. Son conjuntos de instrucciones listos para usar, mantenidos por la Decentraland Foundation, que enseñan a tu agente de IA patrones verificados de SDK7 para todos los temas: desde crear la estructura de escenas completas y añadir modelos 3D hasta el modo multijugador, el despliegue y mucho más.

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

Consulta [Programación creativa con IA](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md) para ver la guía completa, incluida la lista íntegra de Skills disponibles.

{% hint style="warning" %}
**📔 Nota**: Los proyectos de escenas más antiguos pueden contener una carpeta `/dclcontext` descargada mediante el comando obsoleto `npx sdk-commands get-context-files` . Ese contexto ya no se mantiene y ha sido reemplazado por las SDK Skills. Puedes eliminar la carpeta sin problema.
{% endhint %}

## Control de versiones

Te recomendamos crear un repositorio para tu proyecto en GitHub y usarlo para llevar un registro de las versiones del proyecto y colaborar con otras personas.

Si no sabes cómo hacerlo, consulta [Guía de inicio rápido para repositorios](https://docs.github.com/en/repositories/creating-and-managing-repositories/quickstart-for-repositories), o usa la [aplicación de escritorio de GitHub](https://desktop.github.com/download/) para seguir un proceso más sencillo basado en una interfaz de usuario.

{% hint style="warning" %}
**📔 Nota**: Sube la carpeta completa del proyecto a un repositorio de GitHub, pero asegúrate de incluir las carpetas `/node_modules` y `/bin` y el archivo `package-lock.json` en el archivo `.gitignore` para evitar que se sincronicen. Esto debería ocurrir si configuras el repositorio con el tipo `node`. Todos estos archivos se generan automáticamente y su contenido puede variar según el equipo.
{% endhint %}

## Consulta también

* [Programación creativa con IA](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/vibe-coding.md): crea escenas describiendo lo que quieres a un asistente de IA.
* [Smart items: conceptos básicos](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/smart-items.md)
* [Smart items: conceptos avanzados](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/smart-items-advanced.md)
* [Estados y condiciones](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/states-and-conditions.md)
* [Cómo convertir cualquier elemento en un elemento inteligente](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/make-any-item-smart.md)
* [Inicio rápido del SDK](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/sdk-101.md): sigue este breve tutorial para obtener una introducción rápida.
* [Flujo de trabajo de desarrollo](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/dev-workflow.md): lee esto para comprender el proceso completo de creación de escenas.
* [Ejemplos](https://docs.decentraland.org/creator/content-creator-es/tutoriales-y-ejemplos/examples.md): explora directamente escenas de ejemplo funcionales.


---

# 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-es/scene-editor/extender-con-codigo/overview.md?ask=<question>&goal=<user_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.
