> 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/states-and-conditions.md).

# Estados e condições

Gerenciando estados de itens e lógica condicional

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

## Lógica condicional

Adicione condições a um trigger para que a ação só ocorra se essas condições forem cumpridas. Por exemplo, clicar numa porta só ativa a ação "Abrir" se ela ainda não estiver aberta.

Para adicionar uma condição, clique no ícone dos três pontos ao lado de **Trigger event** e selecione **Add Trigger Condition**.

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

Um único trigger pode incluir várias condições. Clique no ícone **+** para adicionar mais condições. Quando existir mais do que uma condição, pode selecionar uma destas opções:

* **Todas as condições têm de ser cumpridas (AND)**: o trigger só ocorre se todas as condições forem verdadeiras.
* **Qualquer condição pode ser cumprida (OR)** O trigger ocorre se pelo menos uma das condições for verdadeira.

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

### States

O componente **States** está incluído em vários smart items. Apresenta os estados possíveis do smart item. Em qualquer momento, o smart item encontra-se num destes estados. Por exemplo, uma porta pode estar *Open* ou *Closed*. A ação Open define o estado como *Open*; a ação Close define o estado como *Closed*.

Pode fazer o seguinte com os states:

1. Use uma condição num trigger para verificar o estado de uma entidade. Assim, a ação só é executada se um estado específico estiver ativo.

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

2. Altere um state através da ação **Set State** .

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

3. Reaja a alterações de state através do evento de trigger **On State Change** .

Para alternar entre duas ações, defina dois triggers, cada um com uma condição que verifica um state. Por exemplo, as portas têm um trigger que ativa a ação Open, com uma condição que verifica primeiro se o state da porta é *Closed*, e outro trigger que ativa a ação Close, com uma condição que verifica se o state da porta é *Open*. Apenas um dos dois é ativado sempre que o jogador clica na porta.

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

Pode adicionar quantos states quiser a um smart item. Basta clicar no botão **Add New State** para adicionar outro à lista.

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

Um dos states é selecionado como predefinido; o item começa sempre neste estado quando a scene é executada. Pode definir outro state como predefinido clicando nos três pontos junto a outro state e selecionando **Set as Default**.

{% hint style="info" %}
**💡 Sugestão**: mantenha simples as interações entre items. Por exemplo, evite situações em que um botão abre uma porta ao ativar três ações: reproduzir a animação da porta, reproduzir o som da porta e alterar o state da porta. Em vez disso, faça com que o botão altere o state da porta. Depois, use um trigger **On State Change** para que a própria porta reproduza a animação e o som sempre que o state mudar.
{% endhint %}

### Counter

Use o componente **Counter** para acompanhar um número, que pode mudar à medida que o jogador executa ações na scene. Pode usar os valores do counter na lógica condicional.

Quando uma entidade tem um componente Counter, pode executar nela as seguintes ações:

* **Increment Counter**: aumenta o valor do counter por um valor configurável **Quantidade**, 1 por predefinição.
* **Diminuir contador**: diminui o valor do contador numa quantidade configurável **Quantidade**, 1 por predefinição.
* **Definir contador**: define o valor do contador para um número específico, por exemplo, para o repor a 0.

Utilize o **Ao alterar o contador** trigger para executar uma ação sempre que o valor do contador mudar. Adicione uma condição a este trigger para que só seja ativado depois de ultrapassar um determinado limite.

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

Numa condição, pode verificar se o valor do contador é

* Superior a um determinado valor
* Inferior a um determinado valor
* Igual a um determinado valor

{% hint style="info" %}
**💡 Sugestão**: para verificar se é superior ou igual, pode adicionar duas condições ao evento trigger, utilizando a opção AND.

Para fazer com que uma ação ocorra apenas uma vez ao ultrapassar um limite, em vez de se repetir a cada incremento, combine o contador com um componente **State** Defina o State como "Concluído" quando atingir o valor pretendido e adicione uma condição para verificar este estado no evento trigger.
{% 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)
* [Tornar qualquer item inteligente](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/make-any-item-smart.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/states-and-conditions.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.
