> 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/modifier-areas.md).

# Áreas de Modificador

Use áreas de modificador no Scene Editor para alterar o comportamento do avatar ou forçar um modo de câmera dentro de uma região da sua scene.

As áreas de modificadores são regiões invisíveis que alteram a forma como os jogadores experienciam parte da sua cena. Existem dois tipos:

* **Avatar Modifier Area**: Altera o comportamento ou a aparência dos avatares para os jogadores que estão dentro da região, por exemplo, ocultando avatares ou desativando as janelas pop-up do passaporte.
* **Camera Modifier Area**: Força a câmara do jogador a usar a primeira ou a terceira pessoa enquanto este está dentro da região.

Ambos os tipos voltam ao comportamento normal quando o jogador sai da região.

## Adicionar uma área de modificadores

Pode adicionar uma área de modificadores de duas formas:

**A partir do catálogo de assets:** Abra o catálogo de assets e procure **Avatar Modifier Area** ou **Camera Modifier Area** na categoria **Utils** . Arraste-a para a cena. O item aparece como um cubo de substituição translúcido, visível apenas no editor e não na cena em execução.

**A partir do menu de componentes:** Selecione qualquer Entity existente, clique no botão **+** na parte superior do painel de propriedades e escolha **Avatar Modifier Area** ou **Camera Modifier Area** na lista. Consulte [Adicionar componentes](https://docs.decentraland.org/creator/content-creator-pt/scene-editor/construir/components.md#add-components) para obter mais detalhes.

![O menu para adicionar componentes aberto numa Entity chamada Stage area, com componentes listados nos grupos 3D Content e Interaction, incluindo Avatar Modifier Area e Camera Modifier Area.](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)

## Definir o tamanho da área

O tamanho de uma área de modificadores é controlado pela **escala do Transform**. Se definir a escala da Entity como 4 x 3 x 4, a região de modificadores torna-se uma caixa de 4 x 3 x 4 metros, centrada na posição da Entity. Use o gizmo de escala ou introduza valores exatos no componente Transform para definir o tamanho pretendido.

{% hint style="warning" %}
**Nota:** Não existe um campo «Area» separado no painel do editor. O editor mantém automaticamente a propriedade interna da área sincronizada com a escala da Entity, pelo que basta redimensionar a Entity.
{% endhint %}

## Avatar Modifier Area

O painel Avatar Modifier Area tem duas definições:

![O painel do componente Avatar Modifier Area, com um menu pendente Modifiers que mostra Hide Avatars selecionado, uma secção Exclude Player IDs e um botão Add Player ID.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-1ec168b1d049a28a6e43815dc799a57997d87af8%2Favatar-modifier-area-component.webp?alt=media)

### Modifiers

Um menu pendente de seleção múltipla com as seguintes opções:

* **Hide Avatars**: Os avatares dentro da área tornam-se invisíveis. Os jogadores que estão dentro não se conseguem ver uns aos outros, mas os jogadores fora da área continuam a vê-los normalmente.
* **Disable Passports**: Clicar no avatar de um jogador dentro da área deixa de abrir a janela pop-up do perfil desse jogador.

Pode selecionar um ou ambos os modificadores na mesma área. Quando adiciona o componente, **Hide Avatars** fica selecionado por predefinição. Clique no **x** de um modificador para o remover.

### Exclude Player IDs

Uma lista de endereços de carteira que não são afetados pelos modificadores. Os jogadores cujo endereço consta desta lista comportam-se normalmente mesmo quando estão dentro da área.

Clique em **Add Player ID** para adicionar uma entrada e, em seguida, cole o endereço da wallet. Para remover uma, clique no menu de três pontos ao lado dela e selecione **Remover ID do jogador**.

Isso é útil em eventos nos quais você deseja ocultar os Avatars do público em um palco, mas manter os artistas visíveis.

{% hint style="warning" %}
**Observação:** Certifique-se de que os endereços das wallets estejam em letras minúsculas. A área de modificador usa correspondência exata de strings.
{% endhint %}

### Casos de uso

* **Zonas de privacidade**: ocultar Avatars em uma área de bastidores ou camarim.
* **Palcos sem público**: ocultar os Avatars do público em um palco para que apenas os artistas (listados em Exclude Player IDs) fiquem visíveis.
* **Arenas de jogos**: desativar os passaportes em uma área de combate para que os jogadores não abram perfis acidentalmente durante o jogo.

## Área de modificador da câmera

O painel Camera Modifier Area tem uma configuração:

![Painel do componente Camera Modifier Area, com um menu suspenso Camera Mode definido como First Person.](https://2402076176-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FoPnXBby9S6MrsW83Y9qZ%2Fuploads%2Fgit-blob-c102f8a50a07268c75d75aeaa01414e74b112855%2Fcamera-modifier-area-component.webp?alt=media)

### Camera Mode

Um menu suspenso com duas opções:

* **First Person**: força o jogador a usar a perspectiva em primeira pessoa enquanto estiver dentro da área.
* **Third Person**: força o jogador a usar a perspectiva em terceira pessoa enquanto estiver dentro da área.

O padrão é **First Person**. Quando o jogador sai da área, o modo de câmera anterior é restaurado.

{% hint style="info" %}
**Dica:** O modo de câmera cinematográfica não está disponível aqui. Para controlar a câmera além de alternar entre primeira e terceira pessoa, use uma [Virtual Camera](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/camera.md#using-virtual-cameras) com código.
{% endhint %}

### Casos de uso

* **Corredores estreitos ou salas de quebra-cabeça**: force a perspectiva em primeira pessoa para clicar com precisão em objetos pequenos.
* **Miradouros**: force uma perspectiva em terceira pessoa para que os jogadores possam ver o Avatar contra o cenário.
* **Zonas de tutorial**: garanta que todos os jogadores usem o mesmo modo de câmera durante uma experiência guiada.

## Combinar áreas de modificador

Você pode colocar os dois tipos de área de modificador na mesma entidade ou sobrepor áreas de modificador separadas no mesmo espaço. Cada área aplica seus efeitos de forma independente.

{% hint style="warning" %}
**Observação:** Mantenha baixo o número de áreas de modificador na sua cena. Muitas áreas podem afetar o desempenho. Algumas são suficientes para a maioria das cenas.
{% endhint %}

## Usar áreas de modificador com código

Os componentes do Scene Editor correspondem diretamente aos componentes do SDK7 `AvatarModifierArea` e `CameraModeArea` . Para ver todos os detalhes sobre os modificadores disponíveis, o comportamento em runtime e opções avançadas, como alterar dinamicamente a lista de exclusão, consulte:

* [Áreas de modificador de Avatar](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/modifier-areas.md) (SDK7)
* [Áreas de modo de câmera](https://docs.decentraland.org/creator/content-creator-pt/scenes-sdk7/fundamentos-de-conteudo-3d/camera.md#1st-and-3rd-person-camera-modes) (SDK7)


---

# 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/modifier-areas.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.
