> 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/construir/components.md).

# Entities e Components

Selecione um item clicando nele no canvas ou na Entity tree. Em seguida, você verá seus Components exibidos no Properties panel, à direita da tela. Itens diferentes têm Components diferentes, e cada um exibe configurações específicas.

![
](/files/b4c596aec2dd51b665434b12256963c11a7f96ed)

A maioria dos itens não interativos tem os seguintes Components:

* **Transform**: Define a posição, rotação e escala do item. Se o item for filho de outro item no [Entity Tree](/creator/content-creator-pt/scene-editor/comece-agora/scene-editor-essentials.md#the-entity-tree), esses valores são relativos aos do parent.
* **GLTF**: Qual modelo 3D carregar. Inclui o caminho local para o arquivo desse modelo 3D. Também inclui algumas propriedades para configurar [colliders](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/colliders.md#colliders-on-3d-models) no model.

Os items na sua scene são todos **Entities**. Tudo em uma scene é uma Entity; elas são os blocos de construção básicos das scenes. Items são Entities que têm pelo menos uma posição e uma forma visível.

## Adicionar components

Para adicionar Components a qualquer Entity, clique no **+** sinal no topo da aba de properties e selecione o Component na lista. Veja [Tornar qualquer item smart](/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md)

![
](/files/c07055b5d0f49ff93d567390dde9a43be353f582)

Você pode excluir qualquer Component de uma Entity clicando no ícone de três pontos à direita dele e selecionando **Delete Component**.

## Criar uma Entity do zero

Para criar uma nova Entity, clique com o botão direito na raiz **Scene** Entity na Entity tree, ou em qualquer outra Entity, e selecione **Add Child**

![
](/files/7c8a58b90666a8998473301e102dee5ce7ea4dc0)

Isso cria uma Entity vazia com apenas um **Transform** Component. A nova Entity é filha da Entity pai em que você clicou. Depois, você pode adicionar quaisquer outros Components que quiser para moldá-la em qualquer coisa que desejar.

## Components disponíveis

Os seguintes Components podem ser adicionados a qualquer Entity pela UI do Scene Editor:

* **Mesh Renderer**: Dá à Entity uma forma visível com base em uma forma primitiva (cubo, plano, cilindro ou esfera).
* **Mesh Collider**: Dá à Entity uma geometria de collider invisível. Isso pode bloquear o player de atravessar o item e/ou torná-lo clicável. Veja [collider](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/colliders.md).
* **Material**: Define a cor, textura e outras propriedades de uma Entity que tem um **Mesh Renderer** Component. Veja [materials](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/materials.md).

  <div data-gb-custom-block data-tag="hint" data-style="warning" class="hint hint-warning"><p>**📔 Nota**: o item deve ter um Component **Mesh Renderer**. Isso não afeta itens com uma forma visível **GLTF**.</p></div>
* **Visibility**: Define se uma Entity é invisível.
* **Light Source**: Adiciona uma luz à Entity.
* **Swap Material**: Troca o material de uma Entity que tem um **GLTF** component. Se o modelo 3D tiver vários meshes, você pode trocar o material de cada mesh individualmente.
* **Audio Source**: Toca um som de um arquivo de som na localização da Entity. Veja [Sounds](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/sounds.md).
* **Text Shape**: Exibe texto no espaço 3D. Veja [Text](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/text.md).
* **Pointer Events**: Marca uma Entity como clicável, exibindo uma dica de hover.

{% hint style="warning" %}
**📔 Observação**: A **Pointer Events** Component fornece apenas feedback. Para executar ações quando uma Entity for interagida, veja [Tornar qualquer item smart](/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.md)
{% endhint %}

* **Multiplayer**: Compartilha quaisquer alterações que aconteçam com a Entity para que todos os players na scene também as vejam. Pode ser configurado para compartilhar alterações apenas em certos components. Veja [Serverless Multiplayer](/creator/content-creator-pt/cenas-sdk7/rede/serverless-multiplayer.md#mark-an-entity-as-synced) para mais detalhes.
* **Animator**: Controla a reprodução de animações em uma Entity com um **GLTF** 3D model. Veja [animações do 3D model](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/3d-model-animations.md).
* **Tween**: Faz a Entity mover-se, girar ou escalar gradualmente ao longo de um período de tempo. Veja [Move entities](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/move-entities.md).
* **Billboard**: Faz a Entity girar sempre para encarar o player. Veja [Encare o usuário](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/entity-positioning.md#face-the-user).
* **Avatar Attach**: Prende a Entity ao avatar do player, para que ela o acompanhe. Veja [Prender uma entity a um avatar](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/entity-positioning.md#attach-an-entity-to-an-avatar).
* **Video Player**: Reproduz um vídeo dentro da scene, que pode ser exibido na Entity por meio de sua **Material**. Veja [Reprodução de vídeo](/creator/content-creator-pt/cenas-sdk7/midia/video-playing.md).
* **NFT Shape**: Exibe a imagem de um NFT dentro de uma moldura. Veja [Exibir um NFT](/creator/content-creator-pt/scene-editor/construir/nfts.md).
* **Particle System**: Emite partículas a partir da localização da Entity, para efeitos como fumaça, fogo ou brilhos. Veja [sistemas de partículas](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/particle-system.md).
* **Virtual Camera**: Define um ângulo de câmera personalizado para o qual a scene pode alternar a visão do player. Veja [Camera](/creator/content-creator-pt/cenas-sdk7/nocoes-essenciais-de-conteudo-3d/camera.md).
* **Script**: Anexa um módulo de código personalizado à Entity, com parâmetros que você pode configurar pela UI. Veja [Componente Script](/creator/content-creator-pt/scene-editor/estenda-com-codigo/script-component.md).

{% hint style="warning" %}
**📔 Observação**: Outros components existem no SDK que atualmente só podem ser usados via code. Você também pode criar seus próprios [components personalizados](/creator/content-creator-pt/cenas-sdk7/arquitetura/custom-components.md) via code; eles não terão representação na UI, mas podem ser adicionados e editados via code.

Veja [Combinar com código](/creator/content-creator-pt/scene-editor/estenda-com-codigo/overview.md) para saber como editar o código da sua scene.

Observe também que uma Entity só pode conter **um** de cada Component. Não é possível atribuir uma segunda instância de um Component que já existe na entity. Por exemplo, você não pode adicionar dois **Actions** components à mesma Entity.
{% endhint %}

## Smart items

[Smart items](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md) também podem incluir components especiais que controlam a interatividade da Entity. Normalmente, esses são:

* **Actions**: Lista todas as ações possíveis que o item pode realizar.
* **Triggers**: Determina quando as ações do componente Actions são executadas.
* **States**: Mantém o controle do estado atual do item. O state pode ser usado para lógica condicional, para acionar certas ações apenas se o item estiver em determinado state.
* **Counter**: Mantém o controle de um counter. O counter pode ser usado para lógica condicional, para acionar certas ações apenas se o valor do counter for igual/maior/menor que um valor dado.

Veja [Smart items avançados](/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md) para mais detalhes.

## Sobre Entities e components

Tudo em uma scene é uma Entity. Todos os items e smart items na scene são Entities.

Todas as características de uma Entity são determinadas por seus components. Eles definem o que a Entity é, onde ela está, como soa e como se comporta. Por exemplo, um **Transform** component armazena as coordenadas, rotação e escala da Entity. Um **MeshRenderer** component dá à Entity uma forma visível (como um cubo ou uma esfera), e um **Material** component dá à Entity uma cor ou textura.

Os valores nos components podem mudar ao longo do tempo. No Scene Editor, você configura os valores iniciais desses components. Mas, depois que sua scene está em execução, as ações do player ou a passagem do tempo podem alterar esses valores.

Por exemplo, um Smart Item de plataforma móvel tem uma posição inicial que você define por meio de seu **Transform** component, mas depois que as ações desse item fazem com que ele se mova, seu **Transform** terá valores diferentes.

Veja [Entities e components](/creator/content-creator-pt/cenas-sdk7/arquitetura/entities-components.md) para uma análise aprofundada desse conceito e de como eles são usados pelas scenes do Decentraland.


---

# 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/construir/components.md?ask=<question>&goal=<endgoal>
```

`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.