> 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). # Modifier Areas Use modifier areas no Scene Editor para alterar o comportamento do avatar ou forçar um camera mode dentro de uma região da sua scene. As modifier areas são regiões invisíveis que alteram a forma como os jogadores experienciam parte da sua scene. Existem dois tipos: * **Avatar Modifier Area**: Altera como os avatars se comportam ou aparecem para os jogadores dentro da região, por exemplo ocultando avatars ou desativando popups de passaporte. * **Camera Modifier Area**: Força a câmera do jogador para first person ou third person enquanto ele estiver dentro da região. Ambos os tipos voltam ao comportamento normal quando o jogador sai. ## Adicionar uma modifier area Você pode adicionar uma modifier area de duas maneiras: **No asset catalog:** Abra o asset catalog e procure por **Avatar Modifier Area** ou **Camera Modifier Area** na **Utils** categoria. Arraste-o para a scene. O item aparece como um cubo de placeholder translúcido que só é visível no editor, não na scene em execução. **No menu de components:** Selecione qualquer entity existente, clique no **+** botão no topo do properties panel e escolha **Avatar Modifier Area** ou **Camera Modifier Area** na lista. Veja [Add components](/creator/content-creator-pt/scene-editor/construir/components.md#add-components) para mais detalhes. ![O menu Add component aberto numa entity chamada Stage area, listando components sob os 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-6a35142910f0343c27340673c61d75ed5f75f05a%2Fadd-component.png?alt=media) ## Dimensionar a area O tamanho de uma modifier area é controlado pelo **Transform scale**. Se você dimensionar a entity para 4 x 3 x 4, a região modifier torna-se uma caixa de 4 x 3 x 4 metros centrada na posição da entity. Use o gizmo de scale ou digite valores exatos no componente Transform para definir o tamanho de que você precisa. {% hint style="warning" %} **Nota:** Não existe um campo separado "Area" no properties panel. O editor mantém automaticamente a propriedade interna da area sincronizada com a escala da entity, então redimensionar a entity é tudo o que você precisa fazer. {% endhint %} ## Avatar Modifier Area O painel Avatar Modifier Area tem duas configurações: ![O painel do componente Avatar Modifier Area, com um menu suspenso Modifiers mostrando Hide Avatars selecionado, uma seçã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-43c3143c3e75e9ead736fcab3199e6eabeb53d1d%2Favatar-modifier-area-component.png?alt=media) ### Modifiers Um menu suspenso de múltipla seleção com as seguintes opções: * **Hide Avatars**: Os avatars dentro da área ficam invisíveis. Os jogadores dentro não conseguem se ver uns aos outros, mas os jogadores fora da área ainda os veem normalmente. * **Disable Passports**: Clicar no avatar de um jogador dentro da área já não abre o popup do perfil dele. Você pode selecionar um ou ambos os modifiers na mesma area. Quando você adiciona o componente, **Hide Avatars** está selecionado por padrão. Clique no **x** em um modifier para removê-lo. ### Exclude Player IDs Uma lista de endereços de wallet que não são afetados pelos modifiers. Os jogadores cujo endereço está nesta lista se comportam normalmente mesmo dentro da área. Clica 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 **Remove Player ID**. Isso é útil para eventos em que você quer ocultar os avatars da plateia num palco, mas manter os performers visíveis. {% hint style="warning" %} **Nota:** Certifique-se de que os endereços de wallet estejam em minúsculas. A modifier area usa correspondência exata de strings. {% endhint %} ### Casos de uso * **Zonas de privacidade**: Oculte os avatars nos bastidores ou em uma área de troca. * **Palcos limpos**: Oculte os avatars da plateia num palco para que apenas os performers (listados em Exclude Player IDs) fiquem visíveis. * **Arenas de jogo**: Desative os passports numa área de combate para que os jogadores não abram perfis acidentalmente durante a jogabilidade. ## Camera Modifier Area O painel Camera Modifier Area tem uma configuração: ![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-4b25e231dcd2e4d14dfdadf7b942f94e16ad55f4%2Fcamera-modifier-area-component.png?alt=media) ### Camera Mode Um menu suspenso com duas opções: * **First Person**: Força a visão em first person para o jogador enquanto estiver dentro da área. * **Third Person**: Força a visão em third person para o jogador enquanto estiver dentro da área. O padrão é **First Person**. Quando um 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 da alternância entre first person e third person, use uma [Virtual Camera](/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 first person para facilitar cliques precisos em objetos pequenos. * **Mirantes panorâmicos**: Force third person para que os jogadores possam ver o seu avatar contra o pano de fundo. * **Zonas de tutorial**: Garanta que todos os jogadores usem o mesmo modo de câmera durante uma experiência guiada. ## Combinando modifier areas Você pode colocar os dois tipos de modifier area na mesma entity ou sobrepor modifier areas separadas no mesmo espaço. Cada área aplica seus efeitos independentemente. {% hint style="warning" %} **Nota:** Mantenha baixo o número de modifier areas na sua scene. Muitas podem afetar o desempenho. Um punhado é suficiente para a maioria das scenes. {% endhint %} ## Usando modifier areas com código Os components do Scene Editor correspondem diretamente ao SDK7 `AvatarModifierArea` e `CameraModeArea` components. Para ver detalhes completos sobre os modifiers disponíveis, o comportamento em runtime e opções avançadas como alterar dinamicamente a lista de exclusão, veja: * [Avatar modifier areas](/creator/content-creator-pt/scenes-sdk7/interatividade/avatars/modifier-areas.md) (SDK7) * [Camera mode areas](/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 dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://docs.decentraland.org/creator/content-creator-pt/scene-editor/interatividade/modifier-areas.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.