> 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 Custom Item para reutilizarlo fácilmente en cualquiera de tus escenas, o compártelo con otros creadores de escenas. Los Custom Items pueden consistir en una sola entidad, o en tantas entidades como quieras. Los Custom Items pueden ser variaciones de Smart Items existentes, o totalmente personalizados, con sus propios modelos y funcionalidad a medida. {% embed url="" %} ## Cómo definir un Custom Item Haz clic derecho sobre una entidad en el [Entity Tree](/creator/content-creator-es/scene-editor/primeros-pasos/scene-editor-essentials.md#the-entity-tree), o selecciona varias entidades y luego 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-e2d3666b2958e72bd78207ed4ac8e0f9908e02be%2Fcreate-custom-item.png?alt=media\&token=98f0efb0-8490-45d1-8180-3003a9f9a640) En la sección inferior de la pantalla, se te pedirá que des un nombre a tu nuevo Custom Item. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-ee1372916ffe9ea085734e64823ec5da994b6e21%2Fname-custom-item.png?alt=media\&token=9331e0f5-8e09-4033-a0e2-158068d35227) El item ahora aparece en la **Custom Items** pestaña, en la parte inferior de la pantalla. Esta pestaña solo se muestra si existe al menos un Custom Item en tu espacio de trabajo. ![](https://1216664193-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-aa8e9586dc8aa8ed34e1d5358f1c072ff821a6f6%2Fcustom-items.png?alt=media\&token=bd6dccd4-6f4f-4b4d-8fae-c8f7c7f435f4) Cuando defines un elemento personalizado, puedes seleccionar varias entidades en el mismo nivel jerárquico, pero no entidades de padres separados si no comparten un ancestro común. Cualquier entidad anidada se incluye automáticamente como parte del elemento personalizado; no necesitas seleccionarla. Las entidades originales de tu escena no se ven afectadas por la acción de definir un Custom Item. {% hint style="warning" %} **📔 Nota**: Al definir un Custom Item, tomas una instantánea del estado de cada componente en 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. Cualquier acción y trigger de smart item se autorreferenciará a su propia copia. Por ejemplo, si defines un Custom Item que incluye un elevador y botones, los botones de cada copia del elevador controlarán la copia del elevador a la que pertenecen, no la copia original del elevador. {% endhint %} ### Cómo usar Custom Items Simplemente arrastra el elemento desde la **Custom Items** pestaña hasta tu escena. Una vez agregado, eres libre de modificar cualquier propiedad de un Custom Item; los cambios que hagas solo afectan *esa copia* del Custom Item. También puedes editar o eliminar los elementos originales a partir de los cuales se definió el Custom Item; esto no afectará a las copias existentes ni a las futuras. Ten en cuenta que los Custom Items se muestran con un icono diferente en el Entity Tree. En la parte superior del menú de propiedades del elemento, a la derecha, también verás una mención de a partir de qué Custom Item fueron creados. Para eliminar la definición de un Custom Item, haz clic derecho sobre el item en el **Custom Items** menú y selecciona **Delete**. Esta acción no afecta a ninguna copia existente del item en tus escenas; los Custom Items huérfanos permanecen en tu escena sin cambios. Eliminar la definición de un Custom Item solo lo quita de la pestaña Custom Items. Para cambiar el nombre de una definición de Custom Item, haz clic derecho sobre la definición de Custom Item en la **Custom Items** pestaña y selecciona **Rename**. No puedes modificar la definición de un Custom Item que ya ha sido creado; debes crear una nueva definición y eliminar la original. ### Generar Custom Items dinámicamente Cada Custom Item se almacena como un composite, un archivo que describe un árbol de entidades y componentes. Esto significa que puedes generar una nueva copia de un Custom Item mientras la escena se está ejecutando, en lugar de colocar cada copia manualmente. Puedes generar un Custom Item de dos maneras: * **Sin código**: Usa la **Spawn Entity** acción en el Scene Editor. Consulta [Acerca de generar entidades](/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](/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 separada en tu equipo local. Abre esa carpeta haciendo clic en el icono de carpeta Code en la esquina superior derecha de la pestaña Custom Items. También puedes encontrar esta carpeta manualmente 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 *Library* carpeta está oculta en Mac de forma predeterminada. La forma más sencilla de acceder a ella es abriendo Go > Go to Folder y escribiendo *application support/creator-hub* {% endhint %} Para compartirlo con otra persona, simplemente abre la carpeta de Custom Items y copia la carpeta completa del elemento. Quizá quieras comprimir la carpeta en zip para facilitar su transferencia. Esta carpeta contiene todo lo necesario para usar tu Custom Item. La persona que use tu Custom Item deberá descomprimir luego la carpeta del elemento en su propia carpeta Custom Items en su equipo. Es posible que tenga que hacer clic en el botón Refresh Refresh para que el elemento aparezca en su **Custom Items** pestaña. Cualquier **Assets** usado por tu Custom Item también se almacena en la carpeta del Custom Item. Esto incluye cualquier modelo 3D, imagen, script, sonido y video referenciado por 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=&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.