> 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/scenes-sdk7/tipos-de-proyectos/scene-files.md).

# Archivos de escena

Archivos predeterminados creados en una escena nueva.

Después de [crear una escena nueva](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/primeros-pasos/sdk-101.md), la carpeta de la escena tendrá una serie de archivos con contenido predeterminado.

## Archivos predeterminados de una escena

Las escenas incluyen los siguientes archivos:

* **src/index.ts**: El punto de entrada de la escena.
* **scene.json**: El manifiesto que contiene metadatos de la escena.
* **package.json** y **package-lock.json**: Especifican las versiones de todas las dependencias de la escena.
* **tsconfig.json**: Archivo de configuración de TypeScript.
* **.dclignore**: Enumera los archivos de tu proyecto que no se subirán al publicar la escena.
* **assets/scene/main.composite**: Archivo generado automáticamente que incluye todo lo que agregaste y configuraste visualmente en Scene Editor dentro de Creator Hub. No está pensado para que lo lean las personas. Es un ejemplo de un [composite](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/arquitectura/composites.md), un archivo que describe un árbol de entidades y componentes. Las escenas creadas mediante la CLI incluyen, en cambio, un archivo `main.crdt` en el directorio raíz.

### index.ts

Este es el punto de entrada del código personalizado de tu escena. Podrías incluir toda la lógica de la escena en este archivo, aunque, por claridad, en la mayoría de los casos recomendamos distribuir el código en varios otros archivos *.ts* .

Si solo usas Scene Editor y [Smart Items](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/smart-items.md), no tendrás que modificar este archivo.

Si tienes pensado escribir código personalizado, lo más probable es que solo necesites editar este y otros archivos .ts para crear tu escena. Contiene el código que genera las [entidades y los componentes](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/arquitectura/entities-components.md) y los [sistemas](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/arquitectura/systems.md) de tu escena.

Al ejecutar la escena, el contenido de tus archivos `.ts` se compila en un único archivo `.js` , `bin/index.js`. Al generar la versión de producción, este archivo también se minifica.

{% hint style="warning" %}
**📔 Nota**: Puedes usar otra herramienta o lenguaje en lugar de TypeScript, siempre que tus scripts estén incluidos en un único archivo JavaScript (bin/index.js). Todas las declaraciones de tipos proporcionadas están escritas en TypeScript, y los demás lenguajes y transpiladores no cuentan con soporte oficial.
{% endhint %}

### scene.json

El archivo *scene.json* es un manifiesto con formato JSON para una escena del mundo. Una escena puede ocupar una o varias parcelas LAND. El *scene.json* manifiesto describe qué objetos hay en la escena, enumera los recursos necesarios para renderizarla, incluye la información de contacto del propietario de la parcela y especifica los ajustes de seguridad.

La mayoría de los campos de *scene.json* El archivo se puede editar directamente en la UI del Scene Editor. Consulta [Configuración de la escena](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/scene-editor-essentials.md#scene-settings).

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-89beaa271602570a5f8e55d01517680b656d7135%2Fthumbnail-image.webp?alt=media)

Para obtener más información, consulta [los metadatos de la escena](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/tipos-de-proyectos/scene-metadata.md#metadata).

Todos estos metadatos son opcionales para previsualizar la escena localmente, pero algunos son necesarios para implementarla. Puedes cambiar esta información manualmente en cualquier momento.

### package.json

Este archivo proporciona información a NPM que le permite identificar el proyecto y gestionar sus dependencias. Las escenas de Decentraland requieren un paquete principal:

* **@dcl/sdk**: la dependencia fundamental del SDK de Decentraland, que incluye definiciones y tipos para el motor, los Components, los Systems, etc.
* **@dcl/js-runtime**: una serie de declaraciones de tipos que facilita la integración de @dcl/sdk.

Tu escena puede incluir cualquier cantidad de otros paquetes, por ejemplo, para incluir [librerías](https://studios.decentraland.org/resources?sdk_version=SDK7\&resource_type=Library) que pueden facilitar la escritura de código o habilitar funcionalidades especiales.

### package-lock.json

Este archivo enumera las versiones de todas las demás dependencias del proyecto. Estas versiones están fijadas, lo que significa que el compilador usará exactamente la misma versión menor que se indica aquí.

Puedes cambiar manualmente la versión de cualquier paquete editando este archivo.

### tsconfig.json

Los directorios que contienen un archivo *tsconfig.json* son directorios raíz de proyectos de TypeScript. El archivo *tsconfig.json* especifica los archivos raíz y las opciones necesarias para compilar tu proyecto de TypeScript a JavaScript.

Al instalar librerías adicionales en tu escena, se debería añadir automáticamente una entrada a este archivo. Para instalar librerías de utilidades de Decentraland, no debería ser necesario modificarlo manualmente.

## Ubicaciones recomendadas para los archivos

Ten en cuenta que, cuando implementes tu escena en Decentraland, los recursos o las librerías externas que necesite deben estar empaquetados en la carpeta de la escena o disponibles en un servidor remoto.

Todo lo que deba ejecutarse en el cliente del jugador debe estar dentro de la carpeta de la escena. No debes hacer referencia a archivos o librerías instalados en otra ubicación de tu equipo, porque no estarán disponibles en la escena implementada.

Te recomendamos usar estos nombres de carpetas de forma coherente para guardar los distintos tipos de recursos que pueda necesitar tu escena:

* Modelos 3D: `assets/scene/models`
* Videos: `assets/scene/videos`
* Archivos de sonido: `assets/scene/sounds`
* Archivos de imagen para texturas (excepto los modelos glTF): `assets/scene/materials`
* *.ts* definiciones de Components `/src/components`
* *.ts* definiciones de Systems `/src/systems`

{% hint style="warning" %}
**📔 Nota**: Los archivos de soporte para modelos glTF, como sus archivos de imagen de textura o los archivos *.bin* siempre deben colocarse en la misma carpeta que el modelo *.gltf* o *.glb* .
{% endhint %}

{% hint style="warning" %}
**📔 Nota**: Recomendamos usar siempre nombres en minúsculas para todas las carpetas y archivos, para evitar posibles problemas.
{% endhint %}

Al importar cualquier recurso mediante el Scene Editor, se añaden automáticamente dentro de la carpeta `assets/scene` Al usar cualquiera de los recursos predeterminados de los Asset Packs del Scene Editor, sus archivos se añaden a la carpeta `assets/builder` .

## El archivo dclignore

Todas las escenas incluyen un archivo *.dclignore* , que especifica qué archivos de la carpeta de la escena se deben ignorar al desplegar una escena en Decentraland.

Por ejemplo, puede que quieras guardar los archivos de Blender de los modelos 3D de tu escena dentro de la carpeta de la escena, pero evitar que esos archivos se desplieguen en Decentraland. En ese caso, podrías añadir `*.blend` a *.dclignore* para ignorar todos los archivos con esa extensión.

{% hint style="warning" %}
**📔 Nota**: *.dclignore* también se aplica a la vista previa local, no solo a los despliegues. Los archivos ignorados no aparecen en el contenido que ofrece la vista previa, así que la escena tampoco puede cargarlos allí. No se trata de un error 404 que puedas detectar en los registros: simplemente, nunca se solicita el archivo. Si un recurso funciona en el editor, pero no en la vista previa, comprueba primero *.dclignore* .
{% endhint %}

| Qué ignorar          | Ejemplo     | Descripción                                                                                                  |
| -------------------- | ----------- | ------------------------------------------------------------------------------------------------------------ |
| Archivos específicos | `BACKUP.ts` | Ignora un archivo específico                                                                                 |
| Carpetas             | `drafts/`   | Ignora todo el contenido de una carpeta y sus subcarpetas                                                    |
| Extensiones          | `*.blend`   | Ignora todos los archivos con una extensión determinada                                                      |
| Partes del nombre    | `test*`     | Ignora todos los archivos cuyos nombres coincidan con la búsqueda. En este caso, los que empiezan por *test* |


---

# 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/scenes-sdk7/tipos-de-proyectos/scene-files.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.
