> 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 Crie seus próprios itens personalizados para reutilizar em qualquer uma das suas scenes. 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 modelos e funcionalidades sob medida. {% embed url="" %} ## Como Definir um Custom Item Clique com o botão direito em uma Entity na [Entity Tree](/creator/content-creator-pt/scene-editor/primeiros-passos/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**. ![](https://2402076176-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) Na seção inferior da tela, você será então solicitado a dar um nome ao seu novo Custom Item. ![](https://2402076176-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) O item agora está listado na **Custom Items** aba, na parte inferior da sua tela. Эта aba só é exibida se pelo menos um Custom Item existir no seu espaço de trabalho. ![](https://2402076176-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) Ao definir um Custom Item, você pode selecionar várias Entities no mesmo nível hierárquico, mas não Entities de pais separados se não compartilharem um ancestral comum. Quaisquer Entities aninhadas são automaticamente incluídas 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ê tira 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 autorreferê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. Depois de adicionado, você pode alterar livremente qualquer propriedade de um Custom Item; as mudanças 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 nem futuras. Observe que Custom Items são exibidos com um ícone diferente no 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 na **Custom Items** menu e selecione **Delete**. Esta ação não afeta nenhuma cópia existente do item nas suas Scenes; Custom Items órfãos permanecem na sua Scene inalterados. Excluir uma definição de Custom Item apenas a remove 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ê precisa criar uma nova definição e excluir a original. ### Criando Custom Items dinamicamente Cada Custom Item é armazenado como um composite, um file 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 posicionar 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 a criação de 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 nas 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 essa pasta manualmente 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. Você talvez queira 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 na própria pasta Custom Items dela na máquina. Talvez ela precise clicar no botão Refresh Refresh para que o item apareça na sua **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, sounds e videos 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 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-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 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.