> 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 item personalizado para o reutilizar facilmente em qualquer uma das suas cenas ou partilhá-lo com outros criadores de cenas. Os itens personalizados podem consistir numa única entidade ou em tantas entidades quantas quiser. Os itens personalizados podem ser variações de Smart Items existentes ou totalmente personalizados, com modelos e funcionalidades próprios.

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

## Como definir um item personalizado

Clique com o botão direito do rato numa entidade na [Entity Tree](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md#the-entity-tree), ou selecione várias entidades e, em seguida, clique com o botão direito do rato nelas. Selecione **Create Custom Item**.

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

Na secção inferior do ecrã, ser-lhe-á pedido que atribua um nome ao novo item personalizado.

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

O item aparece agora no separador **Custom Items** , na parte inferior do ecrã. Este separador só é apresentado se existir pelo menos um item personalizado na sua área de trabalho.

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

Ao definir um item personalizado, pode selecionar várias entidades no mesmo nível hierárquico, mas não entidades de ramos diferentes, a menos que tenham um antepassado comum. Todas as entidades aninhadas são incluídas automaticamente no item personalizado, não sendo necessário selecioná-las.

As entidades originais da sua cena não são afetadas pela definição de um item personalizado.

{% hint style="warning" %}
**📔 Nota**: ao definir um item personalizado, cria uma captura do estado de cada componente nas entidades selecionadas (exceto a posição, a rotação e a escala da entidade raiz). Isto inclui **Actions**, **Triggers**, **Multiplayer**, **Scripts**, **Visibility**e quaisquer outros componentes.

As ações e os triggers de qualquer smart item irão referenciar a sua própria cópia. Por exemplo, se definir um item personalizado que inclua um elevador e botões, os botões de cada cópia do elevador controlarão a cópia do elevador a que pertencem, e não a cópia original do elevador.
{% endhint %}

### Utilizar itens personalizados

Basta arrastar o item do separador **Custom Items** para a sua cena.

Depois de adicionado, pode alterar qualquer propriedade de um item personalizado. As alterações que fizer afetam apenas *essa cópia* do item personalizado. Também pode editar ou eliminar os itens originais a partir dos quais o item personalizado foi definido; isso não afetará as cópias existentes nem as futuras.

Repare que os itens personalizados são apresentados com um ícone diferente na Entity Tree. Na parte superior do menu de propriedades do item, à direita, também verá uma indicação do item personalizado a partir do qual foram criados.

Para eliminar a definição de um item personalizado, clique com o botão direito do rato no item no menu **Custom Items** e selecione **Delete**. Esta ação não afeta as cópias existentes do item nas suas cenas; os itens personalizados órfãos permanecem inalterados na cena. Eliminar a definição de um item personalizado apenas o remove do separador Custom Items.

Para mudar o nome de uma definição de item personalizado, clique com o botão direito do rato na definição no separador **Custom Items** e selecione **Rename**.

Não é possível modificar a definição de um item personalizado já criado. Tem de criar uma nova definição e eliminar a original.

### Criar itens personalizados dinamicamente

Cada item personalizado é armazenado como um composto, um ficheiro que descreve uma árvore de entidades e componentes. Isto significa que pode criar uma nova cópia de um item personalizado enquanto a cena está em execução, em vez de colocar cada cópia manualmente.

Pode criar um item personalizado de duas formas:

* **Sem código**: use a ação **Spawn Entity** no Scene Editor. Consulte [Acerca da criação de entidades](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md#about-spawning-entities).
* **Com código**: use `Composite.instance()` no SDK. Consulte [Composites](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/arquitetura/composites.md).

### Partilhar itens personalizados

Pode partilhar os seus itens personalizados com outros criadores, para que os possam utilizar nas suas próprias cenas.

Os itens personalizados são armazenados individualmente em pastas separadas no seu computador. Abra essa pasta clicando no ícone da pasta <img src="https://2402076176-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"> no canto superior direito do separador Custom Items.

Também pode localizar manualmente esta pasta no seu computador:

* 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 pasta *Library* está oculta por predefinição no Mac. A forma mais fácil de aceder a ela é abrir Ir > Ir para a pasta e escrever *application support/creator-hub*
{% endhint %}

Para partilhar com outra pessoa, basta abrir a pasta Custom Items e copiar a pasta completa do item. Pode comprimir a pasta num ficheiro ZIP para facilitar a transferência. Esta pasta contém tudo o que é necessário para utilizar o seu item personalizado.

A pessoa que utilizar o seu item personalizado deve descomprimir a pasta do item na sua própria pasta Custom Items no computador. Poderá ter de clicar no botão Refresh <img src="https://2402076176-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 o item apareça no seu separador **Custom Items** .

Todos os **Assets** utilizados pelo seu item personalizado também são armazenados na pasta do item. Isto inclui todos os 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 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=<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.
