Paquetes

Para mantener los activos organizados y reutilizables a través de tu equipo o en múltiples proyectos, puedes agrupar tus instancias y convertirlas en paquetes reutilizables. Los paquetes hacen que el proceso general de construcción de mundos sea más rápido y ergonómico, pero también ayudan con la consistencia, la deduplicación, la colaboración y el versionado:

• Actualiza fácilmente todas las copias de un paquete a la última versión, o solo actualiza copias específicas.
• Configura los paquetes para que se actualicen automáticamente cada vez que haya una nueva versión.
• Otorga a los colaboradores permisos de Edición o Uso sobre el contenido de un paquete.
• Visualiza el historial completo de versiones de un paquete, compara versiones y restaura versiones antiguas.

El flujo de trabajo más eficiente es crear un paquete, compartirlo con cualquier colaborador y configurarlo para que se actualice automáticamente. Y no tienes que esperar a que un modelo esté "terminado" antes de usarlo en un paquete. Incluso si el paquete es un marcador sobre una forma simple, puedes usarlo para greyboxear tu entorno y luego hacer que las copias de marcador se actualicen automáticamente a medida que publicas versiones más detalladas.

Crear paquetes

Puedes crear un paquete a partir de cualquier objeto individual o de cualquier rama de objetos padre e hijos. Si deseas crear un paquete para un solo objeto, agrégalo primero a un grupo Model para que puedas agregar, eliminar o escalar objetos hijos dentro del paquete más tarde sin romper el paquete.

Para crear un paquete:

1. En la ventana del Explorador o en la vista 3D, haz clic derecho en el/los objeto(s) que deseas convertir en un paquete y, en el menú contextual, selecciona Convertir en Paquete.

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

   Las transferencias de propiedad no son compatibles con el sistema de activos, así que considera cuidadosamente el propietario al crear un paquete.

3. Haz clic en Enviar.

4. Después de que la conversión se complete, el objeto recibe un símbolo de "eslabón de cadena" en la ventana del Explorador para identificarlo como un paquete. Además, puedes ver un nuevo objeto PackageLink parentado al objeto.

   

5. OPCIONAL

   Selecciona el objeto PackageLink y habilita AutoUpdate en la ventana de Propiedades. Nota cómo el ícono cambia para indicar que el paquete está configurado para actualizarse automáticamente.

Insertar paquetes

Para insertar un paquete que no existe ya en el lugar actual, debes inicialmente insertarlo desde el Toolbox:

• Desde Inventario ⟩ Mis Paquetes para paquetes que has publicado o obtenido de la Tienda de Creadores, así como paquetes que un amigo posee y te ha dado permisos para usar.
• Desde Creaciones ⟩ Paquetes de Grupo para paquetes publicados por miembros de tu grupo (incluyéndote a ti mismo).

Una vez que hayas insertado un paquete en el modelo de datos de un lugar publicado, aparece en el Administrador de Activos y permanece allí incluso si luego eliminas todas las copias de él.

Modificar paquetes

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

La mayoría de las ediciones marcan el paquete como modificado, aunque los siguientes cambios no se consideran modificaciones del paquete:

• Cambiar el nombre del nodo raíz.
• Cambiar la posición o rotación del nodo raíz de un paquete que es un BasePart, Model o GuiObject.
• Cambiar la propiedad Enabled de un nodo raíz GuiObject como un ScreenGui, SurfaceGui o BillboardGui.
• Cambiar una referencia de parte de un Weld dentro del paquete que referencia una instancia fuera del paquete.

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

Agregar o actualizar configuraciones

Puedes incluir atributos de instancia en la raíz de un paquete para personalizar su comportamiento. Cuando publicas un paquete, el conjunto actual de atributos/valores se convierte en las configuraciones predeterminadas del paquete. En cualquier copia de un paquete, esos valores de atributo pueden cambiarse de manera individual, y esos cambios se anotan a través de cursivas en negrita. Cuando las copias de paquete son actualizadas, los valores de configuración modificados se preservarán, mientras que otros atributos se actualizarán al último valor predeterminado.

Paquetes anidados

Puedes anidar paquetes dentro de otros paquetes para mantener y colaborar en jerarquías complejas, como una serie de mecánicas de vehículos que pueden modificarse independientemente del paquete padre del vehículo.

Si modificas un paquete anidado, tanto el paquete anidado como el paquete padre se consideran modificados. Debes publicar cambios en cualquier paquete anidado antes de que se te permita publicar cambios en su paquete padre, ya que publicar el padre lo marcaría como actual/no modificado y entraría en conflicto con las modificaciones del paquete anidado.

Scripts de paquete

Cada script dentro de un paquete no modificado es de solo lectura y muestra una notificación en la parte superior con un hipervínculo para desbloquear el script.

Hacer clic en el hipervínculo:

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

Una vez que el paquete se publica y se mueve a un estado no modificado, los scripts bajo él se vuelven de solo lectura con un hipervínculo para modificar.

Publicar cambios de paquete

Puedes publicar cualquier cambio en un paquete como una nueva versión, haciendo que tus actualizaciones estén disponibles para otras copias de paquete en todo el lugar y en todos los juegos. No es necesario publicar un paquete modificado antes de publicar un lugar porque la versión modificada se guarda junto con el lugar para futuras iteraciones.

Para publicar cambios en un paquete:

1. En la ventana del Explorador o en la vista 3D, haz clic derecho en la copia modificada y selecciona Publicar en Paquete.

2. Si una copia de paquete tiene la actualización automática activada, inmediatamente obtiene la versión actualizada cuando abres el lugar que las contiene. Otras copias obtienen un símbolo de "descarga" que indica que hay una actualización disponible. Puedes actualizar individualmente o actualizar masivamente todas las copias.

   

3. OPCIONAL

   Agrega una descripción de tus cambios:

   1. Haz clic derecho en el paquete y selecciona Detalles del Paquete.
   2. En la ventana de Configuración de Activos, selecciona Versiones.
   3. Bajo tu cambio más reciente, selecciona Agregar.
   4. Describe tus cambios y luego haz clic en el botón Enviar.

Actualizar copias desactualizadas

Puedes actualizar copias de paquete desactualizadas a la versión más reciente, o puedes continuar usando la versión anterior.

1. En la ventana del Explorador, localiza copias desactualizadas por el símbolo de "descarga". También puedes seleccionar la copia desactualizada en la vista 3D.

   

2. Haz clic derecho en una copia desactualizada y selecciona Obtener Último Paquete. También puedes seleccionar múltiples paquetes, hacer clic derecho y Obtener Último para Paquetes Seleccionados.

Actualizaciones masivas

El uso extensivo de paquetes puede resultar en muchas copias de paquete en múltiples lugares en un juego. Además de la sincronización individual y las actualizaciones automáticas, puedes actualizar todas las copias de un paquete a través de actualizaciones masivas.

1. RECOMENDADO

   Cierra otras instancias de Studio con cualquiera de los lugares del juego abiertos; esto evita que otra instancia no guardada de un lugar sobrescriba potencialmente tus actualizaciones.
2. En la ventana del Explorador o en la vista 3D, haz clic derecho en el paquete deseado y selecciona Actualizar Todo.
3. Elige todos los lugares en el juego o algún subconjunto de lugares y haz clic en Actualizar.

Actualizaciones automáticas

Para facilitar la sincronización, puedes configurar una copia de paquete para que se actualice automáticamente cada vez que se publique una versión más nueva. La actualización automática de las copias de paquete tendrá lugar cuando se abra un lugar en Studio.

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

   

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

Compartir y niveles de acceso

Puedes otorgar permiso a amigos, juegos, grupos o roles de usuario específicos de grupo para que puedan usar libremente tus paquetes en sus creaciones. Para obtener más información sobre el acceso a activos, consulta Privacidad de activos.

Para cambiar los permisos del paquete para un colaborador, como un amigo o grupo:

1. En la ventana del Explorador, Toolbox o Administrador de Activos, haz clic derecho en el paquete deseado y selecciona Opciones de Paquete ⟩ Detalles del Paquete.

2. En la ventana de Configuración de Activos, selecciona Permisos.

3. Usando la barra de búsqueda, ingresa y selecciona un colaborador al que deseas otorgar permiso para usar tu paquete, luego elige un nivel de permiso.

   Permiso	Descripción
   Usar y Ver	El colaborador puede usar y ver (pero no editar) las versiones actuales y anteriores del paquete. Una vez que le otorgues a un colaborador esta capacidad, no puedes revocar el acceso a una copia que ya insertaron en su juego; revocar el acceso impide la reinserción o actualizaciones del paquete, pero las copias de paquete en su modelo de datos permanecen intactas.
   Editar	El colaborador puede usar, ver y editar las versiones actuales y anteriores del paquete, incluyendo publicar cambios en él.

Revertir cambios de paquete

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

Revertir cambios no publicados

Para deshacer una serie completa de cambios no publicados:

1. En la ventana del Explorador, localiza copias modificadas por el punto en sus íconos de paquete. También puedes seleccionar copias modificadas en la vista 3D.

   

2. Haz clic derecho en una sola copia modificada y selecciona Deshacer Cambios en el Paquete, o selecciona múltiples copias (al menos una de ellas modificada), haz clic derecho y selecciona Deshacer Cambios en los Paquetes Seleccionados.

Restaurar a la versión publicada

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

1. En la ventana del Explorador, Toolbox o Administrador de Activos, haz clic derecho en el paquete deseado y selecciona Opciones de Paquete ⟩ Detalles del Paquete.
2. En la ventana de Configuración de Activos, selecciona Versiones. La ventana muestra detalles de cada versión publicada, incluyendo la fecha y hora de publicación, junto con cualquier descripción de los cambios.
3. Haz clic en la marca de verificación junto a la versión que deseas restaurar y haz clic en Enviar.

Revertir configuraciones

Para revertir cualquier atributo de configuración a su valor predeterminado, selecciona Restablecer desde su menú de opciones en la sección de Atributos de la ventana de Propiedades.

Comparar versiones de paquete

Cuando un paquete tiene múltiples versiones, puedes comparar cambios entre versiones utilizando el visor de diferencias. La herramienta tiene un menú de jerarquía de paquetes que indica todas las instancias añadidas, eliminadas o modificadas entre versiones utilizando íconos correspondientes, incluyendo las siguientes características:

• Resumen Visual muestra las diferencias visuales del renderizado 3D bajo diferentes posiciones de cámara. Es la vista predeterminada para paquetes con un objeto 3D (modelos, partes) como objeto raíz, y actualmente solo está disponible para el objeto raíz.

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

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

Para comparar versiones de paquete:

1. En el Explorador o en la vista 3D, haz clic derecho en el paquete objetivo y selecciona Opciones de Paquete ⟩ Comparar Versiones de Paquete.

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

   

   Algunas versiones anteriores pueden ser incompatibles con la herramienta de diferencias de paquete.

3. Después de seleccionar versiones:

   1. Para comparar los renderizados visuales del modelo raíz, si corresponde, selecciona la pestaña Resumen Visual y ajusta el control de cámara para tu ángulo deseado. Los controles están sincronizados entre vistas:

      • Mueve la cámara usando clics del mouse izquierdo.
      • Rota la cámara usando clics del mouse derecho.
      • Acerca y aleja la cámara con la rueda del mouse.
      • Recentrar usando el atajo de teclado F.

   2. Para comparar propiedades y atributos de una instancia, selecciona la instancia y la pestaña Propiedades.

   3. Para comparar diferencias de script para un paquete que es un script o contiene scripts, usa la pestaña Script.

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

      Alternativamente, puedes abrir la herramienta de diferencias de script directamente haciendo clic derecho en el paquete objetivo en la ventana del Explorador o en la vista 3D y seleccionando Ver Cambios de Script.