Pacotes

Para manter os recursos organizados e reutilizáveis ​​em sua equipe ou em vários projetos, agrupe suas instâncias e crie-as em pacotes reutilizáveis por tempo . Pacotes ajudam a processar o processo geral de construção de mundos mais rápido e mais ergonômico, mas eles também ajudam com a consistência, duplicação, colaboração e versão:

• Facilmente atualizar todas as cópias de um pacote para a versão mais recente (ou apenas atualizar cópias específicas ).
• Configure pacotes para atualizar automaticamente quando houver uma nova versão sempre que houver uma nova versão.
• Dê permissões aos colaboradores Editar ou Usar permissões para os conteúdos de um pacote.
• Exibir o histórico de versões completo de um pacote, comparar versões e restaurar versões antigas.

O fluxo de trabalho mais eficiente é criar um pacote, compartilhar-o com qualquer colaborador e definir-o para atualizar automaticamente. E você não precisa esperar que um modelo seja "feito" antes de usá-lo em um pacote. Mesmo que o pacote seja um placeholder no topo de uma simples forma, você pode usá-

Criando Pacotes

Você pode criar um pacote a partir de qualquer um único objeto ou qualquer uma das filhas únicas e principais de objetos. Se você quiser criar um pacote para um único Objeto, recomendamos adicioná-lo a um grupo Model primeiro para que você possa adicionar, remover ou escalar uma instância dentro do pacote mais tarde sem quebrar o pacote.

1. Na janela Explorer ou na janela de visualização 3D, clique com o botão direito no objeto desejado e selecione Converter para Pacote .

   

2. Na nova janela, preencha os detalhes do pacote. Em particular, se você estiver trabalhando em um grupo, configure Propriedade para o grupo apropriado em que você tem permissão para criar/editar experiências de grupo.

   Transfere de propriedade não é suportado pelo sistema de propriedade, então considere cuidadosamente o proprietário ao criar um pacote.

3. Clique em Enviar .

4. Depois que a conversão terminar, o objeto recebe um símbolo de "víncular / conectar" na janela Explorer para identificá-lo como um pacote. Além disso, você pode ver um novo objeto PackageLink que está ligado ao Objeto.

   

5. (Opcional) Selecione o objeto PackageLink e ative AutoUpdate na janela Propriedades . Observe como o ícone muda para indicar que o pacote está configurado para atualizaçãoautomaticamente.

   

Inserindo Pacotes

Para inserir um pacote que ainda não existe no local atual, você deve inicialmente inseri-lo da Caixa de Ferramentas:

• A partir de Inventário → Meus Pacotes para pacotes que você publicou ou obteve do Creator Store, bem como pacotes que um amigo possui e que você deu permissões para usar.
• De Criações → Pacotes de Grupo para pacotes publicados por membros do seu grupo (incluindo você).

Uma vez que você inseriu um pacote no modelo de dados de um local, ele aparece na pasta Pacotes do Gerenciador de Recursos e permanece lá mesmo se você excluir todas as cópias dele. No entanto, quando você publicar o local, a pasta será atualizada para refletir apenas os pacotes usados dentro do local.

Publicando Mudanças de Pacote

Você pode publicar quaisquer alterações que você fez em um pacote como uma nova versão para torná-las disponíveis para outras cópias do pacote ao longo do local e de todas as experiências. Observe que não é não necessário publicar um pacote modificado antes de publicar um local (a versão modificada é salva junto com o local para futura iteração).

Para publicar alterações em um pacote:

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

   

2. Se uma cópia de pacote tiver automação de atualização ativada, ela imediatamente puxará a versão atualizada quando você abrir o local que contém eles. Outras cópias recebem um ponto branco no ícone de pacote que indica uma atualização disponível. Você pode ativar atualização individual ou atualização em massa eles como necessário.

   

3. (Opcional) Adicione uma descrição de suas alterações:

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

Atualizando Cópias Desatualizadas

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

Para atualizar uma ou mais cópias de pacote para a versão mais recente:

1. Na janela Explorer, localize cópias desatualizadas pelo ponto branco no ícone de pacote. Você também pode selecionar a cópia desatualizada na janela de visualização 3D, mas pode ser mais difícil encontrar dessa maneira.

   

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

Atualizações em Massa

Uso extensivo de pacotes pode resultar em muitas cópias de pacote em vários locais em uma experiência. Além de sincronização individual e atualizações automáticas, você pode atualizar todas as cópias de um pacote através de mass update.

1. (Recomendado) Feche outras instâncias do Studio com qualquer um dos locais da experiência abertos; isso impede que outra instância não salva de um local possa sobrescrever suas atualizações.

2. Na janela Explorer ou na janela de visualização 3D, clique com o botão direito no pacote desejado e selecione Atualizar Todos .

3. Escolha todos os locais na experiência ou alguns subconjuntos de locais e clique em Atualizar .

   

   Para evitar sobrescritos não intencionais, a atualização em massa não afeta as versões modificadas de um pacote. Depois que a atualização em massa terminar, o Studio exibe um aviso com o número de pacotes que ele fez não atualizou, se houver.

Atualizações Automáticas

Para facilitar o sincronização, você pode configurar uma cópia de pacote para atualizar automaticamente sempre que uma versão mais recente for publicada. A atualização automática das cópias de pacote ocorrerá quando um local for aberto no Studio.

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

   

2. Na janela Propriedades, ative a propriedade Atualização Automática . Se você tiver packs aninhados, esta propriedade só se aplica ao maior pacote de pais, o que significa que atualizações automáticas só ocorrem quando o pacote de pais é atualizado.

Compartilhamento e Acesso a Níveis

Se desejar, você pode compartilhar pacotes com amigos ou conceder acesso a papéis de usuário específicos dentro do seu grupo.

1. No Explorador, Toolbox ou Gerenciador de ativos, clique com o botão direito no pacote desejado e selecione Detalhes do Pacote .

2. Na janela de configuração de recursos, selecione Permissões .

   • Para um pacote de propriedade do grupo, expanda a árvore de papéis. Em seguida, escolha um nível de permissão para cada papel. Caixas de seleção que estão desativadas indicam que a permissão já está Configurada para aquele papel e não pode ser alterada a partir desta janela.

     

     Permissão	Descrição
     Editar	Membros do papel podem usar, visualizar e editar as versões atuais e anteriores do pacote, incluindo a publicação de alterações nele. Dando acesso de edição a um papel a partir desta janela só concede acesso à versão específica do pacote .
     Sem Acesso	Membros do papel não têm acesso a nenhuma nova versão do pacote, embora eles mantenham acesso à versão atual inserida no local.

   • Para um pacote de propriedade do usuário , pesquise por amigos através do campo de pesquisa, clique no nome de usuário deles e escolha um nível de permissão.

     Permissão	Descrição
     Use e Visualize	O usuário pode usar e ver (mas não editar) as versões atuais e anteriores do pacote. Uma vez que você fornece uma capacidade a um usuário, você não pode revogar o acesso a uma cópia que eles já inseriram na experiência; revogar o acesso impede a reinsertion ou atualizações de pacotes, mas cópias de pacotes em seu modelo de dados permanecem intactas.
     Editar	O usuário pode usar, ver e editar as versões atuais e anteriores do pacote, incluindo a publicação de alterações nele.

Modificando Pacotes

Você pode editar pacotes e seus filhos apenas como outros objetos. Modificar pacotes desabilita a atualização automática até que você publique ou reverter 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:

• Alterando o nome da raiz.
• Alterando a posição ou rotação da raiz do BasePart que é um 2>Class.BasePart2>, 5>Class.Model5> ou 8>Class.GuiObject8> .
• Alterar a propriedade Habilitado de um nó de raiz GuiObject , como um ScreenGui, ou um 1> Class.SurfaceGui1>, ou um 4> Class.BillboardGui4>.
• Alterar uma referência de uma peça dentro de um pacote que referencia uma instância fora do pacote.

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

Adicionando ou Atualizando Configurações

Você pode incluir atributos de instância na raiz de um pacote para personalizar seu comportamento, por exemplo, a velocidade máxima de um veículo embalado ou o tempo de debounce de um botão embalado.

Quando você publica um pacote, o conjunto atual de atributos/valores se tornará o conjunto padrão do pacote. Em qualquer cópia dada de um pacote, as configurações são mostradas em itálicos ousados e esses valores de atributos podem ser alterados em uma base por instância. Quando cópias de pacote são atualizadas, as configurações modificadas serão preservadas, enquanto outros atributos serão atualiz

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 de pais de um veículo. Este exemplo mostra um pacote de carros que contém quatro cópias do mesmo pacote de rodas:

Scripts de Pacote

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

Clicando no hiperlink:

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

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

Revertendo Alterações de Pacote

Em vez de desfazer uma série de mudanças de pacote inteiras, 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.

Revertendo Alterações Não Publicadas

Para desfazer uma série inteira de mudanças não publicadas :

1. Na janela do Explorer, localize cópias modificadas pelo ponto de exclamação ao lado de seus nomes. Você também pode selecionar cópias modificadas na janela de visualização 3D, o que pode ser mais fácil.

2. Clique com o botão direito em uma cópia modificada única e selecione Desfazer as alterações aos Pacotes , ou selecione múltiplas cópias (pelo menos uma delas modificada), clique com o botão direito e selecione Desfazer as alterações aos Pacotes Selecionados .

Restaurando para a Versão

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

1. Na janela do Explorer, 3D viewport, Toolbox, ou Gerenciador de ativos, clique com o botão direito no pacote desejado e selecione Detalhes do Pacote .

2. Na janela Configuração de Recursos, selecione Versões . A janela exibe detalhes para cada versão publicada, incluindo a data e o tempo de 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 .

   

Revertendo Configurações

Para reverter qualquer atributo de Configuração para o seu padrão, selecione a opção Redefinir no menu de equipamento na seção Atributos da janela 1>Propriedades1>.

Comparando Versões de Pacote

Quando um pacote tem várias versões, você pode comparar alterações entre versões usando o visualizador de diferenças, que é útil para revisar atualizações de pacotes, comparar suas alterações locais contra a versão mais recente e verificar o conteúdo de versões anteriores antes de restaurar.

A ferramenta tem um menu de hierarquia de pacotes que indica todas as instâncias adicionadas, removidas ou modificadas entre versões usando ícones correspondentes, com as seguintes abas disponíveis:

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

  

• 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 o Objetoraiz, e está disponível para todos os instâncias em um pacote.

  

• Script mostra diferenças de script de linha a linha. Ele está disponível para pacotes contendo scripts, independentemente de ser o script o objeto raiz ou não.

  

Para comparar versões de pacotes:

1. Na janela Explorer ou na janela de visualização 3D, clique com o botão direito no pacote alvo e selecione Comparar versões de pacotes .

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

   

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

3. Após selecionar versões:

   • Para comparar os renderizados visuais do modelo de 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:

     • Panela a câmera usando cliques de mouse esquerdo.
     • Girar a câmera usando cliques com o botão direito do mouse.
     • Aproxime e afasteça a câmera com a roda do mouse.
     • Recenter usando o atalho de teclado -F.

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

   • Para comparar diferenças de script, se Aplicável, selecione qualquer script para abrir a aba Script para alterações de linha a linha entre suas versões selecionadas, semelhante a aplicações de controle de origem.

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

Alternativamente, você pode abrir a ferramenta de diferença de script diretamente:

1. Na janela Explorer ou na janela de visualização 3D, clique com o botão direito no pacote de alvo, que deve ser um script ou conter scripts, e selecione Ver Alterações de Scripts .
2. Na aba dif que se abre, compare todas as alterações do script selecionado entre a cópia de pacote atual e a versão mais recente publicada ou localmente.