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 um jogo. 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/colapsar apenas aquele ramo.

Para mudar o pai de um ou mais filhos (reparentar), basta arrastá-los e soltá-los sobre o 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 passando o mouse sobre o pai pretendido e clicando 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 no 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 Copy e Duplicate, além de opções específicas para Models, como Ungroup. 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

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 múltiplos objetos AudioPlayer dentro dela.

Você pode organizar objetos em pastas da seguinte forma:

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

• Selecione múltiplos objetos, clique com o botão direito neles e então selecione Group As a Folder no menu de contexto (atalho de AltCtrlG no Windows ou ⌥⌘G no Mac).

Métodos de pesquisa

Através do campo de pesquisa próximo ao topo da janela, você pode encontrar instâncias por nome, propriedade, classe/subclasse/tag personalizada 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 resulta em instâncias correspondentes por nome, sem diferenciaçã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 por 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ços e não diferencia maiúsculas de minúsculas.

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

Pesquisa personalizada

Classes, subclasses e tags são pesquisadas através 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á marcado 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 para pesquisas altamente específicas ou usar * como um 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 à programação.

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

• * atua como um 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 são nomeados 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 são totalmente 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, unidos por or, encontram tudo dentro de múltiplas 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 teclas e operações com o 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 select all seleciona apenas os objetos que correspondem à consulta, por exemplo, todos os objetos que correspondem a Board em uma hierarquia pesquisada por board.

Seleção com Shift

Clicar em um objeto e Shift-clicar 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, Shift-clicar 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 de hierarquia, como mostrado na imagem 🅰 onde LeftFoot é inicialmente clicado, LeftLowerArm é Shift-clicado, e LeftHand 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 níveis de hierarquia diferentes, todos os objetos entre eles serão selecionados, como mostrado na imagem 🅱 onde LeftFoot é inicialmente clicado, LeftHand é Shift-clicado, e tudo entre também é selecionado.

Seleção por arrasto

Clicar e arrastar 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 teclas