> 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 modifier areas são regiões invisíveis que alteram a forma como os players experienciam parte da sua scene. Há dois tipos: * **Avatar Modifier Area**: Altera como os avatars se comportam ou aparecem para os players dentro da região, por exemplo ocultando avatars ou desativando pop-ups do Passport. * **Camera Modifier Area**: Força a câmera do player para primeira pessoa ou terceira pessoa enquanto ele estiver dentro da região. Ambos os tipos voltam ao comportamento normal quando o player sai. ## Adicionar uma modifier area Você pode adicionar uma modifier area de duas formas: **Do catálogo de assets:** Abra o catálogo de assets e procure por **Avatar Modifier Area** ou **Camera Modifier Area** na **Utils** categoria. Arraste-o para a scene. O item aparece como um cubo provisório 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 **+** button no topo do properties panel e escolha **Avatar Modifier Area** ou **Camera Modifier Area** na lista. Veja [Adicionar 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 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-6a35142910f0343c27340673c61d75ed5f75f05a%2Fadd-component.png?alt=media\&token=a3fb4e60-b24d-4e2a-b9b8-45d7db23aee0) ## Dimensionar a área O tamanho de uma modifier area é controlado pela **Transform scale**. Se dimensionar a entity para 4 x 3 x 4, a região do modifier torna-se uma caixa de 4 x 3 x 4 metros centrada na posição da entity. Use o gizmo de scale ou introduza valores exatos no componente Transform para definir o tamanho de que precisa. {% hint style="warning" %} **Observação:** Não existe um campo separado "Area" no properties panel. O editor mantém a propriedade interna area sincronizada com a scale da entity automaticamente, por isso redimensionar a entity é tudo o que precisa fazer. {% endhint %} ## Avatar Modifier Area O painel Avatar Modifier Area tem duas definições: ![O painel do component Avatar Modifier Area, com um dropdown Modifiers mostrando Hide Avatars selecionado, uma secção Exclude Player IDs e um button 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\&token=d81790d6-c6ab-4736-8eeb-15a1c1e887fd) ### Modificadores Um dropdown de multi-seleção com as seguintes opções: * **Ocultar Avatares**: Os avatars dentro da área tornam-se invisíveis. Os players dentro não conseguem ver uns aos outros, mas os players fora da área ainda os veem normalmente. * **Desativar Passports**: Clicar no avatar de um player dentro da área já não abre o pop-up do perfil. Pode selecionar um ou ambos os modifiers na mesma área. Quando adicionar o component, **Ocultar Avatares** está selecionado por defeito. Clique no **x** num modifier para o remover. ### IDs de Player excluídos Uma lista de endereços de wallet que não são afetados pelos modifiers. Os players cujo endereço está nesta lista comportam-se normalmente mesmo dentro da área. Clique em **Adicionar ID de Player** para adicionar uma entrada, depois cole o endereço da wallet. Para remover uma, clique no menu de três pontos ao lado dela e selecione **Remover ID de Player**. Isto é útil para eventos em que quer ocultar os avatars da audiência num palco, mas manter os performers visíveis. {% hint style="warning" %} **Observação:** Certifique-se de que os endereços da wallet estão em minúsculas. A modifier area usa correspondência exata de strings. {% endhint %} ### Casos de uso * **Zonas de privacidade**: Oculte avatars numa zona de bastidores ou de mudança. * **Palcos limpos**: Oculte os avatars da audiência 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 players não abram perfis por engano durante o gameplay. ## Camera Modifier Area O painel Camera Modifier Area tem uma definição: ![O painel do component Camera Modifier Area, com um dropdown Camera Mode definido para 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\&token=4967a8a8-9658-481c-b84e-2de3b2a6bf25) ### Camera Mode Um dropdown com duas opções: * **First Person**: Força o player a usar a vista em primeira pessoa enquanto estiver dentro da área. * **Third Person**: Força o player a usar a vista em terceira pessoa enquanto estiver dentro da área. A predefinição é **First Person**. Quando um player sai da área, o seu 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 para além da alternância entre primeira/terceira pessoa, 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 puzzle**: Force a primeira pessoa para clicar com precisão em objetos pequenos. * **Miradouros panorâmicos**: Force a terceira pessoa para que os players possam ver o seu avatar contra o pano de fundo. * **Zonas de tutorial**: Garanta que todos os players usam o mesmo modo de câmera durante uma experiência guiada. ## Combinar modifier areas Pode colocar ambos os tipos de modifier area na mesma entity, ou sobrepor modifier areas separadas no mesmo espaço. Cada área aplica os seus efeitos de forma independente. {% hint style="warning" %} **Observação:** Mantenha o número de modifier areas na sua scene baixo. Demasiadas podem afetar o desempenho. Umas poucas estão bem para a maioria das scenes. {% endhint %} ## Usar modifier areas com código Os components do Scene Editor correspondem diretamente aos components do SDK7 `AvatarModifierArea` e `CameraModeArea` components. Para obter detalhes completos sobre os modifiers disponíveis, o comportamento em runtime e opções avançadas como alterar dinamicamente a lista de exclusão, consulte: * [Avatar modifier areas](/creator/content-creator-pt/scenes-sdk7/interatividade/avatares/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 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=&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.