Pacotes

Para manter os ativos organizados e reutilizáveis em sua equipe ou em vários projetos, você pode agrupar suas instâncias e convertê-las em pacotes reutilizáveis. Os pacotes tornam o processo geral de construção de mundos mais rápido e ergonômico, mas também ajudam com consistência, deduplicação, colaboração e versionamento:

• Atualize facilmente todas as cópias de um pacote para a versão mais recente, ou apenas atualize cópias específicas.
• Defina pacotes para atualizar automaticamente sempre que houver uma nova versão.
• Dê permissões de Edição ou Uso aos colaboradores para o conteúdo de um pacote.
• Veja o histórico completo de versões de um pacote, compare versões e restaure versões antigas.

O fluxo de trabalho mais eficiente é criar um pacote, compartilhá-lo com quaisquer colaboradores e defini-lo para autoatualização. E você não precisa esperar que um modelo esteja "pronto" antes de usá-lo em um pacote. Mesmo que o pacote seja um espaço reservado em cima de uma forma simples, você pode usá-lo para greyboxar seu ambiente e, em seguida, ter as cópias de espaço reservado atualizadas automaticamente à medida que você publica versões mais detalhadas.

Criar pacotes

Você pode criar um pacote a partir de qualquer objeto único ou qualquer ramo de pai e filhos de objetos. Se você quiser criar um pacote para um único objeto, adicione-o a um agrupamento Model primeiro, para que você possa adicionar, remover ou escalar objetos filhos dentro do pacote mais tarde, sem quebrar o pacote.

Para criar um pacote:

1. Na janela Explorer ou na visualização 3D, clique com o botão direito do mouse no(s) objeto(s) que você deseja transformar em um pacote e, no menu contextual, selecione Converter em Pacote.

2. Na nova janela, preencha os detalhes do pacote. Em particular, se você estiver trabalhando em um grupo, defina a Propriedade para o grupo apropriado no qual você tem permissão para criar/editar jogos de grupo.

   Transferências de propriedade não são suportadas pelo sistema de ativos, então considere cuidadosamente o proprietário ao criar um pacote.

3. Clique em Enviar.

4. Após a conversão ser concluída, o objeto recebe um símbolo de "link de corrente" na janela Explorer para identificá-lo como um pacote. Além disso, você pode ver um novo objeto PackageLink parentado ao objeto.

   

5. OPCIONAL

   Selecione o objeto PackageLink e habilite AutoUpdate na janela Propriedades. Note como o ícone muda para indicar que o pacote está definido para atualizar automaticamente.

Inserir pacotes

Para inserir um pacote que ainda não existe no lugar atual, você deve inicialmente inseri-lo a partir da Toolbox:

• De Inventário ⟩ Meus Pacotes para pacotes que você publicou ou obteve da Loja do Criador, bem como pacotes que um amigo possui e lhe deu permissões para usar.
• De Criações ⟩ Pacotes de Grupo para pacotes publicados por membros do seu grupo (incluindo você mesmo).

Uma vez que você tenha inserido um pacote no modelo de dados de um lugar publicado, ele aparece no Gerenciador de Ativos e permanece lá mesmo que você exclua todas as cópias dele mais tarde.

Modificar pacotes

Você pode editar pacotes e seus filhos como outros objetos. Modificar pacotes desabilita a autoatualização até que você publique ou reverta as alterações.

A maioria das edições marca o pacote como modificado, embora as seguintes alterações não sejam consideradas modificações de pacote:

• Alterar o nome do nó raiz.
• Alterar a posição ou rotação do nó raiz de um pacote que é um BasePart, Model ou GuiObject.
• Alterar a propriedade Enabled de um nó raiz GuiObject, como um ScreenGui, SurfaceGui ou BillboardGui.
• Alterar uma referência de parte de um Weld dentro do pacote que referencia uma instância fora do pacote.

Uma vez modificado, pacotes com alterações não publicadas recebem um ícone modificado na janela Explorer:

Adicionar ou atualizar configurações

Você pode incluir atributos de instância na raiz de um pacote para personalizar seu comportamento. Quando você publica um pacote, o conjunto atual de atributos/valores se tornará as configurações padrão do pacote. Em qualquer cópia de um pacote, esses valores de atributo podem ser alterados em uma base por instância, e essas alterações são notadas através de itálico em negrito. Quando as cópias do pacote são atualizadas, os valores de configuração modificados serão preservados, enquanto outros atributos serão atualizados para o valor padrão mais recente.

Pacotes aninhados

Você pode aninhar pacotes dentro de outros pacotes para manter e colaborar em hierarquias complexas, como uma série de mecânicas de veículos que podem ser modificadas independentemente do pacote pai do veículo.

Se você modificar um pacote aninhado, tanto o pacote aninhado quanto o pacote pai são considerados como modificados. Você deve publicar alterações em qualquer pacote aninhado antes de poder publicar alterações em seu pacote pai, uma vez que publicar o pai marcaria como atual/não modificado e entraria em conflito com as modificações do pacote aninhado.

Scripts de pacote

Cada script dentro de um pacote não modificado é somente leitura e mostra uma notificação na parte superior com um hyperlink para desbloquear o script.

Clicar no hyperlink:

• Marca o pacote como modificado, independentemente de você editar o script.
• Remove a notificação/hyperlink de outros scripts dentro do pacote.

Uma vez que o pacote é publicado e movido para um estado não modificado, os scripts sob ele se tornam somente leitura com um hyperlink para modificar.

Publicar alterações de pacote

Você pode publicar qualquer alteração em um pacote como uma nova versão, tornando suas atualizações disponíveis para outras cópias de pacote em todo o lugar e em todos os jogos. Não é obrigatório publicar um pacote modificado antes de publicar um lugar, pois a versão modificada é salva junto com o lugar para iterações futuras.

Para publicar alterações em um pacote:

1. Na janela Explorer ou na visualização 3D, clique com o botão direito do mouse na cópia modificada e selecione Publicar para Pacote.

2. Se uma cópia de pacote tiver autoatualização ativada, ela imediatamente puxa a versão atualizada quando você abre o lugar que as contém. Outras cópias recebem um símbolo de "download" que indica que uma atualização está disponível. Você pode atualizar individualmente ou atualizar em massa todas as cópias.

   

3. OPCIONAL

   Adicione uma descrição de suas alterações:

   1. Clique com o botão direito do mouse no pacote e selecione Detalhes do Pacote.
   2. Na janela Configuração de Ativo, selecione Versões.
   3. Sob sua alteração mais recente, selecione Adicionar.
   4. Descreva suas alterações e clique no botão Enviar.

Atualizar cópias desatualizadas

Você pode atualizar cópias desatualizadas de pacotes para a versão mais recente, ou pode continuar a usar a versão mais antiga.

1. Na janela Explorer, localize cópias desatualizadas pelo símbolo de "download". Você também pode selecionar a cópia desatualizada na visualização 3D.

   

2. Clique com o botão direito do mouse em uma cópia desatualizada e selecione Obter Pacote Mais Recente. Você também pode selecionar vários pacotes, clicar com o botão direito e Obter o Mais Recente para Pacotes Selecionados.

Atualizações em massa

O uso extensivo de pacotes pode resultar em muitas cópias de pacotes em vários lugares em um jogo. Além de sincronização individual e atualizações automáticas, você pode atualizar todas as cópias de um pacote através de atualizações em massa.

1. RECOMENDADO

   Feche outras instâncias do Studio com qualquer um dos lugares do jogo aberto; isso evita que outra instância não salva de um lugar sobrescreva suas atualizações.
2. Na janela Explorer ou na visualização 3D, clique com o botão direito do mouse no pacote desejado e selecione Atualizar Todos.
3. Escolha todos os lugares no jogo ou algum subconjunto de lugares e clique em Atualizar.

Atualizações automáticas

Para facilitar a sincronização, você pode definir uma cópia de pacote para atualizar automaticamente sempre que uma versão mais nova for publicada. A autoatualização das cópias de pacote ocorrerá quando um lugar for aberto no Studio.

1. Na janela Explorer, expanda a árvore de hierarquia do pacote e selecione seu objeto PackageLink.

   

2. Na janela Propriedades, habilite a propriedade AutoUpdate. Se você tiver pacotes aninhados, essa propriedade se aplica apenas ao pacote pai de nível mais alto, o que significa que as atualizações automáticas ocorrem apenas quando o pacote pai é atualizado.

Compartilhar e níveis de acesso

Você pode conceder permissão a amigos, jogos, grupos ou funções de usuário de grupo específicas para que possam usar seus pacotes livremente em suas criações. Para mais informações sobre acesso a ativos, veja Privacidade de Ativos.

Para alterar as permissões do pacote para um colaborador, como um amigo ou grupo:

1. Na janela Explorer, Toolbox ou Gerenciador de Ativos, clique com o botão direito do mouse no pacote desejado e selecione Opções do Pacote ⟩ Detalhes do Pacote.

2. Na janela Configuração de Ativo, selecione Permissões.

3. Usando a barra de pesquisa, insira e selecione um colaborador ao qual você deseja conceder permissão para usar seu pacote, e então escolha um nível de permissão.

   Permissão	Descrição
   Usar & Visualizar	O colaborador pode usar e visualizar (mas não editar) as versões atuais e anteriores do pacote. Uma vez que você forneça a um colaborador essa capacidade, não poderá revogar o acesso a uma cópia que ele já inseriu em seu jogo; revogar o acesso impede a reinserção ou atualizações do pacote, mas as cópias do pacote em seu modelo de dados permanecem intactas.
   Editar	O colaborador pode usar, visualizar e editar as versões atuais e anteriores do pacote, incluindo publicar alterações nele.

Reverter alterações de pacote

Em vez de desfazer uma série inteira de alterações de pacote uma a uma, você pode reverter alterações não publicadas em uma ação, restaurar um pacote para uma versão anterior ou reverter alterações para configurações específicas.

Reverter alterações não publicadas

Para desfazer uma série inteira de alterações não publicadas:

1. Na janela Explorer, localize cópias modificadas pelo ponto em seus ícones de pacote. Você também pode selecionar cópias modificadas na visualização 3D.

   

2. Clique com o botão direito do mouse em uma única cópia modificada e selecione Desfazer Alterações no Pacote, ou selecione várias cópias (pelo menos uma delas modificada), clique com o botão direito e selecione Desfazer Alterações nos Pacotes Selecionados.

Restaurar para versão publicada

Para restaurar um pacote para uma versão publicada anteriormente:

1. Na janela Explorer, Toolbox ou Gerenciador de Ativos, clique com o botão direito do mouse no pacote desejado e selecione Opções do Pacote ⟩ Detalhes do Pacote.
2. Na janela Configuração de Ativo, selecione Versões. A janela exibe detalhes para cada versão publicada, incluindo a data e hora da publicação, juntamente com quaisquer descrições das alterações.
3. Clique na marca de seleção ao lado da versão que você deseja restaurar e clique em Enviar.

Reverter configurações

Para reverter qualquer atributo de configuração ao seu padrão, selecione Redefinir no menu de opções na seção Atributos da janela Propriedades.

Comparar versões de pacote

Quando um pacote tem várias versões, você pode comparar as alterações entre as versões usando o visualizador de diferenças. A ferramenta possui um menu de hierarquia de pacotes que indica todas as instâncias adicionadas, removidas ou modificadas entre as versões usando ícones correspondentes, incluindo os seguintes recursos:

• Visão Geral Visual mostra as diferenças visuais da renderização 3D sob diferentes posições de câmera. É a visualização padrão para pacotes com um objeto 3D (modelos, partes) como objeto raiz, e atualmente está disponível apenas para o objeto raiz.

• Propriedades mostra alterações de propriedades e atributos. É a visualização padrão para pacotes com um objeto não 3D (scripts, luzes, objetos 2D) como objeto raiz, e está disponível para todas as instâncias em um pacote.

• Script mostra diferenças de script linha por linha. Está disponível para pacotes que contêm scripts, independentemente de o script ser o objeto raiz ou não.

Para comparar versões de pacote:

1. Na janela Explorer ou na visualização 3D, clique com o botão direito do mouse no pacote alvo e selecione Opções do Pacote ⟩ Comparar Versões do Pacote.

2. Por padrão, a janela compara as alterações entre sua cópia local e a versão mais recente. Use os dois menus suspensos para comparar diferentes versões.

   

   Algumas versões mais antigas podem ser incompatíveis com a ferramenta de diferenças de pacote.

3. Após selecionar versões:

   1. Para comparar as renderizações visuais do modelo raiz, se aplicável, selecione a aba Visão Geral Visual e ajuste o controle da câmera para o ângulo desejado. Os controles são sincronizados entre as visualizações:

      • Panorâmica da câmera usando cliques com o botão esquerdo do mouse.
      • Rotacione a câmera usando cliques com o botão direito do mouse.
      • Aproxime e afaste a câmera com a roda do mouse.
      • Recentre usando o atalho de teclado F.

   2. Para comparar propriedades e atributos de uma instância, selecione a instância e a aba Propriedades.

   3. Para comparar diferenças de script para um pacote que é um script ou contém scripts, use a aba Script.

      Esta ferramenta permite apenas comparar alterações de script entre a versão atual e a versão mais recente publicada ou local, sem indicar os colaboradores que fizeram a alteração.

      Alternativamente, você pode abrir a ferramenta de diferenças de script diretamente clicando com o botão direito do mouse no pacote alvo na janela Explorer ou na visualização 3D e selecionando Ver Alterações de Script.