Paquetes

Para mantener los recursos organizados y reutilizables en su equipo o en múltiples proyectos, agrupe sus instancias y conviértalas en paquetes reutilizables. Los paquetes hacen que el proceso de construcción de mundos más rápido y más ergonómico, pero también ayudan con la consistencia, la duplicación, la colaboración y la versión:

• Fácilmente actualizar todas las copias de un paquete a la última versión (o solo actualizar copias específicas).
• Establece los paquetes en actualizar automáticamente cuando hay una nueva versión.
• Dar permisos de Editar o Usar a los contenidos de un paquete.
• Ver la historia de la versión completa para una instalación, comparar versiones y restaurar versiones antiguas.

El flujo de trabajo más eficiente es crear un paquete, compartirlo con cualquier colaborador y establecerlo para actualizar automáticamente. Y no tienes que esperar a que se "haya terminado" un modelo para usarlo en un paquete. Incluso si el paquete es un marcador en el topo de una forma simple, puedes usarlo para <

Crear paquetes

Puede crear un paquete a partir de cualquier objeto o rama de padres e hijos de objetos. Si desea crear un paquete para un solo objeto, recomendamos agregarlo a un grupo Model para agregar primero para que pueda añadir, eliminar o escalar una instancia dentro del paquete más tarde sin romper el paquete.

1. En la ventana Explorer o 3D ventanilla, haz clic con el botón derecho en el objeto deseado y selecciona Convertir en paquete .

   

2. En la nueva ventana, rellena los detalles del paquete. En particular, si estás trabajando en un grupo, establece Propiedad en el grupo correspondiente en el que tienes permiso para crear/editar experiencias de grupo.

   Las transferencias de propiedad no están soportadas por el sistema de gestión de activos, así que tenga cuidado al crear un paquete.

3. Haga clic en Presentar .

4. Después de que la conversión se complete, el objeto recibe un símbolo de "enlazarcadena" en la ventana Explorer para identificarlo como un paquete. Además, puede ver un nuevo objeto PackageLink que está asociado al objeto.

   

5. (Opcional) Seleccione el objeto PackageLink y habilite AutoUpdate en la ventana Propiedades . Observe cómo el icono cambia para indicar que el paquete está configurado para actualizaciónautomáticamente.

   

Insertando paquetes

Para insertar un paquete que aún no existe en el lugar actual, debe Insertarlo primero desde la Caja de herramientas :

• De Inventario → Mis paquetes para paquetes que has publicado o obtenido del Creator Store, así como paquetes que un amigo posee y te ha dado permisos para usar.
• De Creaciones → Paquetes de Grupo para los paquetes publicados por los miembros de tu grupo (incluido tú).

Una vez que hayas insertado un paquete en el aplicación de modeladode datos de un lugar, aparecerá en la carpeta de paquetes del Asset Manager y se mantendrá ahí incluso si eliminas todas las copias del paquete más tarde. Sin embargo, cuando publiques el lugar, la carpeta se actualizará para reflejar solo los paquetes utilizados dentro del lugar.

Publicar cambios de paquetes

Puedes publicar cualquier cambio que hagas en un paquete como una nueva versión para hacerlas disponibles para otras copias del paquete en todo el lugar y en todas las experiencias. Nota que no es no requerido publicar un paquete modificado antes de publicar un lugar (la versión modificada se guarda junto con el lugar para futuras iteraciones).

Para publicar cambios en un paquete:

1. En la ventana Explorador o la vista 3D, haz clic con el botón derecho en la copia modificada y selecciona Publicar en el paquete .

   

2. Si una copia de paquete tiene actualización automática activada, se actualiza inmediatamente la versión actualizada cuando se abre el lugar en el que se encuentran. Otras copias obtienen un punto blanco en el icono del paquete que indica una actualización disponible. Puedes actualizarlas individualmente o actualizarlas en masa según sea necesario.

   

3. (Opcional) Añade una descripción de tus cambios:

   1. Haga clic con el botón derecho en el paquete y seleccione Detalles del paquete .
   2. En la ventana de configuración de recursos, seleccione Versiones .
   3. Bajo su cambio más reciente, seleccione Añadir .
   4. Describa sus cambios y haga clic en Enviar .

Actualizar copias desactualizadas

Puede actualizar las copias de paquetes obsoletas a la versión más reciente, o puede seguir usando la versión más antigua.

Para actualizar una o más copias de paquetes a la última versión:

1. En la ventana Explorador, localiza las copias desactualizadas por el punto blanco en el íconode paquete. También puedes seleccionar la copia desactualizada en la ventanilla3D, pero puede ser más difícil encontrar de esta manera.

   

2. Haga clic con el botón derecho en la copia actual y seleccione Obtener el paquete más reciente . También puede seleccionar múltiples paquetes, hacer clic con el botón derecho y Obtener el paquete más reciente para los paquetes seleccionados .

Actualizaciones masivas

El uso extendido de los paquetes puede resultar en muchas copias de paquetes en varios lugares en una experiencia. Además de sincronización individual y actualizaciones automáticas, puede actualizar todas las copias de un paquete a través de actualización en masa.

1. (Recomendado) Cierre otras instancias de Studio con cualquiera de los lugares de la experiencia abiertos; esto evita que se sobreescriba potencialmente una instancia guardada de un lugar.

2. En la ventana Explorer o 3D ventanilla, haz clic con el botón derecho en el paquete deseado y selecciona Actualizar Todo .

3. Seleccione todos los lugares en la experiencia o algunos subconjuntos de lugares y haga clic en Actualizar .

   

   Para evitar sobrescritos no intencionales, la actualización en masa no afecta a las versiones modificadas de un paquete. Después de que la actualización en masa se complete, Studio muestra una advertencia con el número de paquetes que no actualizó, si los hubiere.

Actualizaciones automáticas

Para hacer que la sincronización sea más fácil, puede establecer una copia de paquete para actualizar automáticamente cuando se publica una nueva versión. La actualización automática de las copias de paquete se llevará a cabo cuando se abra un lugar en Studio.

1. En la ventana Explorador, expanda el árbol de la jerarquía del paquete y seleccione su objeto PackageLink .

   

2. En la ventana Propiedades, habilita la propiedad Actualización automática . Si tienes paquetes anidados, esta propiedad solo se aplica al paquete de padre más alto, lo que significa que las actualizaciones automáticas solo se producen cuando el paquete de padre se actualiza.

Compartir y Nivel de Acceso

Si lo desea, puede compartir paquetes con amigos o otorgar el acceso a un rol de usuario específico dentro de su grupo.

1. En el Explorador, la Caja de Herramientas o el Administrador de Activos, haz clic con el botón derecho en el paquete deseado y selecciona Detalles del paquete .

2. En la ventana de configuración de recursos, seleccione Permisos .

   • Para un paquete propiedad del grupo, expanda el árbol de roles. Luego elige un nivel de permiso para cada rol. Las casillas de selección que están desactivadas indican que el permiso ya está Configurado para ese rol y no se puede cambiar desde esta ventana.

     

     Permiso	Descripción
     Editar	Los miembros del rol pueden usar, vistay editar las versiones actual y anterior del paquete, incluyendo la publicación de cambios en él. Otorgar acceso de edición a un rol desde esta ventana solo otorga acceso a la versión específica del paquete .
     Sin acceso	Los miembros del rol no tienen acceso a ninguna nueva versión del paquete, aunque conserven el acceso a la versión actual insertada en el lugar.

   • Para un paquete de propiedad del usuario, busque amigos a través del campo de búsqueda, haga clic en su nombre de usuario y elige un nivel de permiso.

     Permiso	Descripción
     Usar y Ver	El usuario puede usar y ver (pero no editar) las versiones de paquetes actuales y anteriores. Una vez que se le proporcione a un usuario esta capacidad, no puede revocar el acceso a una copia que ya ha insertado en su experiencia; revocar el acceso no permite la reinsertar o actualizar el paquete, pero las copias de paquetes en su modelo de datos se mantienen intactas.
     Editar	El usuario puede usar, vistay editar las versiones actual y anterior del paquete, incluyendo la publicación de cambios en él.

Modificando paquetes

Puedes editar paquetes y sus hijos como otros objetos. Modificar paquetes desactiva la actualización automática hasta que publique o reverta los cambios.

La mayoría de las ediciones marcan el paquete como modificado, aunque los siguientes cambios no son considerados modificaciones de paquetes:

• Cambiando el nombre de la raíz del nodo.
• Cambiar la posición o rotación de la raíz del nodo de un paquete que es un BasePart , 2> Class.Model2> o 5> Class.GuiObject5> .
• Cambiar la propiedad Habilitado de un nodo de raíz GuiObject como un ScreenGui , 1> Class.SurfaceGui1> o 4> Class.BillboardGui4> .
• Cambiar una referencia de parte de un Weld dentro del paquete que se refiere a una instancia fuera del paquete.

Una vez modificado, los paquetes con cambios no publicados obtienen un icono modificado en la ventana Explorador :

Agregar o actualizar configuraciones

Puede incluir atributos de instancia en la raíz de un paquete para personalizar su comportamiento, por ejemplo, la velocidad máxima de un vehículo empaquetado o el tiempo de debounce para un botón empaquetado.

Cuando publica un paquete, el conjunto actual de atributos/valores se convertirá en el conjunto predeterminado del paquete. En cualquier copia actual del paquete, las configuraciones se muestran en caracteres negritos y estos valores de atributos se pueden cambiar en una base per-instancia. Cuando las configuraciones se actualizan, los valores de atributos modificados se conservarán, mientras que las demás configuraciones se actualizan a la últ

Paquetes anidados

Puede anidar paquetes dentro de otros paquetes para mantener y colaborar en jerarquías complejas, como una serie de mecánicas de vehículos que se pueden modificar de forma independiente del paquete padre del vehículo. Este ejemplo muestra un paquete de coche que contiene cuatro copias del mismo paquete de ruedas:

Guiones de paquetes

Cada script dentro de un paquete no modificado se lee solo y muestra una notificación en la parte superior con un enlace de hipertexto para desbloquear el script.

Haciendo clic en el enlace hipertexto:

• Marca el paquete como modificado sin importar si editas el script.
• Elimina la notificación / hipervínculo de otros scripts dentro del paquete.

Una vez que el paquete se publique y se mueva a un estado no modificado, los scripts debajo de él se vuelven de lectura única con un enlace hipertexto para modificar.

Revertiendo cambios de paquetes

En lugar de deshacer una serie de cambios de paquetes uno por uno, puede revertir los cambios no publicados en una acción, restaurar un paquete a una versión anterior 7 o revertir los cambios a configuraciones específicas.

Revertiendo cambios no publicados

Para deshacer una serie completa de cambios no publicados cambios:

1. En la ventana Explorer, localice copias modificadas por el signo de exclamación junto a sus nombres. También puede seleccionar copias modificadas en la ventanilla3D, lo cual puede ser más fácil.

2. Haga clic con el botón derecho en una sola copia modificada y seleccione Deshacer cambios en el paquete o seleccione múltiples copias (al menos una de ellas modificada), haga clic con el botón derecho y seleccione Deshacer cambios en los paquetes seleccionados .

Restaurar a la versión

Para restaurar un paquete a una versión previamente publicada :

1. En la ventana Explorador, 3D ventanilla, Toolbox, o Gestor de recursos, haz clic con el botón derecho en el paquete deseado y selecciona Detalles del paquete .

2. En la ventana de configuración de recursos, seleccione Versiones . La ventana muestra los detalles para cada versión publicada, incluida la fecha y el tiempo de publicación, junto con cualquier descripción de los cambios.

3. Haga clic en la casilla de verificación junto a la versión que desea restaurar y haga clic en Enviar .

   

Revertiendo configuraciones

Para revertir cualquier atributo de configuración a su valor predeterminado, seleccione la opción Restablecer del menú de engranajes en la sección Atributos de la ventana Propiedades.

Comparación de versiones de paquetes

Cuando un paquete tiene múltiples versiones, puede comparar cambios entre versiones usando el visor de diferencias, que es útil para revisar las actualizaciones de los paquetes, comparar sus cambios locales contra la última versión y ver el contenido de las versiones anteriores antes de restaurar.

La herramienta tiene un menú de jerarquía de paquetes que indica todas las instancias agregadas, eliminadas o modificadas entre versiones utilizando los iconos correspondientes, con las siguientes pestañas disponibles:

• Visión general muestra las diferencias visuales de la renderización 3D bajo diferentes posiciones de cámara. Es la vista predeterminada para los paquetes con un objeto 3D (modelos, partes) como objeto de raíz, y actualmente solo está disponible para el objeto de raíz.

  

• Propiedades muestra los cambios de propiedades y atributos. Es la vista predeterminada para los paquetes con un objeto no 3D (escritos, luces, objetos 2D) como objeto raíz, y está disponible para todas las instancias en un paquete.

  

• Script muestra la diferencia de scripts de línea en línea. Está disponible para los paquetes que contienen scripts, independientemente de si el script es el objeto raíz o no.

  

Para comparar versiones de paquetes:

1. En la ventana Explorador o 3D ventanilla, haz clic con el botón derecho en el paquete objetivo y selecciona Comparar Versiones de Paquetes .

2. Por defecto, la ventana compara cambios entre tu copia local y la última versión. Usa los dos menús desplegables para comparar versiones diferentes.

   

   Algunas versiones más antiguas pueden ser incompatibles con la herramienta de difusión de paquetes.

3. Después de seleccionar versiones:

   • Para comparar las renderizaciones visuales del aplicación de modeladode raíz, si es aplicable, seleccione la pestaña Visión general y ajuste el control de la cámara para su ángulo deseado. Los controles se sincronizan entre las vistas:

     • Enciende la cámara usando clics de mouse izquierdo.
     • Gira la cámara usando clics derechos del ratón.
     • Enfoque y desenfoque con la rueda del mouse.
     • Recencer usando el atajo de teclado -F .

   • Para comparar propiedades y atributos de una instancia, seleccione la instancia y la pestaña Propiedades .

   • Para comparar diferencias de script, si es aplicable, seleccione cualquier script para abrir la Escritura de script pestaña para cambios de línea a línea entre sus versiones seleccionadas, similar a aplicaciones de control de fuentes.

     Esta herramienta solo te permite comparar cambios de script entre la versión actual y la última versión publicada o local, sin indicar a los colaboradores que hicieron el cambio.

Alternativamente, puede abrir la herramienta de difusión de scripts directamente:

1. En la ventana Explorador o 3D ventanilla, haz clic con el botón derecho en el paquete objetivo, que debe ser un script o contener scripts, y selecciona Ver cambios de script .
2. En la pestaña de dif que se abre, compara todos los cambios del script seleccionado entre la copia de paquete actual y la versión publicada o local más reciente.