> 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/comenzar/scene-editor-essentials.md). # Conceptos básicos de Scene Editor Cómo usar el Scene Editor La UI del Scene Editor está dividida en varias secciones diferentes, con propósitos distintos. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-80eb7f0f2596e0dde68a93113665f40c1157ea1e%2Feditor-layout.png?alt=media) * **Canvas**: Manipula items directamente y ve cómo se ve tu escena. * **Entity tree**: Contiene una lista de todos los items de la escena y su jerarquía. * **Properties**: Muestra detalles sobre el item actualmente seleccionado. * **Resources**: Muestra los recursos que están disponibles para usar. ## Moverse Para orientarte en el Scene Editor: * Usa **W** y **S** para acercarte o alejarte. También puedes usar la rueda de desplazamiento del mouse, o **+** y **-** teclas * Usa **A** y **D** para moverte lateralmente. * Usa **Q** y **E** para moverte hacia arriba y hacia abajo. * Haz clic en el **botón derecho del mouse** y arrastra para rotar la cámara. * Pulsa **la barra espaciadora** para restablecer la cámara a la posición predeterminada * Usa **botón izquierdo del mouse** para hacer clic y seleccionar items y moverlos. ## Vista previa en móvil El menú desplegable junto al **Preview** botón tiene una **Mostrar código QR para móvil** opción. Escanea el código QR con un teléfono en la misma red Wi‑Fi para abrir tu escena en la [aplicación móvil de Decentraland](/creator/content-creator-es/crear-para-movil/cliente-movil/overview.md). Esta es la forma recomendada de validar la UI, los controles y el rendimiento para jugadores móviles. Consulta [Vista previa en móvil](/creator/content-creator-es/crear-para-movil/desarrollar/preview-on-mobile.md) para la guía completa. ## Configurar el Ground El suelo de la escena puede usar varias texturas diferentes. Puedes encontrarlas en los diferentes asset packs temáticos del menú de items. Items de tipo **Ground** tienen un ícono de cubo de pintura. Si arrastras uno de estos a tu escena, cubre todo el suelo de la escena con copias de este item. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-8d952452b5bf6475868c3392c6f0472690587580%2Fground.png?alt=media) También puedes añadir una sola copia del item manteniendo pulsado **Shift** mientras arrastras el Ground a la escena. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-069d473c6ec47b6f54ae95ee9d91bb27c2e81665%2Fground-entities.png?alt=media) La colección de items Ground aparece en el [entity tree](#the-entity-tree) dentro de una carpeta. Cada uno está bloqueado para evitar seleccionarlo por accidente. [Desactiva](#lock-or-hide-items) los items para moverlos o editarlos. ## Añadir items Navega por las categorías de asset packs temáticos en el menú de la parte inferior para encontrar diferentes items que puedes colocar en tu escena. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-533d4553c3a38522cdd08dce8040a08c038699e7%2Fasset-packs.png?alt=media) También puedes usar el cuadro de búsqueda. Ten en cuenta que cuando estás dentro de un asset pack, la búsqueda solo busca en ese asset pack. Para colocar un item, haz clic y arrástralo desde el menú del asset pack hasta una ubicación en tu escena en el Canvas. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-30237e6006c76b69f5cfe737e543875987ed67b8%2Fdrop-item.gif?alt=media) {% hint style="info" %} **💡 Consejo**: Tus cambios se guardan automáticamente cada vez que agregas, mueves o editas las propiedades de cualquiera de los items de tu escena. {% endhint %} Para duplicar un item, selecciónalo y pulsa **Ctrl + C** y luego **Ctrl + V**. También puedes encontrar el item en el [entity tree](#the-entity-tree) para hacer clic derecho y seleccionar la opción **Duplicar**. El nuevo item se superpondrá perfectamente al original. Para eliminar un item de la escena, selecciónalo y pulsa la *tecla Delete* . Consulta [Import items](/creator/content-creator-es/scene-editor/construir/import-items.md) para añadir tus propios modelos 3D personalizados desde el disco. {% hint style="warning" %} **📔 Nota**: Una vez que arrastras un modelo 3D a tu escena, se descarga en la carpeta de tu proyecto y permanece allí incluso si lo eliminas. Estos modelos no utilizados pueden aumentar el tamaño de tu escena. Abre la **Local Assets** pestaña para eliminar cualquier modelo no utilizado. {% endhint %} ## Posicionar items {% embed url="" %} Haz clic con el **botón izquierdo del mouse** y arrastra un item seleccionado para moverlo libremente por la escena a nivel del suelo. También puedes usar las herramientas del menú superior: ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-4b95b511c15b05517739d57d024d0f0b23007782%2Fgizmos.png?alt=media) * **Herramienta Move**: Haz clic y arrastra cada flecha para mover el item en un solo eje a la vez. Con esta herramienta también puedes colocar cosas por encima del nivel del suelo. * **Herramienta Rotate**: Haz clic y arrastra cada uno de los anillos alrededor del item para rotarlo en un eje a la vez. * **Herramienta Scale**: Haz clic en el centro del gizmo y arrastra hacia dentro o hacia fuera para agrandar. Esta herramienta también te permite estirar un item en un solo eje para cambiar sus proporciones; para hacerlo, haz clic en uno de los ejes del gizmo y arrastra. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-dfe9363a387a120ae140da69d76e1c66dc5d5399%2Fmove-items.gif?alt=media) Para tener mayor precisión al mover, rotar o escalar un item, mantén pulsada la *Shift* tecla mientras haces ajustes. Esto evitará que se ajuste a la grid. Para cambiar la granularidad del movimiento y otras configuraciones, haz clic en la flecha hacia abajo a la derecha de las herramientas. Están disponibles las siguientes configuraciones: * **Snap**: Activa o desactiva la grid. Cuando está desactivada, el comportamiento de **Shift** se invierte: no sigues la grid por defecto, pero sí lo haces si mantienes pulsada la **Shift**. * **Position**: El tamaño de los incrementos de movimiento en metros cuando **Snap** está activada. * **Rotation**: El tamaño de los incrementos de rotación en grados cuando **Snap** está activada. * **Scale**: El tamaño de los incrementos de escala cuando **Snap** está activada. * **Align to world**: Una sola casilla que se refiere al eje usado por los gizmos. Cuando está marcada, los ejes de las herramientas Move y Rotate siempre se alinean con el mundo y no cambian con la orientación del objeto. Cuando está desmarcada, se alinean con la orientación del objeto. Para seleccionar varios items al mismo tiempo, mantén pulsada la *Control* mientras los seleccionas. Luego puedes mover, rotar, escalar, duplicar o eliminar todos en una sola acción. ### Escribe una cantidad exacta Cuando arrastrar no es lo suficientemente preciso, escribe la cantidad en su lugar: 1. Pulsa una tecla de herramienta: **M** o **G** para mover, **R** para rotar, **X** para escalar. 2. Pulsa **X**, **Y** o **Z** para elegir un eje. Scale no necesita uno: sin un eje, escala todos los ejes por el mismo factor. 3. Escribe el número. Usa **.** para los decimales, y **-** para alternar entre positivo y negativo. 4. Pulsa **Enter** para aplicar, o **Esc** para cancelar. **Backspace** borra lo que escribiste. Una ficha en la parte inferior del canvas muestra la entrada mientras la escribes, te dice qué falta todavía y confirma lo que se aplicó. Algunos ejemplos: * **R** **X** **1** **5** **Enter** gira la selección 15 grados alrededor de X. * **X** **2** **Enter** hace que la selección sea dos veces más grande. * **M** **Y** **-** **3** **Enter** la mueve 3 metros hacia abajo. Algunas cosas que conviene saber: * La cantidad siempre es relativa a dónde está la selección ahora, no a una coordenada absoluta. * Los valores escritos ignoran la snap grid. * Con varios items seleccionados, todos se mueven, rotan o escalan alrededor de su centro compartido, como un solo paso de deshacer. * Al pulsar **M**, **G** o **R** una segunda vez, sigue desactivando su gizmo. **X** no, porque mientras escribes significa el eje X. {% hint style="info" %} **💡 Consejo**: El ícono de teclado en la esquina inferior derecha del canvas abre la lista completa de atajos. {% endhint %} ## Smart items Los Smart items son items especiales que incluyen comportamientos interactivos integrados. Consulta [Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) para más detalles. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-f368bfdf7894d18f29875528bdd91cf8429e70b3%2Fsmart-items.jpg?alt=media) ## El entity tree En el margen izquierdo verás una estructura en árbol con todas las entities de la escena. Esto incluye todos los items que agregas, así como algunas entities predeterminadas. {% hint style="info" %} **💡 Consejo**: Todo en una escena es una Entity; son los bloques de construcción básicos de las escenas. Los items son Entities que tienen al menos una posición y una forma visible. {% endhint %} En lugar de seleccionar un item haciendo clic sobre él desde la vista 3D de la escena, puedes seleccionarlo desde la vista en árbol. Haz clic con el botón derecho del mouse sobre una entity para mostrar más opciones: puedes renombrarla, eliminarla o duplicarla; también puedes crear una entity hija, convertirla en un item personalizado o añadir un component a la entity. ![El entity tree con el menú contextual abierto sobre la entity Bird Fountain, mostrando Rename, Add child, Duplicate, Delete, Create Custom Item y Add component.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-7e0e6082ae86443a0412c2f58c6bf75e94a754c4%2Fentity-tree-context-menu.png?alt=media) ### Buscando en el entity tree Un cuadro de búsqueda en la parte superior del entity tree te permite encontrar entities por nombre. Escribe parte del nombre de una entity y el árbol se filtra para mostrar solo las entities que coinciden y su jerarquía de padres, para que puedas ver dónde se encuentra cada coincidencia en el árbol. La búsqueda no distingue mayúsculas y minúsculas. Las entities padre de las coincidencias se expanden automáticamente para que cada resultado sea visible. Pulsa **Escape** o haz clic en el ícono de borrar para eliminar el filtro y volver al árbol completo. Si hay una entity seleccionada, al borrar la búsqueda se vuelve a desplazar hasta la entity seleccionada para que no pierdas tu lugar. ![El entity tree filtrado por el término de búsqueda fount: solo las entities Camera, Scene y Bird Fountain siguen visibles, con el padre Scene expandido para mostrar la coincidencia.](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-6a4ecf3021b21dc6e02f1bedabea0aa348d6de18%2Fentity-tree-search.png?alt=media) ### Jerarquía de entities Las entities siguen una jerarquía que puede tener tantos niveles como quieras. Establece una relación padre-hijo entre dos entities arrastrando un item sobre otro en el árbol. Una entity hija hereda la posición del padre, así que cuando el padre se mueve, arrastra consigo a cualquier hijo. Esto puede ser práctico al construir una escena; por ejemplo, puedes establecer que unas gafas y unos platos sean hijos de una mesa, y luego mover la mesa sin necesidad de reajustar nada más. También puede ser importante al interactuar con la escena, para que los items se muevan juntos. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-a184c50ad6e26c4a37418ff8c28de2067ad3b02a%2Fitem-hierarchy.png?alt=media) También puedes minimizar o expandir los hijos de una entity para mantener la vista simple; esta acción no tiene ningún efecto en la escena. ### Entidades especiales La escena incluye un par de entities especiales que puedes ver en el entity tree. * **Scene**: Esto se refiere a la entidad raíz; todo lo que agregues en la escena es hijo de esta entity. Puedes abrirla para ver [scene settings](#scene-settings). * **Player**: El avatar del player. Puedes añadir Components especiales a esta entity que pueden cambiar la mecánica del gameplay. También puedes arrastrar otras entities para que sean hijas del avatar. Si una entity es hija del avatar, su posición quedará fija al player. Usa esto, por ejemplo, para añadir un marcador flotante sobre la cabeza del player, que lo siga adonde vaya. * **Camera**: La cámara del player. Puedes arrastrar otras entities para que sean hijas de la camera. Si una entity es hija de la camera, su posición quedará fija en la pantalla. Usa esto, por ejemplo, para mostrar una pistola en un juego de disparos, que esté siempre a la vista aunque el player mire hacia arriba o hacia abajo. ### Bloquear o ocultar items A veces puede resultarte útil bloquear un item para evitar seleccionarlo y moverlo por accidente. Esto es especialmente útil para items de fondo, como el Ground o un edificio. Para bloquear un item, búscalo en el entity tree de la izquierda, pasa el cursor sobre él y selecciona el ícono de bloqueo. Puedes activar y desactivar este comportamiento con ese mismo ícono. También puedes querer ocultar un item que podría obstruir tu vista mientras colocas otros. Esto es especialmente útil para ocultar el techo o un edificio mientras trabajas en los interiores. Los items ocultos solo se ocultan en la ventana canvas del Scene Editor, no para los jugadores que entran en la escena. Para ocultar un item, búscalo en el entity tree de la izquierda, pasa el cursor sobre él y selecciona el ícono del ojo. Puedes activar y desactivar este comportamiento con ese mismo ícono. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-fb3144eb3c62fc5b632f69e8944f3392e91d8d0e%2Fhide-lock-item.png?alt=media) ## Panel de propiedades Selecciona un item haciendo clic en el canvas o en el entity tree. Luego verás sus Components mostrados en el panel de propiedades, a la derecha de la pantalla. Distintos items tienen distintos Components que muestran configuraciones específicas. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c9c570da87ad3e8ba629f2a0c0b64ea2587a34ac%2Fcomponents-in-editor.png?alt=media) La mayoría de los items no interactivos tienen los siguientes Components: * **Transform**: Establece la posición, la rotación y la escala del item. * **GLTF**: Qué modelo 3D cargar. [Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) puede incluir otros Components. Consulta [Components](/creator/content-creator-es/scene-editor/construir/components.md) para aprender más. ## Limitaciones de la escena Las escenas de Decentraland necesitan seguir ciertas limitaciones para poder ejecutarlas unas junto a otras. Hay un número máximo de materials, textures, triangles, etc., proporcional al número de parcels de la escena. Consulta [scene limitations](/creator/content-creator-es/scenes-sdk7/optimizing/scene-limitations.md) para más detalles. Si el contenido de tu escena supera cualquiera de estos límites, el Scene Editor te lo notificará en la esquina inferior izquierda. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-88f68a93b0cfcb7f8c48270f31ba7137655ee2e1%2Ftriangle-limit1.png?alt=media) Puedes expandir este menú para ver los detalles. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aebaad725f1d9397552b2fb36a318eec91589b9c%2Ftriangle-limit2.png?alt=media) {% hint style="info" %} **💡 Consejo**Si estás construyendo un Decentraland World, siempre puedes aumentar el [tamaño de la escena](/creator/content-creator-es/scene-editor/configurar/scene-settings.md#layout) para aumentar tus límites. {% endhint %} El contenido de una escena de Decentraland también debe evitar desbordarse hacia parcels vecinos. Si alguna parte de los modelos de tu escena se extiende más allá de los límites, cuando abras la vista previa de la escena verás que estas partes se recortan. El Scene Editor marcará todo el modelo en rojo, pero realmente solo debes preocuparte por las partes del modelo que se extienden más allá de los límites de la escena. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-5eb877a01228cb5624728411a6bb06d3e0cfa194%2Fout-of-bounds.png?alt=media) {% hint style="info" %} **💡 Consejo**: Si los modelos que quieres mostrar no caben, puede que quieras aumentar el tamaño de tu escena. Consulta [tamaño de la escena](/creator/content-creator-es/scene-editor/configurar/scene-settings.md#layout) para agrandar tu escena. {% endhint %} Incluso si toda la geometría del modelo 3D cabe en tu escena, un modelo puede marcarse en rojo si el Bounding Box del modelo se extiende más allá del área. Si este es el caso, puedes ignorar las advertencias, ya que todo el modelo se mostrará correctamente. Obtén más información sobre [Bounding Boxes](/creator/content-creator-es/modelado-3d-y-animaciones/meshes.md#bounding-boxes). ## Limpiar assets Mantén tu proyecto ordenado eliminando los assets que ya no se usan. Abre la **Local Assets** pestaña en la parte inferior de la pantalla y haz clic en el ícono del pincel. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-01a4d7c5065b98293092e6d7bad815766a62af29%2Fbrush-icon.png?alt=media) Se abre un cuadro de diálogo que enumera todos los assets de tu escena y resalta aquellos que no están referenciados por ningún item. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-496245893e408c868cc77aa4989002aa713c8e71%2Fclean-up-assets.png?alt=media) Selecciona los assets que quieres eliminar usando las casillas de verificación y luego haz clic en **Remove Selected** para eliminarlos permanentemente. Eliminar un item de la escena no elimina sus archivos. Los modelos, texturas o sonidos importados permanecen en tu proyecto hasta que los limpies, así que revisa periódicamente los assets no utilizados. {% hint style="warning" %} **Importante:** Si tu escena contiene código que hace referencia a assets, algunos assets en uso pueden aparecer como no utilizados. Este diálogo solo detecta assets referenciados por Components en la UI de Creator Hub. Después de hacer clic en **Remove Selected**, los archivos se eliminan de la carpeta del proyecto; esta acción es permanente y no se puede deshacer. {% endhint %} ## Configuración de la escena Haz clic en el **Ícono del lápiz** en la esquina superior derecha de la pantalla. Esto abre una serie de propiedades a nivel de escena para editar. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-d2147688ebde75948ba26a9fbe1261f9abdc66c7%2Fpencil-icon.png?alt=media) Aquí puedes configurar múltiples propiedades, incluyendo el título y la miniatura, el tamaño de la escena, la categoría de la escena y la clasificación por edad, las ubicaciones de spawn del player y los toggles de funciones. Consulta [Scene Settings](/creator/content-creator-es/scene-editor/configurar/scene-settings.md). ## Ver también * Consulta [Smart items](/creator/content-creator-es/scene-editor/interactividad/smart-items.md) para ver cómo agregar interactividad simple a tu escena. * Consulta [Combinar con código](/creator/content-creator-es/scene-editor/extender-con-codigo/overview.md) para ver cómo editar el código de tu escena. * Consulta [Publicar escena](/creator/content-creator-es/scene-editor/publish/publish-scene.md) para ver cómo publicar tu escena en Decentraland. --- # 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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-es/scene-editor/comenzar/scene-editor-essentials.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.