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 paquetes para que se actualicen automáticamente cada vez que haya una nueva versión.
• Da permisos de Edición o Uso a los colaboradores para el contenido de un paquete.
• Consulta 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 actualizaciones automáticas. Y no tienes que esperar a que un modelo esté "terminado" antes de usarlo en un paquete. Incluso si el paquete es un marcador encima de una forma simple, puedes usarlo para diseñar 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 cualquier rama de un padre y sus hijos. Si deseas crear un paquete para un solo objeto, primero agrégalo a un agrupamiento Model para que puedas agregar, eliminar o escalar objetos secundarios dentro del paquete más tarde sin romper el paquete.

Para crear un paquete:

1. En la ventana del Explorer o en el viewport 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, configura la Propiedad al grupo adecuado 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 se complete la conversión, el objeto recibe un símbolo de "eslabón de cadena" en la ventana del Explorer para identificarlo como un paquete. Además, podrás ver un nuevo objeto PackageLink parentado al objeto.

   

5. OPCIONAL

   Selecciona el objeto PackageLink y habilita AutoUpdate en la ventana de Propiedades. Observa cómo el icono 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 insertarlo inicialmente desde el Toolbox:

• Desde Inventario ⟩ Mis Paquetes para paquetes que has publicado o obtenido de la Tienda del Creador, 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 (incluido tú mismo).

Una vez que has insertado un paquete en el modelo de datos de un lugar publicado, aparecerá en el Administrador de Activos y permanecerá allí incluso si más tarde 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 de 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 hace referencia a una instancia fuera del paquete.

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

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 se pueden cambiar de forma individual, y esos cambios se indican mediante cursivas en negrita. Cuando las copias de paquete se actualizan, los valores de configuración modificados se conservará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 se pueden modificar de forma independiente 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 la publicación del padre lo marcaría como actual/modificado y entraría en conflicto con las modificaciones del paquete anidado.

Scripts de paquetes

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.

Al 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 requerido 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 Explorer o en el viewport 3D, haz clic derecho en la copia modificada y selecciona Publicar en Paquete.

2. Si una copia de paquete tiene activada la actualización automática, obtiene la versión actualizada inmediatamente 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 del Activo, 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 paquetes desactualizadas a la versión más reciente, o puedes continuar usando la versión anterior.

1. En la ventana del Explorer, localiza copias desactualizadas por el símbolo de "descarga". También puedes seleccionar la copia desactualizada en el viewport 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 seleccionar Obtener Último Para Paquetes Seleccionados.

Actualizaciones masivas

El uso extensivo de paquetes puede resultar en muchas copias de paquetes en varios 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 previene que otra instancia no guardada de un lugar sobrescriba potencialmente tus actualizaciones.
2. En la ventana del Explorer o en el viewport 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 nueva versión. La actualización automática de las copias de paquete tendrá lugar cuando un lugar se abra en Studio.

1. En la ventana del Explorer, expande el árbol jerárquico 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 nivel más alto, lo que significa que las actualizaciones automáticas solo ocurren cuando se actualiza el paquete padre.

Niveles de compartir y acceso

Puedes otorgar permisos a amigos, juegos, grupos o roles específicos de usuarios de grupo para que puedan usar libremente tus paquetes en sus creaciones. Para 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 Explorer, 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 del Activo, selecciona Permisos.

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

   Permiso	Descripción
   Usar & Ver	El colaborador puede usar y ver (pero no editar) las versiones actuales y anteriores del paquete. Una vez que le brindas a un colaborador esta capacidad, no puedes revocar el acceso a una copia que ya insertó en su juego; revocar el acceso previene 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 la publicación de cambios en él.

Revertir cambios de paquete

En lugar de deshacer una serie entera 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 configuraciones.

Revertir cambios no publicados

Para deshacer una serie entera de cambios no publicados:

1. En la ventana del Explorer, localiza copias modificadas por el punto en sus iconos de paquete. También puedes seleccionar copias modificadas en el viewport 3D.

   

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

Restaurar a una versión publicada

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

1. En la ventana del Explorer, 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 del Activo, 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 paquetes

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

• Visión General Visual muestra las diferencias visuales de la representación 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 paquetes:

1. En el Explorer o en el viewport 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 del paquete.

3. Después de seleccionar versiones:

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

      • Pan la cámara usando clics con el botón izquierdo del ratón.
      • Rota la cámara usando clics con el botón derecho del ratón.
      • Acerca o aleja la cámara con la rueda del ratón.
      • Re-centra usando la combinación de teclas 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 quiénes fueron los colaboradores que realizaron el cambio.

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