> 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-pt/scene-editor/interatividade/custom-items.md). # Itens personalizados Defina um Custom Item para reutilizá-lo facilmente em qualquer uma das suas scenes, ou compartilhe-o com outros criadores de scenes. Custom Items podem consistir em uma única entity, ou em tantas entities quanto você quiser. Custom Items podem ser variações de Smart Items existentes, ou totalmente personalizados, com seus próprios models e funcionalidade sob medida. {% embed url="" %} ## Como Definir um Custom Item Clique com o botão direito em uma entity no [Entity Tree](/creator/content-creator-pt/scene-editor/comecar/scene-editor-essentials.md#the-entity-tree), ou selecione várias entities e então clique com o botão direito nelas. Selecione **Create Custom Item**. ![](/files/f011ed5efc44d315338acc9799942842987ec3f4) Na seção inferior da tela, você será então solicitado a dar um nome ao seu novo Custom Item. ![](/files/6e526a00bc4fb1a7c6af115df7596ebb60c37c4f) O item agora está listado na **Custom Items** aba, na parte inferior da tela. Essa aba só é exibida se pelo menos um Custom Item existir no seu workspace. ![](/files/4542d41dc1b240090fa5413c38ebf80d98880233) Quando definir um custom item, você pode selecionar várias entities no mesmo nível hierárquico, mas não entities de parents separados se elas não compartilharem um ancestor comum. Quaisquer entities aninhadas são incluídas automaticamente como parte do custom item; elas não precisam ser selecionadas. As entities originais na sua scene não são afetadas pela ação de definir um Custom Item. {% hint style="warning" %} **📔 Nota**: Ao definir um Custom Item, você captura um snapshot do estado de cada component nas entities selecionadas (exceto pela position, rotation e scale da root entity). Isso inclui **Actions**, **Triggers**, **Multiplayer**, **Scripts**, **Visibility**, e qualquer outro component. Quaisquer actions e triggers de smart item farão auto-referência à sua própria cópia. Por exemplo, se você definir um Custom Item que inclua um elevador e botões, os botões em cada cópia do elevador controlarão a cópia do elevador à qual pertencem, e não a cópia original do elevador. {% endhint %} ### Usando Custom Items Basta arrastar o item da **Custom Items** aba para a sua scene. Uma vez adicionado, você pode alterar livremente qualquer propriedade de um Custom Item; as alterações que você fizer afetam apenas *essa cópia* do Custom Item. Você também pode editar ou excluir os itens originais a partir dos quais o Custom Item foi definido; isso não afetará cópias existentes ou futuras. Observe que Custom Items são exibidos com um ícone diferente na Entity Tree. No topo do menu de propriedades do Item à direita, você também verá uma menção de qual Custom Item eles foram criados. Para excluir uma definição de custom item, clique com o botão direito no item no **Custom Items** menu e selecione **Delete**. Essa ação não afeta nenhuma cópia existente do item nas suas scenes; Custom Items órfãos permanecem inalterados na sua scene. Excluir uma definição de Custom Item remove apenas a definição da aba Custom Items. Para renomear uma definição de Custom Item, clique com o botão direito na definição de Custom Item na **Custom Items** aba e selecione **Rename**. Você não pode modificar a definição de um Custom Item que já foi criado; você deve criar uma nova definição e excluir a original. ### Criando Custom Items dinamicamente Cada Custom Item é armazenado como um composite, um arquivo que descreve uma tree de entities e components. Isso significa que você pode criar uma nova cópia de um Custom Item enquanto a scene está em execução, em vez de colocar cada cópia manualmente. Você pode criar um Custom Item de duas maneiras: * **Sem código**: Use a **Spawn Entity** action no Scene Editor. Veja [Sobre criar entities](/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md#about-spawning-entities). * **Com código**: Use `Composite.instance()` no SDK. Veja [Composites](/creator/content-creator-pt/scenes-sdk7/arquitetura/composites.md). ### Compartilhando Custom Items Você pode compartilhar seus custom items com outros criadores, para que eles possam usá-los em suas próprias scenes. Custom Items são armazenados cada um em uma pasta separada na sua máquina local. Abra essa pasta clicando no ícone de pasta Code no canto superior direito da aba Custom Items. Você também pode encontrar manualmente essa pasta na sua máquina: * No Windows: *User/AppData/Roaming/creator-hub/Custom Items* * No Mac: *Users/username/Library/Application Support/creator-hub/Custom Items* {% hint style="warning" %} **📔 Nota**: A *Library* pasta está oculta no Mac por padrão. A maneira mais fácil de acessá-la é abrindo Go > Go to Folder e digitando *application support/creator-hub* {% endhint %} Para compartilhar com outra pessoa, basta abrir a pasta Custom Items e copiar a pasta completa do item. Talvez seja útil compactar a pasta em zip para facilitar a transferência. Essa pasta contém tudo o que é necessário para usar o seu Custom Item. A pessoa que estiver usando o seu Custom Item deve então descompactar a pasta do item em sua própria pasta Custom Items na máquina dela. Ela pode precisar clicar no botão Refresh Refresh para que o item apareça na **Custom Items** aba. Quaisquer **Assets** usados pelo seu Custom Item também são armazenados na pasta do Custom Item. Isso inclui quaisquer modelos 3D, imagens, scripts, sons e vídeos referenciados pelo item. --- # 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-pt/scene-editor/interatividade/custom-items.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.