> 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/trigger-area.md).

# Área de gatilho

Reaja à posição do jogador

Para fazer algo acontecer quando o jogador entra ou sai de uma área, usa uma Trigger Area [smart item](/creator/content-creator-pt/scene-editor/interatividade/smart-items.md).

![](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-649dfd99d06849f543399b5b89a6a31a015cb439%2Ftrigger.png?alt=media\&token=cbc5fb9b-ecff-4733-b799-38b59244f78b)

O cubo laranja que vês enquanto editas a tua scene só é visível no Scene Editor; torna-se invisível ao executar um Preview da scene. Podes ajustar e dimensionar facilmente o cubo laranja para cobrir exatamente a área de que precisas.

Arrasta-o para a tua scene e redimensiona-o com o gizmo de escala. A caixa ou esfera que vês é apenas desenhada no editor; os jogadores nunca a veem.

Se qualquer parte do avatar do jogador se sobrepor a este cubo laranja, o evento atribuído será chamado. As Trigger Areas reagem apenas ao jogador na máquina local, não aos avatares dos outros jogadores — cada jogador dispara o trigger na sua própria instância da scene.

{% hint style="info" %}
**💡 Dica**: Se as Trigger Areas da tua scene começarem a atrapalhar a edição de outro conteúdo, lembra-te de que podes sempre bloqueá-las e/ou ocultá-las do [Entity Tree](/creator/content-creator-pt/scene-editor/primeiros-passos/scene-editor-essentials.md#the-entity-tree).

<img src="https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-22638c584105c16e473cdbcab644d55b04540fc4%2Fhide-trigger.png?alt=media" alt="" data-size="original">
{% endhint %}

Várias Trigger Areas podem sobrepor-se e não se afetam umas às outras.

Descreves o que deve acontecer e o [AI Assistant](/creator/content-creator-pt/scene-editor/expandir-com-codigo/ai-assistant.md) escreve um pequeno script para isso.

### Configurações

O item **Script** componente tem dois campos:

| Campo           | O que faz                              | Opções                                                                                                                          | Predefinição    |
| --------------- | -------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------- | --------------- |
| **Ativado por** | O que ativa a área.                    | `o meu jogador`, `todos os jogadores`, `qualquer collider`, `clicável`, `personalizado 1`, `personalizado 2`, `personalizado 3` | `o meu jogador` |
| **Forma**       | Se o volume é uma caixa ou uma esfera. | `caixa`, `esfera`                                                                                                               | `caixa`         |

`o meu jogador` reage apenas ao avatar do jogador que está a executar a scene. `todos os jogadores` reage a qualquer avatar, incluindo outras pessoas na scene. As opções restantes correspondem a outras [camadas de colisão](/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/colliders.md), para que possas fazer com que a área reaja a objetos físicos, a itens clicáveis ou às tuas próprias camadas personalizadas.

Ao alternar **Forma** alterna o placeholder do editor entre uma caixa e uma esfera, para que o que vês ao editar seja o volume que obténs.

### Descreve o que deve acontecer

A área dispara dois eventos: **entrar** e **sair**. Na **Reações** secção do componente Script há um botão para cada um:

* **Quando um jogador entra…**
* **Quando um jogador sai…**

Clica num e o Creator Hub escreve o início de uma frase na caixa de mensagem do AI Assistant, nomeando o item, por exemplo `Quando um jogador entra em "Trigger Area",` . O prompt usa o nome do item que vês no entity tree. Termina a frase com o que queres que aconteça e envia-a. O assistente escreve um script separado e anexa-o à mesma entity, juntamente com o detetor.

Os três chips ao lado dos botões (**Tocar um som**, **Mostrar uma mensagem**, **Marcar pontos**) preenchem uma frase completa por ti, para que possas enviá-los tal como estão.

{% hint style="info" %}
**💡 Dica**: As Reações precisam de [AI Assistant](/creator/content-creator-pt/scene-editor/expandir-com-codigo/ai-assistant.md) estar ativado. Se não estiver, o Creator Hub diz-te onde o ativar em vez de abrir o chat.
{% endhint %}


---

# 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/trigger-area.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.
