> 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/interactividad/custom-items.md).

# Ítems personalizados

Crea tus propios ítems personalizados para reutilizarlos en cualquiera de tus escenas.

Define un elemento personalizado para reutilizarlo fácilmente en cualquiera de tus escenas o compartirlo con otros creadores de escenas. Los elementos personalizados pueden constar de una sola entidad o de tantas entidades como quieras. Pueden ser variaciones de Smart Items existentes o elementos totalmente personalizados, con modelos y funcionalidades propios.

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

## Cómo definir un elemento personalizado

Haz clic derecho en una entidad del [Entity Tree](https://docs.decentraland.org/creator/content-creator-es/scene-editor/primeros-pasos/scene-editor-essentials.md#the-entity-tree), o selecciona varias entidades y haz clic derecho sobre ellas. Selecciona **Create Custom Item**.

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

En la parte inferior de la pantalla, se te pedirá que le pongas un nombre al nuevo elemento personalizado.

![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-763f97263bcb03228513976115b70e7050231d33%2Fname-custom-item.webp?alt=media)

El elemento aparecerá en la pestaña **Custom Items** , en la parte inferior de la pantalla. Esta pestaña solo se muestra si hay al menos un elemento personalizado en tu espacio de trabajo.

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

Al definir un elemento personalizado, puedes seleccionar varias entidades del mismo nivel jerárquico, pero no entidades de distintos elementos principales si no comparten un antecesor común. Las entidades anidadas se incluyen automáticamente como parte del elemento personalizado, así que no es necesario seleccionarlas.

La acción de definir un elemento personalizado no afecta a las entidades originales de la escena.

{% hint style="warning" %}
**📔 Nota**: al definir un elemento personalizado, se captura una instantánea del estado de cada componente de las entidades seleccionadas (excepto la posición, rotación y escala de la entidad raíz). Esto incluye **Actions**, **Triggers**, **Multiplayer**, **Scripts**, **Visibility**y cualquier otro componente.

Las acciones y los triggers de los Smart Items harán referencia a sus propias copias. Por ejemplo, si defines un elemento personalizado que incluye un ascensor y botones, los botones de cada copia del ascensor controlarán la copia a la que pertenecen, no el ascensor original.
{% endhint %}

### Uso de elementos personalizados

Solo tienes que arrastrar el elemento desde la pestaña **Custom Items** hasta la escena.

Una vez añadido, puedes cambiar cualquier propiedad de un elemento personalizado. Los cambios solo afectan a *esa copia* del elemento personalizado. También puedes editar o eliminar los elementos originales a partir de los cuales se definió el elemento personalizado; esto no afectará a las copias existentes ni a las futuras.

Ten en cuenta que los elementos personalizados aparecen con un icono distinto en el Entity Tree. En la parte superior del menú de propiedades del elemento, a la derecha, también verás una indicación del elemento personalizado a partir del cual se creó.

Para eliminar la definición de un elemento personalizado, haz clic derecho en el elemento del menú **Custom Items** y selecciona **Delete**. Esta acción no afecta a las copias existentes del elemento en tus escenas; los elementos personalizados huérfanos permanecen sin cambios en la escena. Eliminar la definición de un elemento personalizado solo lo quita de la pestaña Custom Items.

Para cambiar el nombre de la definición de un elemento personalizado, haz clic derecho en ella en la pestaña **Custom Items** y selecciona **Rename**.

No puedes modificar la definición de un elemento personalizado que ya se haya creado; debes crear una nueva definición y eliminar la original.

### Generar elementos personalizados de forma dinámica

Cada elemento personalizado se almacena como un archivo compuesto que describe un árbol de entidades y componentes. Esto significa que puedes generar una copia nueva de un elemento personalizado mientras se ejecuta la escena, en lugar de colocar cada copia manualmente.

Puedes generar un elemento personalizado de dos maneras:

* **Sin código**: usa la acción **Spawn Entity** en el Scene Editor. Consulta [Información sobre la generación de entidades](https://docs.decentraland.org/creator/content-creator-es/scene-editor/interactividad/smart-items-advanced.md#about-spawning-entities).
* **Con código**: usa `Composite.instance()` en el SDK. Consulta [Composites](https://docs.decentraland.org/creator/content-creator-es/scenes-sdk7/arquitectura/composites.md).

### Compartir Custom Items

Puedes compartir tus Custom Items con otros creadores para que puedan usarlos en sus propias escenas.

Cada Custom Item se almacena en una carpeta distinta en tu equipo. Abre esa carpeta haciendo clic en el icono de carpeta <img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-498b8fc602219919fc16af2f71ffd39de109217b%2Ffolder-icon.png?alt=media" alt="Code" data-size="line"> en la esquina superior derecha de la pestaña Custom Items.

También puedes buscar manualmente esta carpeta en tu equipo:

* En Windows: *User/AppData/Roaming/creator-hub/Custom Items*
* En Mac: *Users/username/Library/Application Support/creator-hub/Custom Items*

{% hint style="warning" %}
**📔 Nota**: La carpeta *Library* está oculta de forma predeterminada en Mac. La forma más sencilla de acceder a ella es abrir Ir > Ir a la carpeta y escribir *application support/creator-hub*
{% endhint %}

Para compartir un elemento con otra persona, abre la carpeta Custom Items y copia la carpeta completa del elemento. Puedes comprimirla en un archivo ZIP para facilitar la transferencia. Esta carpeta contiene todo lo necesario para usar tu Custom Item.

Luego, la persona que vaya a usar tu Custom Item debe descomprimir la carpeta del elemento en su propia carpeta Custom Items. Es posible que tenga que hacer clic en el botón Refresh <img src="https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-405ad76a2a2c6c176d5dca56eed527976fee3325%2Frefresh-icon.webp?alt=media" alt="Refresh" data-size="line"> para que el elemento aparezca en su pestaña **Custom Items** .

Todos los **Assets** que use tu Custom Item también se almacenan en la carpeta de ese Custom Item. Esto incluye los modelos 3D, las imágenes, los scripts, los sonidos y los videos a los que hace referencia el elemento.


---

# 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/interactividad/custom-items.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.
