> 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/make-any-item-smart.md).

# Torne qualquer item smart

Configure qualquer item para se comportar como um smart item.

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

Smart items são apenas itens normais com um **Action** e/ou **Trigger** component. Pode adicionar estes componentes a qualquer item da sua Scene. Também pode importar os seus próprios modelos 3D personalizados e adicioná-los a esses itens.

Para adicionar componentes a um item, clique no **Ícone de mais** ao lado do nome do item e selecione na lista suspensa o componente que pretende adicionar.

![O menu para adicionar componentes aberto numa Entity, com os componentes agrupados em 3D Content e Interaction, incluindo Actions e Triggers.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-e735e723bc67fa3ef0cdcb9aff864a9bc8143f34%2Fadd-component.webp?alt=media)

Isto permite uma enorme variedade de possibilidades criativas. Transforme uma vela numa alavanca que abre uma passagem secreta atrás de uma estante, reproduza sons misteriosos dentro de um poço ou transforme diamantes em itens colecionáveis que encolhem até 0 quando clicados. Há inúmeras formas imaginativas de combinar estas mecânicas!

## Interatividade

Pode fazer com que um item reaja a diferentes ações do jogador.

{% hint style="info" %}
**💡 Dica**: Quando um jogador interage com um item, deve apresentar algum tipo de feedback para tornar clara essa interação. Se o modelo não tiver animações, considere pelo menos reproduzir um som. Em alguns casos, pode resultar fazer o item executar um pequeno Tween na escala e depois voltar à escala original, como forma de feedback.
{% endhint %}

Adicione um componente **Trigger** para detetar diferentes ações do jogador:

* **Eventos de Pointer**: Quando o jogador clica ou prime uma tecla enquanto aponta o cursor para o item.
* **Eventos de botões globais** Quando o jogador prime uma tecla, onde quer que esteja na Scene.
* **Proximidade do jogador**: Quando o jogador se aproxima da posição do item.

O componente **Trigger** pode ser configurado para detetar qualquer um destes tipos de Triggers. Sempre que ocorre um Trigger, pode chamar Actions do seu próprio componente **Actions** ou dos componentes de outros itens da Scene. Consulte **Actions** para obter mais informações. [Smart items - Avançado](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md).

{% hint style="info" %}
**💡 Dica**: Também pode combinar estes Triggers com [lógica condicional](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md), para que as Actions não sejam chamadas sempre que o Trigger ocorre, mas apenas quando as condições são verdadeiras.

Por exemplo, pode adicionar um Trigger **Pointer Events** a uma porta para que esta se abra quando clicada, mas incluir lógica condicional para que só se abra se estiver destrancada.
{% endhint %}

### Eventos de Pointer

Adicione um componente **Trigger** com **On Click** ou **On Input Action** para os eventos de Trigger.

* **On Click** reage sempre que o jogador clica no botão esquerdo do rato enquanto aponta para o item.
* **On Input Action** reage sempre que o jogador prime o botão principal (E) enquanto aponta para o item.

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

**Colliders**

É importante que, para um item ser clicável, tenha um **Collider**. Caso contrário, os cliques atravessam o modelo e tentam interagir com o que estiver atrás. Todos os modelos 3D dos Asset Packs predefinidos devem ter colliders, mas, se criar o seu próprio modelo ou o obtiver de outra origem, poderá descobrir que lhe falta um.

Se o seu modelo não tiver colliders, qualquer uma das seguintes opções deverá resolver o problema:

* Adicione um componente **Mesh Collider** . Isto criará um collider com uma [forma primitiva](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/shape-components.md#primitive-shapes) (cubo, plano, cilindro, esfera).
* Altere as propriedades da secção **Colisões** no componente **GLTF** . A camada **Visível** deve ser atribuída a **Pointer**.
* Edite o modelo 3D no Blender para incluir uma geometria de collider invisível (qualquer mesh cujo nome termine em `_collider`). Consulte [colliders](https://docs.decentraland.org/creator/content-creator-pt/modelacao-3d-e-animacoes/colliders.md).

{% hint style="info" %}
**💡 Dica**: Se usou o componente **Mesh Renderer** para dar ao seu modelo uma forma primitiva, isso, por si só, não lhe dará um collider. Também tem de lhe atribuir um componente **Mesh Collider** .
{% endhint %}

**Personalizar eventos de pointer**

Pode substituir as definições predefinidas usadas quando um item tem uma ação **On Click** ou uma **On Input Action** Trigger Action.

* **Texto ao passar o cursor**: Altere a sugestão que os jogadores veem junto ao cursor quando o passam sobre o item. Isto pode ser muito útil para explicar o que o item faz.
* **Distância máxima**: A que distância pode estar o jogador ao interagir com o seu item.
* **Mostrar feedback**: Se esta opção estiver desmarcada, o item não apresenta nenhuma sugestão ao passar o cursor sobre ele.
* **Botão**: Se estiver a usar a **On Input Action** Trigger Action, pode reatribuir o **Primary (E)** predefinido a outra tecla. A sugestão ao passar o cursor incluirá um ícone para indicar qual tecla usar. Pode usar **Secondary (F)**, ou **Actions 3 to 6** (teclas numéricas de 1 a 4).

### Eventos globais de botão

Adicione um **Trigger** componente com **Ao clicar em qualquer lugar**, **Ao premir o botão primário em qualquer lugar** ou **Ao premir o botão secundário em qualquer lugar** Ativa eventos.

* **Ao clicar em qualquer lugar** reage sempre que o jogador clica com o botão esquerdo do rato, em qualquer lugar da cena.
* **Ao premir o botão primário em qualquer lugar** reage sempre que o jogador prime o botão primário (E), em qualquer lugar da cena.
* **Ao premir o botão secundário em qualquer lugar** reage sempre que o jogador prime o botão secundário (F), em qualquer lugar da cena.

{% hint style="info" %}
**💡 Dica**: Muitas vezes, faz sentido combinar isto com [Estados e condições](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md), para que os itens só reajam ao evento do botão quando o jogador estiver na sala ou quando outra condição se verificar.
{% endhint %}

### Posição do jogador

Adicione um **Trigger** componente com **O jogador entra na área**, **O jogador sai da área** Ativa eventos.

Isto reage quando o jogador entra ou sai de uma área com o tamanho predefinido de 1x1x1, posicionada no centro do item.

{% hint style="info" %}
**💡 Dica**: Muitas vezes, é melhor usar o item inteligente [**Trigger Area**](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md#trigger-areas) em vez deste, uma vez que as dimensões deste item podem ser visualizadas claramente no Scene Editor.
{% endhint %}

## Ver também

* [Smart items - Noções básicas](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items.md)
* [Smart items - Avançado](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/smart-items-advanced.md)
* [Estados e condições](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/states-and-conditions.md)
* [Combinar com código](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/overview.md)


---

# 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/make-any-item-smart.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.
