Janela do Explorer

A janela Explorer, acessível pelo menu Window do Studio ou pela barra de ferramentas da aba Home, mostra uma lista hierárquica de cada instância dentro de uma experiência. No nível mais alto da hierarquia estão os serviços; Workspace, por exemplo, é onde o conteúdo 3D visível, como partes, é armazenado.

Hierarquia pai-filho

Todos os filhos de um objeto pai aparecem sob seu ramo quando expandido. Clique na seta ao lado de um ramo pai — ou pressione as teclas de seta →/← quando um pai estiver selecionado — para expandir/retrair apenas aquele ramo.

Para mudar o pai de uma ou mais crianças (reatribuir), basta arrastá-las e soltá-las no novo pai.

Inserção de objetos

Enquanto partes primitivas podem ser inseridas a partir das barras de ferramentas da aba Home ou Model, você pode selecionar uma gama completa de objetos ao passar o mouse sobre o pai pretendido e clicar no botão ⊕ (atalho de CtrlI no Windows ou ⌘I no Mac).

Você pode personalizar ainda mais o comportamento de inserção clicando no botão ⋯ à direita do campo de pesquisa:

Duplicar e colar

Objetos podem ser rapidamente duplicados dentro do mesmo ramo, enquanto itens copiados para a área de transferência podem ser colados no ramo de nível superior Workspace ou diretamente em um ou mais pais existentes.

Opções contextuais

Clicar com o botão direito em uma instância abre o menu de opções, ajustado contextualmente para o tipo de objeto. Por exemplo, clicar com o botão direito em um Model revela opções padrão como Copiar e Duplicar, e também opções específicas para Models, como Desagrupar. Em contraste, clicar com o botão direito em um serviço como Lighting revela um menu mais conciso de ações válidas para serviços.

Organização de pastas

Assim como diretórios/pastas em um computador, o objeto Folder é uma maneira útil de organizar objetos. Por exemplo, se você quiser armazenar todos os ativos de áudio ambiental em um lugar lógico, pode criar uma pasta e colocar vários objetos AudioPlayer dentro dela.

Você pode organizar objetos em pastas da seguinte maneira:

• Crie uma instância de Folder através de um método de inserção padrão e, em seguida, arraste e solte objetos existentes dentro dela.

• Selecione múltiplos objetos, clique com o botão direito neles e depois selecione Agrupar como uma Pasta no menu de contexto (atalho de AltCtrlG no Windows ou ⌥⌘G no Mac).

Métodos de pesquisa

Por meio do campo de pesquisa próximo ao topo da janela, você pode encontrar instâncias por nome, propriedade, consultas personalizadas de classe/subclasse/tag e consultas de ancestralidade. Você também pode combinar parâmetros para pesquisas lógicas avançadas. Acesse rapidamente este campo pressionando CtrlShiftX (Windows) ou ⌘ShiftX (Mac).

Navegar para cima e para baixo pelos resultados da pesquisa

Selecionar todos os resultados da pesquisa (CtrlA no Windows ou ⌘A no Mac)

Atualizar resultados da pesquisa

Pesquisa por nome

Digitar uma string básica gera instâncias correspondidas por nome, sem distinção entre maiúsculas e minúsculas. Por exemplo, pesquisar pela palavra-chave script encontra todas as instâncias que a contêm, como ServerScriptService e LocalScript.

Pesquisa de propriedade

Você pode filtrar por igualdade de propriedade ou comparações de valor. A maioria das propriedades é suportada, funciona com correspondências parciais, ignora espaçamento e é sem distinção entre maiúsculas e minúsculas.

A igualdade da propriedade é pesquisada através dos operadores = ou ==.

Pesquisa personalizada

Classes, subclasses e tags são pesquisadas por meio de várias consultas personalizadas, incluindo:

• is:[Class] encontra tudo que é da classe [Class]. Por exemplo, is:Part encontra tudo que é um Part.
• is:[SubClass] encontra tudo que é uma subclasse de [SubClass]. Por exemplo, is:BasePart encontra tudo que é uma subclasse de BasePart, como Part e MeshPart.
• tag:[TagName] encontra tudo com uma tag de CollectionService de [TagName]. Por exemplo, tag:LightSource encontra tudo que está etiquetado como LightSource. Você pode adicionar tags usando a seção Tags das propriedades de uma instância e os nomes das tags serão completados automaticamente.

Pesquisa de ancestralidade

Você pode pesquisar dentro de um escopo específico usando o operador . , encadear operadores juntos para pesquisas altamente específicas, ou usar * como um caractere curinga.

• [Parent].[Child] encontra filhos nomeados dentro de um pai nomeado. Por exemplo, workspace.Model encontra instâncias nomeadas Model dentro de instâncias nomeadas workspace, semelhante ao scripting.

• Encadear operadores . adiciona especificidade. Por exemplo, Animals.Dog.Tail encontra objetos nomeados Tail dentro de Dog dentro de Animals.

• * atua como um caractere curinga, por exemplo:

  Exemplo	Resultado
  Cart.*	Todos os filhos de um objeto nomeado Cart.
  Cart.Barrier.*	Todos os filhos de Barrier, que é um filho de Cart.
  Cart.*.*	Todos os netos de Cart, excluindo filhos diretos de Cart.
  Cart.*.Trim	Todos os netos de Cart que se chamam Trim.

• [Parent].** encontra todos os descendentes de um pai. Por exemplo, CarModel.** encontra todos os descendentes de CarModel.

Combinado

Para pesquisas lógicas avançadas, você pode combinar consultas através de uniões e agrupamentos.

• Múltiplas consultas separadas por espaços ou and operam em todas as condições.

  Exemplo	Resultado
  Anchored=true CanCollide=true	Todo BasePart que está ancorado e pode colidir.
  Cart.*.* Transparency < 1	Todos os netos de Cart que não estão completamente transparentes.
  Anchored=false and CanCollide=false	Todo BasePart que não está ancorado e não pode colidir.

• A conjunção or opera exatamente como o operador or no código. Grupos dentro de parênteses, ligados por or, encontram tudo dentro de várias consultas combinadas.

  Exemplo	Resultado
  Cat or Dog	Tudo que tem Cat ou Dog em seu nome.
  (Anchored=true CanCollide=true) or (Anchored=false CanCollide=false)	Todo BasePart que ou está ancorado e pode colidir, ou não está ancorado e não pode colidir.

Métodos de seleção

Dentro de uma hierarquia pesquisada, certos atalhos de teclados e operações de mouse se comportam de maneira diferente do que em uma hierarquia não pesquisada.

Selecionar tudo

Dentro de uma hierarquia não pesquisada, pressionar CtrlA no Windows ou ⌘A no Mac seleciona todas as instâncias. Dentro de uma hierarquia pesquisada, o mesmo atalho ou o botão selecionar tudo seleciona apenas os objetos correspondentes à consulta, por exemplo, todos os objetos correspondentes a Board em uma hierarquia pesquisada para board.

Seleção por Shift

Clique em um objeto e clique com o botão Shift em outro objeto se comporta de maneira diferente dentro de uma hierarquia não pesquisada em comparação com uma hierarquia pesquisada.

Dentro de uma hierarquia não pesquisada, clicar e pressionar Shift em dois objetos no mesmo nível de hierarquia seleciona ambos e todos os objetos entre eles que também estão no mesmo nível hierárquico, como mostrado na imagem 🅰 onde LeftFoot é inicialmente clicado, LeftLowerArm é clicado com Shift e LeftHand, que está no mesmo nível de hierarquia, também é selecionado. Duplicar, copiar ou colar os objetos selecionados resultará em uma cópia profunda desses objetos e todos os filhos.

Se o primeiro objeto clicado com Shift e o segundo objeto clicado com Shift estiverem em diferentes níveis hierárquicos, todos os objetos entre eles serão selecionados, como mostrado na imagem 🅱 onde LeftFoot é inicialmente clicado, LeftHand é clicado com Shift e tudo entre também é selecionado.

Seleção por arrasto

Clicar e arrastar a partir de uma região vazia da janela inicia uma caixa de seleção. Dentro de uma hierarquia não pesquisada, tudo dentro da caixa é selecionado. Dentro de uma hierarquia pesquisada, apenas os objetos correspondentes à consulta dentro da caixa são selecionados.

Atalhos de teclados