For the complete documentation index, see llms.txt. This page is also available as Markdown.

Á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 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.

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.

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.

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.

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.

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.

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 com código.

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.

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:

Atualizado