> 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, use uma Trigger Area [smart item](https://docs.decentraland.org/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-43dc86c2583a9d24ad70791dc7cdbdc7d4462d0c%2Ftrigger.webp?alt=media)

O cubo laranja que vê enquanto edita a sua scene só está visível no Scene Editor; fica invisível quando executa uma pré-visualização da scene. Pode ajustar e redimensionar facilmente o cubo laranja para cobrir exatamente a área de que precisa.

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

Se alguma parte do avatar do jogador se sobrepuser 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 de outros jogadores — cada jogador ativa o trigger na sua própria instância da scene.

{% hint style="info" %}
**💡 Dica**: Se as trigger areas da sua scene começarem a atrapalhar a edição de outros conteúdos, lembre-se de que pode sempre bloqueá-las e/ou ocultá-las na [Entity Tree](https://docs.decentraland.org/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-904b0f80a11ab2704ee6162f9879b365f1dbc165%2Fhide-trigger.webp?alt=media" alt="" data-size="original">
{% endhint %}

Várias trigger areas podem sobrepor-se sem se afetarem.

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

### Definições

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

| Campo           | O que faz                              | Opções                                                                                      | Predefinição |
| --------------- | -------------------------------------- | ------------------------------------------------------------------------------------------- | ------------ |
| **Ativado por** | O que ativa a área.                    | `my player`, `all players`, `any collider`, `clickable`, `custom 1`, `custom 2`, `custom 3` | `my player`  |
| **Forma**       | Se o volume é uma caixa ou uma esfera. | `box`, `sphere`                                                                             | `box`        |

`my player` reage apenas ao avatar do jogador que está a executar a scene. `all players` reage a qualquer avatar, incluindo os de outras pessoas na scene. As restantes opções correspondem a outras [collision layers](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/colliders.md), para que possa fazer a área reagir a objetos físicos, a objetos clicáveis ou às suas próprias layers personalizadas.

Alternar **Forma** altera o elemento temporário do editor entre uma caixa e uma esfera, para que o volume que vê durante a edição corresponda ao volume que obterá.

### Descreva o que deve acontecer

A área ativa dois eventos: **enter** e **exit**. Na secção **Reactions** do componente Script, há um botão para cada um:

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

Clique num deles e o Creator Hub escreve o início de uma frase na caixa de mensagem do AI Assistant, indicando o item, por exemplo `When a player enters "Trigger Area",` . O pedido usa o nome do item que vê na árvore de entidades. Termine a frase com o que pretende que aconteça e envie-a. O assistente escreve um script separado e associa-o à mesma entidade, juntamente com o detetor.

Os três chips junto aos botões (**Reproduzir um som**, **Mostrar uma mensagem**, **Marcar pontos**) completam uma frase por si, para que possa enviá-los tal como estão.

{% hint style="info" %}
**💡 Dica**: Para que as reações funcionem, é necessário que o [AI Assistant](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/expandir-com-codigo/ai-assistant.md) esteja ativado. Se não estiver, o Creator Hub indica-lhe onde o pode ativar, em vez de abrir a conversa.
{% 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.
