# Itens personalizados

Defina um Custom Item para reutilizá-lo facilmente em qualquer uma das suas scenes, ou compartilhá-lo com outros criadores de scenes. Custom items podem consistir em uma única entity, ou em quantas entities você quiser. Custom items podem ser variações de Smart Items existentes, ou totalmente personalizados, com seus próprios models e funcionalidades sob medida.

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

## Como Definir um Custom Item

Clique com o botão direito numa entity na [Entity Tree](/creator/content-creator-pt/scene-editor/comecar/scene-editor-essentials.md#the-entity-tree) , ou selecione várias entities e depois clique com o botão direito nelas. Selecione **Create Custom Item**.

![](/files/f011ed5efc44d315338acc9799942842987ec3f4)

Na seção inferior da tela, será então pedido que você dê um nome ao seu novo Custom Item.

![](/files/6e526a00bc4fb1a7c6af115df7596ebb60c37c4f)

O item agora está listado na **Custom Items** tab, na parte inferior da sua tela. Esta tab só é exibida se existir pelo menos um Custom Item no seu workspace.

![](/files/4542d41dc1b240090fa5413c38ebf80d98880233)

Ao 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 ancestral comum. Quaisquer entities aninhadas são incluídas automaticamente como parte do custom item; 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ê faz um snapshot do estado de cada component nas entities selecionadas (exceto a position, rotation e scale da root entity). Isso inclui **Actions**, **Triggers**, **Multiplayer**, **Scripts**, **Visibility** , e qualquer outro component.

Quaisquer ações 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 de cada cópia do elevador controlarão a cópia do elevador à qual pertencem, e não a cópia original do elevador.
{% endhint %}

### Usar Custom Items

Basta arrastar o item da **Custom Items** tab para a sua scene.

Depois de adicionado, você pode alterar livremente qualquer propriedade de um Custom Item; as alterações que fizer afetam apenas *essa cópia* do Custom Item. Você também pode editar ou deletar 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. Na parte superior do menu de propriedades do Item, à direita, você também verá uma menção de qual Custom Item eles foram criados.

Para deletar uma definição de custom item, clique com o botão direito no item no **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. Deletar uma definição de Custom Item remove apenas ela da tab 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** tab 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 deletar a original.

### Compartilhar Custom Items

Você pode compartilhar seus custom items com outros criadores, para que eles possam usá-los nas 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 <img src="/files/64ec42ecc38ad324d1ac6bb309acdee4590e49be" alt="Code" data-size="line"> no canto superior direito da tab 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* folder está oculta no Mac por padrão. A maneira mais fácil de acessá-la é abrir Go > Go to Folder, e digitar *application support/creator-hub*
{% endhint %}

Para compartilhar com outra pessoa, basta abrir a pasta Custom Items e copiar a pasta completa do item. Você pode querer 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 sua própria pasta Custom Items, na sua máquina. Ela pode precisar clicar no botão Refresh <img src="/files/4e46fb26faab977f7597967d8d9f825760d85dc7" alt="Refresh" data-size="line"> ou para que o item apareça na sua **Custom Items** tab.

Quaisquer **Assets** usados pelo seu Custom Item também são armazenados na pasta do Custom Item. Isso inclui quaisquer models 3D, images, scripts, sounds e videos referenciados pelo item.


---

# Agent Instructions: 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:

```
GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/custom-items.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
