Para mantener los activos organizados y reutilizables en tu equipo o en múltiples proyectos, agrupa tus instancias y conviértelas en paquetes reutilizables . Los paquetes hacen que el proceso general de construir mundos sea más rápido y ergonómico, pero también ayudan con la consistencia, la deduplicación, la colaboración y la versionación:
- Fácilmente actualizar todas las copias de un paquete a la última versión (o solo actualizar copias específicas).
- Establecer paquetes para que se actualicen automáticamente cuando haya una nueva versión cada vez que haya una nueva versión.
- Dar a los colaboradores editar o usar permisos a los contenidos de un paquete.
- Vea el historial de versiones completo para un paquete, compare versiones y restaure versiones antiguas.
El flujo de trabajo más eficiente es crear un paquete , compartirlo con cualquier colaborador, y configurarlo para actualizarse automáticamente .Y no tienes que esperar a que un modelo esté "listo" antes de usarlo en un paquete.Incluso si el paquete es un marcador en la parte superior de una forma simple, puedes usarlo para greybox tu entorno y luego tener que las copias del marcador se actualicen automáticamente cuando publique versiones más detalladas.
Crear paquetes
Puedes crear un paquete desde cualquier objeto individual o rama de objetos padre e hijo única.Si quieres crear un paquete para un solo objeto, agréganlo a un grupo de Model agrupación primero para que puedas agregar, eliminar o escalar objetos hijos dentro del paquete más tarde sin romper el paquete.
Hay un límite de 15,000 ID de activos únicos que se pueden referenciar en un solo paquete, y debe tener permiso para usar todos los activos incluidos.Para obtener más información, vea Privacidad de activos.
Para crear un paquete:
En la ventana Explorador o 3D viewport, haz clic derecho en el objeto que quieres convertir en paquete, luego en el menú contextual, selecciona Convertir a paquete .
En la nueva ventana, rellene los detalles del paquete.En particular, si estás trabajando en un grupo determinado, establece la propiedad al grupo apropiado en el que tienes permiso para crear/editar experiencias de grupo.
Las transferencias de propiedad no están apoyadas por el sistema de activos, así que considera cuidadosamente al propietario al crear un paquete.
Haga clic en Enviar .
Una vez completada la conversión, el objeto recibe un símbolo de "enlace de cadena" en la ventana Explorador para identificarlo como un paquete.Además, puedes ver un nuevo objeto Enlace de paquete asociado al objeto.
(Opcional) Seleccione el objeto Enlace de paquete y habilite AutoUpdate en Propiedades .Observe cómo cambia el icono para indicar que el paquete está configurado para actualizarse automáticamente.
¡No elimines o muevas el objeto Enlace de paquete ! Hacerlo para cualquier copia de paquete convierte la copia de nuevo en un objeto normal y pierde las capacidades de paquete, como la capacidad de actualizarse cuando hay una nueva versión.
Insertar paquetes
Para insertar un paquete que aún no existe en el lugar actual, debe insertarlo inicialmente de la caja de herramientas:
- Desde Inventario > Mis paquetes para paquetes que has publicado en 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 (incluyendo a ti mismo).
Una vez que hayas insertado un paquete en el modelo de datos de un lugar publicado, aparece en el Gestor de activos y permanece allí incluso si luego eliminas todas las copias de él.
Tenga cuidado al insertar recursos que no creó en sus experiencias, ya que pueden contener scripts maliciosos.Guarde su experiencia primero y luego investigue cualquier script dentro de activos desconocidos para que pueda volver fácilmente a la versión del lugar.
Publicar cambios de paquete
Puedes publicar cualquier cambio a tu paquete como una nueva versión, haciendo tus actualizaciones disponibles para otras copias de paquetes en todo el lugar y en todas las experiencias.No es necesario publicar un paquete modificado antes de publicar un lugar porque la versión modificada se guarda junto con el lugar para una iteración futura.
Para publicar cambios a un paquete:
En la ventana Explorador o 3D viewport, haz clic derecho en la copia modificada y selecciona Publicar al paquete .
Si una copia de paquete tiene actualización automática activada, inmediatamente extrae la versión actualizada cuando abre el lugar que los contiene.Otras copias obtienen un punto blanco en el icono del paquete que indica que una actualización está disponible.Puedes actualizar individualmente o actualizar en masa todas las copias.
(Opcional) Añade una descripción de tus cambios:
- Haga clic con el botón derecho en el paquete y seleccione Detalles del paquete .
- En la ventana Configuración de recursos , seleccione Versiones .
- Bajo tu cambio más reciente, selecciona Añadir .
- Describe tus cambios, luego haz clic en el botón Enviar .
Actualizar copias obsoletas
Puedes actualizar las copias de paquetes obsoletas a la versión más reciente o puedes seguir usando la versión más antigua.
Para actualizar una o más copias de paquete a la última versión:
En la ventana Explorador , localiza copias obsoletas por el punto blanco en el icono del paquete.También puedes seleccionar la copia obsoleta en la vista 3D, pero puede ser más difícil encontrarla de esta manera.
Haga clic con el botón derecho en la copia obsoleta y seleccione Obtener el paquete más reciente .También puede seleccionar múltiples paquetes, hacer clic derecho y Obtener lo más reciente para los paquetes seleccionados .
Actualizaciones masivas
El uso extensivo de paquetes puede resultar en muchas copias de paquetes en múltiples lugares en una experiencia.Además de sincronización individual y actualizaciones automáticas, puedes actualizar todas las copias de un paquete a través de actualización masiva .
(Recomendado) Cerrar otras instancias de Studio con cualquiera de los lugares abiertos de la experiencia; esto evita que otra instancia no guardada de un lugar potencialmente reemplace sus actualizaciones.
En la ventana Explorador o 3D viewport, haz clic derecho en el paquete deseado y selecciona Actualizar todo .
Elige todos los lugares en la experiencia o algún subconjunto de lugares y haz clic en actualizar .
Para evitar sobrescrituras no intencionales, la actualización masiva no afecta versiones modificadas de un paquete.Después de que la actualización masiva se complete, Studio muestra una advertencia con el número de paquetes que no actualizó no , si es que hay alguno.
La actualización masiva de paquetes se guarda automáticamente los lugares seleccionados pero no los publica publica .
Actualizaciones automáticas
Para facilitar la sincronización, puedes establecer una copia de paquete para actualizarse automáticamente cada vez que se publique una versión más nueva.La actualización automática de las copias del paquete se llevará a cabo cuando se abra un lugar en Studio.
Para actualizar automáticamente copias de paquetes:
En la ventana Explorador , expanda el árbol de jerarquía del paquete y seleccione su objeto Enlace de paquete .
En la ventana Propiedades , habilita la propiedad Actualización automática .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 .
La actualización automática no se aplica a las copias modificadas de paquetes modificadas.Una vez que modifiques una instancia de paquete, su propiedad de Actualización automática se desactiva y se ignora.
Niveles de compartir y acceso
Puedes otorgar permisos a amigos, experiencias, grupos o roles de usuario de grupo específicos para que puedan usar libremente tus paquetes en sus creaciones.Una vez que compartas un paquete, todas las versiones futuras de ese paquete tienen las mismas restricciones incluso si luego revocas la compartición de paquetes.Para obtener más información sobre el acceso a los activos, consulte privacidad de activos.
Para compartir paquetes con otros colaboradores, el paquete solo debe contener referencias a activos que hayas creado o tengas permiso explícito para usar.
Para cambiar las permisos de paquete para un colaborador, como un amigo o grupo:
En la ventana Explorador , Caja de herramientas , o Administrador de recursos , haz clic derecho en el paquete deseado y selecciona Detalles del paquete .
En la ventana Configuración de recursos , seleccione Permisos .
Usando la barra de búsqueda, ingrese y seleccione un colaborador al que desea otorgar permiso para usar su paquete, luego elija un nivel de permiso.
Permiso Descripción Uso y vista El colaborador puede usar y ver (pero no editar) las versiones actuales y anteriores del paquete.Una vez que proporciones esta capacidad a un colaborador, no puedes revocar el acceso a una copia que ya haya insertado en su experiencia; revocar el acceso impide la reinsertión o las actualizaciones de paquetes, pero las copias de paquetes en su modelo de datos se mantienen intactas. Editar El colaborador puede usar, ver y editar las versiones actuales y anteriores del paquete, incluidas las publicaciones de cambios en él.
Modificar paquetes
Puedes editar paquetes y sus hijos al igual que otros objetos. Modificar paquetes desactiva la actualización automática hasta que publiques o revertas los cambios.
La mayoría de las ediciones marcan el paquete como modificado, aunque los siguientes cambios no se consideran modificaciones de paquetes:
- Cambiar el nombre del nodo raíz .
- Cambiar la posición o la rotación de la raíz de un paquete que es un , o .
- Cambiar la propiedad habilitada de un nodo raíz GuiObject como un ScreenGui , SurfaceGui o BillboardGui .
- 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:
Añadir o actualizar configuraciones
Puedes 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 publique un paquete, el conjunto actual de atributos/valores se convertirá en las configuraciones predeterminadas del paquete .En cualquier copia dada de un paquete, las configuraciones se muestran en negrita bold y esos valores de atributos se pueden cambiar en una base por instancia.Cuando las copias de paquetes se actualizan , se preservarán los valores de configuración modificados, mientras que otros atributos se actualizarán al último valor predeterminado.
Actualmente, la única manera de manejar los valores de configuración es agregar scripts en el paquete que lean y apliquen el comportamiento basado en la configuración en tiempo de ejecución.
Si simplemente quieres actualizar los valores predeterminados de las configuraciones, puedes cambiar esos valores de atributo y publicar de nuevo el paquete (el paquete no se marcará como modificado en este caso).Si quieres publicar otras modificaciones pero no cambiar los valores de configuración predeterminados, deberías publicar en un paquete sin cambios de valor o revertir las configuraciones a sus valores predeterminados antes de publicar.
Paquetes anidados
Puedes anidar paquetes dentro de otros paquetes para mantener y colaborar en complejas jerarquías, 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 automóvil que contiene cuatro copias del mismo paquete de ruedas:
Si modifica un paquete anidado, tanto el paquete anidado como el paquete padre se consideran modificados.Debes publicar cambios a cualquier paquete anidado antes de que se te permita publicar cambios a 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 se lee solo y muestra una notificación en la parte superior con un enlace hipertexto para desbloquear el script.
Hacer clic en el enlace hipertextual:
- Marca el paquete como modificado independientemente de si edita 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 bajo él se vuelven de solo lectura con un enlace para modificar.
Revertir cambios de paquete
En lugar de deshacer una serie completa de cambios de paquetes 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 toda una serie de cambios no publicados :
En la ventana Explorador , localiza copias modificadas por el punto de exclamación junto a sus nombres.También puedes seleccionar copias modificadas en la vista 3D, lo que podría ser más fácil.
Haga clic derecho en una copia modificada única y seleccione Deshacer cambios al paquete , o seleccione múltiples copias (al menos una de ellas modificada), haga clic derecho y seleccione Deshacer cambios a los paquetes seleccionados .
Restaurar a la versión
Para restaurar un paquete a una versión previamente publicada :
En la ventana Explorador , 3D viewport, Caja de herramientas , o Administrador de recursos , haz clic derecho en el paquete deseado y selecciona Detalles del paquete .
En la ventana Configuración de recursos , seleccione Versiones .La ventana muestra detalles para cada versión publicada, incluidas la fecha y la hora de publicación, junto con cualquier descripción de los cambios.
Haga clic en la marca de verificación junto a la versión que desea restaurar y haga clic en Enviar .
Revertir cambios a un paquete no restablece la configuración al predeterminado. Vea Revertir la configuración.
Revertir configuraciones
Para revertir cualquier atributo de configuración a su valor predeterminado, seleccione la opción Reestablecer de la sección Atributos de la ventana Propiedades .
Comparar versiones de paquetes
Cuando un paquete tiene múltiples versiones, puedes comparar cambios entre versiones usando el visor de diferencias, que es útil para revisar actualizaciones de paquetes, comparar tus cambios locales contra la última versión y verificar el contenido de 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 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 de línea en 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:
En la ventana Explorador o 3D viewport, haz clic derecho en el paquete objetivo y selecciona Comparar versiones de paquetes .
Por defecto, la ventana compara cambios entre tu copia local y la versión más reciente. Usa los dos menús desplegables para comparar diferentes versiones.
Algunas versiones más antiguas pueden ser incompatibles con la herramienta de diferencias de paquetes.
Después de seleccionar versiones:
Para comparar las representaciones visuales del modelo raíz, si es aplicable, seleccione la pestaña visualización general y ajuste el control de la cámara para el ángulo deseado.Los controles se sincronizan entre vistas:
- Panear la cámara usando clics izquierdos del mouse.
- Gira la cámara usando los clics derechos del ratón.
- Acercar y alejar la cámara con la rueda del ratón.
- Recentrar usando el atajo de teclado -F.
Para comparar las 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 pestaña Script para cambios de línea a línea entre las versiones seleccionadas, similar a las aplicaciones de control de fuentes.
Esta herramienta solo te permite comparar cambios de guiones entre la versión actual y la versión más reciente publicada o local, sin indicar a los colaboradores que hicieron el cambio.
Alternativamente, puede abrir la herramienta de diferencia de script directamente:
- En la ventana Explorador o 3D viewport, haz clic derecho en el paquete objetivo, que debe ser un script o contener scripts, y selecciona Ver cambios de script .
- En la pestaña de diferencias que se abre, compara todos los cambios del script seleccionado entre la copia del paquete actual y la versión más reciente publicada o local.