Paquets

Pour garder les actifs organisés et réutilisables au sein de votre équipe ou à travers plusieurs projets, vous pouvez regrouper vos instances et les convertir en paquets réutilisables. Les paquets rendent le processus global de construction de mondes plus rapide et plus ergonomique, mais ils aident également à la cohérence, à la déduplication, à la collaboration et à la gestion des versions :

• Mettez facilement à jour toutes les copies d'un paquet vers la dernière version, ou mettez à jour uniquement des copies spécifiques.
• Configurez les paquets pour se mettre à jour automatiquement chaque fois qu'une nouvelle version est disponible.
• Donnez aux collaborateurs des permissions Modifier ou Utiliser le contenu d'un paquet.
• Consultez l'historique complet des versions d'un paquet, comparez les versions et restaurez les anciennes versions.

Le flux de travail le plus efficace consiste à créer un paquet, à le partager avec des collaborateurs, et à le configurer pour une mise à jour automatique. Et vous n'avez pas à attendre qu'un modèle soit "terminé" avant de l'utiliser dans un paquet. Même si le paquet est un espace réservé sur un simple modèle, vous pouvez l'utiliser pour greyboxer votre environnement et ensuite faire en sorte que les copies d'espace réservé se mettent à jour automatiquement au fur et à mesure que vous publiez des versions plus détaillées.

Créer des paquets

Vous pouvez créer un paquet à partir de n'importe quel objet unique ou de n'importe quelle branche parent-enfants d'objets. Si vous souhaitez créer un paquet pour un objet unique, ajoutez-le d'abord à un regroupement Model afin que vous puissiez ajouter, supprimer ou redimensionner des objets enfants au sein du paquet plus tard sans casser le paquet.

Pour créer un paquet :

1. Dans la fenêtre Explorer ou dans la vue 3D, faites un clic droit sur l'objet(s) que vous souhaitez transformer en paquet et, dans le menu contextuel, sélectionnez Convertir en Paquet.

2. Dans la nouvelle fenêtre, remplissez les détails du paquet. En particulier, si vous travaillez dans un groupe, définissez Propriété sur le groupe approprié dans lequel vous avez la permission de créer/modifier des jeux de groupe.

   Les transferts de propriété ne sont pas pris en charge par le système d'actifs, donc réfléchissez bien au propriétaire lors de la création d'un paquet.

3. Cliquez sur Soumettre.

4. Après la conversion, l'objet reçoit un symbole "chaîne" dans la fenêtre Explorer pour l'identifier comme un paquet. De plus, vous pouvez voir un nouvel objet PackageLink parenté à l'objet.

   

5. OPTIONNEL

   Sélectionnez l'objet PackageLink et activez AutoUpdate dans la fenêtre Propriétés. Notez comment l'icône change pour indiquer que le paquet est configuré pour se mettre à jour automatiquement.

Insérer des paquets

Pour insérer un paquet qui n'existe pas déjà dans le lieu actuel, vous devez initialement l'insérer depuis la Boîte à outils :

• Depuis Inventaire ⟩ Mes Paquets pour les paquets que vous avez publiés ou obtenus depuis le Creator Store, ainsi que les paquets qu'un ami possède et vous a donné permissions de les utiliser.
• Depuis Créations ⟩ Paquets de Groupe pour les paquets publiés par des membres de votre groupe (y compris vous-même).

Une fois que vous avez inséré un paquet dans le modèle de données d'un lieu publié, il apparaît dans le Gestionnaire d'Actifs et y reste même si vous supprimez plus tard toutes ses copies.

Modifier des paquets

Vous pouvez modifier des paquets et leurs enfants comme d'autres objets. La modification des paquets désactive la mise à jour automatique jusqu'à ce que vous publiez ou reveniez sur les changements.

La plupart des modifications signalent le paquet comme modifié, bien que les changements suivants ne soient pas considérés comme des modifications de paquet :

• Changer le nom du nœud racine.
• Changer la position ou la rotation du nœud racine d'un paquet qui est un BasePart, Model, ou GuiObject.
• Changer la propriété Enabled d'un nœud racine GuiObject tel qu'un ScreenGui, SurfaceGui, ou BillboardGui.
• Changer une référence de partie d'un Weld à l'intérieur du paquet qui référence une instance en dehors du paquet.

Une fois modifiés, les paquets avec des changements non publiés obtiennent une icône modifiée dans la fenêtre Explorer :

Ajouter ou mettre à jour des configurations

Vous pouvez inclure des attributs d'instance à la racine d'un paquet pour personnaliser son comportement. Lorsque vous publiez un paquet, l'ensemble actuel d'attributs/valeurs devient les configurations par défaut du paquet. Sur n'importe quelle copie d'un paquet, ces valeurs d'attribut peuvent être modifiées sur une base par instance, et ces changements sont notés par des italiques en gras. Lorsque les copies de paquet sont mises à jour, les valeurs de configuration modifiées seront préservées, tandis que d'autres attributs seront mis à jour vers la dernière valeur par défaut.

Paquets imbriqués

Vous pouvez imbriquer des paquets à l'intérieur d'autres paquets pour maintenir et collaborer sur des hiérarchies complexes, telles qu'une série de mécaniques de véhicule qui peuvent être modifiées indépendamment du paquet parent du véhicule.

Si vous modifiez un paquet imbriqué, le paquet imbriqué et le paquet parent sont considérés comme modifiés. Vous devez publier les changements à tout paquet imbriqué avant d'être autorisé à publier des changements à son paquet parent, car la publication du parent le marquerait comme actuel/non modifié et entrerait en conflit avec les modifications du paquet imbriqué.

Scripts de paquet

Chaque script à l'intérieur d'un paquet non modifié est en lecture seule et affiche une notification en haut avec un lien hypertexte pour déverrouiller le script.

Cliquer sur le lien hypertexte :

• Signale le paquet comme modifié, peu importe si vous modifiez le script.
• Supprime la notification/lien hypertexte des autres scripts à l'intérieur du paquet.

Une fois le paquet publié et déplacé dans un état non modifié, les scripts qui s'y trouvent deviennent en lecture seule avec un lien hypertexte pour modifier.

Publier des changements de paquet

Vous pouvez publier tout changement apporté à un paquet en tant que nouvelle version, rendant vos mises à jour disponibles pour d'autres copies de paquet à travers le lieu et tous les jeux. Il n'est pas nécessaire de publier un paquet modifié avant de publier un lieu, car la version modifiée est enregistrée avec le lieu pour une itération future.

Pour publier des changements à un paquet :

1. Dans la fenêtre Explorer ou dans la vue 3D, faites un clic droit sur la copie modifiée et sélectionnez Publier vers Paquet.

2. Si une copie de paquet a la mise à jour automatique activée, elle tire immédiatement la version mise à jour lorsque vous ouvrez le lieu qui les contient. D'autres copies obtiennent un symbole "télécharger" qui indique qu'une mise à jour est disponible. Vous pouvez mettre à jour individuellement ou mettre à jour en masse toutes les copies.

   

3. OPTIONNEL

   Ajoutez une description de vos changements :

   1. Faites un clic droit sur le paquet et sélectionnez Détails du Paquet.
   2. Dans la fenêtre Configuration de l'Actif, sélectionnez Versions.
   3. Sous votre changement le plus récent, sélectionnez Ajouter.
   4. Décrivez vos changements, puis cliquez sur le bouton Soumettre.

Mettre à jour des copies obsolètes

Vous pouvez mettre à jour des copies de paquet obsolètes vers la version la plus récente, ou vous pouvez continuer à utiliser l'ancienne version.

1. Dans la fenêtre Explorer, localisez les copies obsolètes par le symbole "télécharger". Vous pouvez également sélectionner la copie obsolète dans la vue 3D.

   

2. Faites un clic droit sur une copie obsolète et sélectionnez Obtenir le Dernier Paquet. Vous pouvez également sélectionner plusieurs paquets, faire un clic droit et Obtenir le Dernier Pour les Paquets Sélectionnés.

Mises à jour en masse

Une utilisation extensive des paquets peut entraîner de nombreuses copies de paquet à travers plusieurs lieux dans un jeu. En plus de la synchronisation individuelle et des mises à jour automatiques, vous pouvez mettre à jour toutes les copies d'un paquet par le biais de mises à jour en masse.

1. RECOMMANDÉ

   Fermez d'autres instances de Studio avec l'un des lieux du jeu ouverts ; cela empêche une autre instance non sauvegardée d'un lieu de potentiellement écraser vos mises à jour.
2. Dans la fenêtre Explorer ou dans la vue 3D, faites un clic droit sur le paquet souhaité et sélectionnez Mettre à Jour Tout.
3. Choisissez tous les lieux du jeu ou un sous-ensemble de lieux et cliquez sur Mettre à Jour.

Mises à jour automatiques

Pour faciliter la synchronisation, vous pouvez configurer une copie de paquet pour se mettre à jour automatiquement chaque fois qu'une version plus récente est publiée. La mise à jour automatique des copies de paquet aura lieu lorsque le lieu est ouvert dans Studio.

1. Dans la fenêtre Explorer, développez l'arbre hiérarchique du paquet et sélectionnez son objet PackageLink.

   

2. Dans la fenêtre Propriétés, activez la propriété AutoUpdate. Si vous avez des paquets imbriqués, cette propriété ne s'applique qu'au paquet parent de plus haut niveau, ce qui signifie que les mises à jour automatiques n'ont lieu que lorsque le paquet parent est mis à jour.

Partager et niveaux d'accès

Vous pouvez accorder la permission à des amis, des jeux, des groupes ou des rôles d'utilisateur spécifiques au sein d'un groupe afin qu'ils puissent utiliser librement vos paquets dans leurs créations. Pour plus d'informations sur l'accès aux actifs, consultez Confidentialité des actifs.

Pour changer les permissions de paquet pour un collaborateur, tel qu'un ami ou un groupe :

1. Dans la fenêtre Explorer, Boîte à outils, ou Gestionnaire d'Actifs, faites un clic droit sur le paquet souhaité et sélectionnez Options de Paquet ⟩ Détails du Paquet.

2. Dans la fenêtre Configuration de l'Actif, sélectionnez Permissions.

3. À l'aide de la barre de recherche, saisissez et sélectionnez un collaborateur à qui vous souhaitez accorder la permission d'utiliser votre paquet, puis choisissez un niveau de permission.

   Permission	Description
   Utiliser & Voir	Le collaborateur peut utiliser et voir (mais pas modifier) les versions actuelles et précédentes du paquet. Une fois que vous avez accordé à un collaborateur cette capacité, vous ne pouvez pas révoquer l'accès à une copie qu'il a déjà insérée dans son jeu ; révoquer l'accès empêche la réinsertion ou les mises à jour de paquet, mais les copies de paquet dans son modèle de données restent intactes.
   Modifier	Le collaborateur peut utiliser, voir et modifier les versions actuelles et précédentes du paquet, y compris publier des changements.

Revenir sur les changements de paquet

Au lieu d'annuler une série entière de changements de paquet un par un, vous pouvez revenir sur les changements non publiés en une seule action, restaurer un paquet à une version précédente, ou revenir sur des changements à des configurations spécifiques.

Revenir sur les changements non publiés

Pour annuler une série entière de changements non publiés :

1. Dans la fenêtre Explorer, localisez les copies modifiées par le point sur leurs icônes de paquet. Vous pouvez également sélectionner des copies modifiées dans la vue 3D.

   

2. Faites un clic droit sur une seule copie modifiée et sélectionnez Annuler les Changements au Paquet, ou sélectionnez plusieurs copies (au moins une d'entre elles modifiée), faites un clic droit et sélectionnez Annuler les Changements aux Paquets Sélectionnés.

Restaurer à une version publiée

Pour restaurer un paquet à une version publiée précédemment :

1. Dans la fenêtre Explorer, Boîte à outils, ou Gestionnaire d'Actifs, faites un clic droit sur le paquet souhaité et sélectionnez Options de Paquet ⟩ Détails du Paquet.
2. Dans la fenêtre Configuration de l'Actif, sélectionnez Versions. La fenêtre affiche les détails de chaque version publiée, y compris la date et l'heure de publication, ainsi que toute description des changements.
3. Cliquez sur la coche à côté de la version que vous souhaitez restaurer et cliquez sur Soumettre.

Revenir sur les configurations

Pour revenir sur tout attribut de configuration à sa valeur par défaut, sélectionnez Réinitialiser dans son menu d'options dans la section Attributs de la fenêtre Propriétés.

Comparer les versions de paquet

Lorsqu'un paquet a plusieurs versions, vous pouvez comparer les changements entre les versions à l'aide de l'outil de comparaison. L'outil dispose d'un menu de hiérarchie de paquet qui indique toutes les instances ajoutées, supprimées ou modifiées entre les versions à l'aide d'icônes correspondantes, y compris les fonctionnalités suivantes :

• Aperçu Visuel montre les différences visuelles du rendu 3D sous différentes positions de caméra. C'est la vue par défaut pour les paquets avec un objet 3D (modèles, parties) comme objet racine, et elle est actuellement uniquement disponible pour l'objet racine.

• Propriétés montre les changements de propriétés et d'attributs. C'est la vue par défaut pour les paquets avec un objet non-3D (scripts, lumières, objets 2D) comme objet racine, et elle est disponible pour toutes les instances dans un paquet.

• Script montre les différences de script ligne par ligne. Elle est disponible pour les paquets contenant des scripts, peu importe si le script est l'objet racine ou non.

Pour comparer les versions de paquet :

1. Dans la fenêtre Explorer ou dans la vue 3D, faites un clic droit sur le paquet cible et sélectionnez Options de Paquet ⟩ Comparer les Versions de Paquet.

2. Par défaut, la fenêtre compare les changements entre votre copie locale et la dernière version. Utilisez les deux menus déroulants pour comparer différentes versions.

   

   Certaines versions plus anciennes pourraient être incompatibles avec l'outil de comparaison de paquet.

3. Après avoir sélectionné les versions :

   1. Pour comparer les rendus visuels du modèle racine, si applicable, sélectionnez l'onglet Aperçu Visuel et ajustez le contrôle de la caméra pour votre angle désiré. Les contrôles sont synchronisés à travers les vues :

      • Déplacez la caméra en utilisant des clics de souris gauche.
      • Faites pivoter la caméra en utilisant des clics de souris droit.
      • Zoomez et dézoomez la caméra avec la molette de la souris.
      • Recentrez en utilisant le raccourci clavier F.

   2. Pour comparer les propriétés et attributs d'une instance, sélectionnez l'instance et l'onglet Propriétés.

   3. Pour comparer les différences de script pour un paquet qui est un script ou contient des scripts, utilisez l'onglet Script.

      Cet outil ne vous permet de comparer que les changements de script entre la version actuelle et la dernière version publiée ou locale, sans indiquer les collaborateurs qui ont effectué le changement.

      Alternativement, vous pouvez ouvrir directement l'outil de comparaison de script en faisant un clic droit sur le paquet cible dans la fenêtre Explorer ou dans la vue 3D et en sélectionnant Voir les Changements de Script.