Pour garder les ressources organisées et réutilisables dans votre équipe ou sur plusieurs projets, organisez vos instances et convertissez-les en des paquets réutilisables. Les paquets rendent le processus de construction des mondes plus rapide et plus ergonomique, mais ils aident également avec la cohérence, la duplication, la collaboration et la versionnalisation :
- Facilement mettre à jour toutes les copies d'un package à la dernière version (ou seulement mettre à jour des copies spécifiques ).
- Définir les mises à jour automatiquement à chaque nouvelle version lorsqu'il y a une nouvelle version.
- Donnez aux collaborateurs Modifier ou Utiliser les permissions pour le contenu d'un package.
- Affichez l'historique de la version complète pour un package, comparez les versions et restaurez les anciennes versions.
Le workflow le plus efficace est de créer un package >, le partager avec n'importe quel collaborateur et le configurer pour auto-mettre à jour. Et vous n'avez pas à attendre qu'un modèle soit « terminé » avant d'utiliser le package. Même si le package est un placeholder au-dessus d'une simple forme, vous pouvez l'utiliser pour
Créer des paquets
Vous pouvez créer un package à partir de n'importe quel seul objet ou de n'importe quelle branche parent-enfant d'objets. Si vous voulez créer un package pour un seul objet, nous recommandons d'ajouter-le à un Model groupeant d'abord afin que vous puissiez ajouter, retirerou dimensionner une instance dans le package plus tard sans briser le package.
Dans la fenêtre Explorer ou la fenêtre de jeu3D, faites un clic droit sur l'objet souhaité et sélectionnez Convertir en Package .
Dans la nouvelle fenêtre, remplissez les détails du package. En particulier, si vous travaillez dans un groupe, définissez Possédétenez à l'article de groupe approprié dans lequel vous avez la permission de créer/modifier des expériences de groupe.
Les transferts de propriété ne sont pas pris en charge par le système de gestion des ressources, alors ne pas prendre en compte le propriétaire lors de la création d'un package.
Cliquez sur Envoyer .
Une fois la conversion terminée, l'objet reçoit un symbole lier« chaîne » dans la fenêtre Explorer pour l'identifier comme un package. De plus, vous pouvez voir un nouveau PackageLink objet parenté à l'objet.
(Facultatif) 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 package est configuré pour s'auto-mettre à jour automatiquement.
Ne supprimez pas ou ne déplacez pas l'instance PackageLink ! En le faisant pour n'importe quelle copie de paquet, vous transformez la copie en un objet normal et perdez les capacités de paquet telles que la capacité de mise à jour lorsqu'il y a une nouvelle version.
Insérer des packages
Pour insérer un package qui n'existe pas déjà dans le emplacementactuel, vous devez d'abord insérer le package dans la boîte à outils :
- À partir de Inventaire → Mes packs pour les packs que vous avez publiés dans ou obtenus à partir de la boutique des créateurs, ainsi que les packs que un ami possède et vous a donné 1> les permissions1> d'utiliser.
- À partir de Créations → Packages de groupe pour les packages publiés par les membres de votre groupe (y compris vous-même).
Une fois que vous avez inséré un package dans le modèlisationde données d'un emplacement, il apparaît dans le Packages dossier du Gestionnaire des ressources et reste là même si vous supprimez plus tard toutes les copies de lui. Cependant, lorsque vous publiez le emplacement, le dossier sera mis à jour pour refléter uniquement les packages utilisés dans le emplacement.
Faites attention lorsque vous insérez des ressources que vous n'avez pas créées dans vos expériences, car elles peuvent contenir des scripts malveillants. Enregistrez d'abord votre expérience et puis enquêtez sur tout les scripts dans les ressources non familiers afin de pouvoir facilement revenir à la version de lieu.
Publier les modifications de package
Vous pouvez publier n'importe quelle modification que vous apportez à un package en tant que nouvelle version pour les rendre disponibles à d'autres copies du package dans le lieu et dans toutes les expériences. Notez que c'est pas requis de publier un package modifié avant de publier un lieu (la version modifiée est enregistrée avec le lieu pour l'itération future).
Pour publier des modifications dans un package :
Dans la fenêtre Explorateur ou la fenêtre de jeu3D, faites un clic droit sur la copie modifiée et sélectionnez Publier dans le package .
Si une copie de package a mise à jour automatique activée, elle met immédiatement à jour la version mise à jour quand vous ouvrez le lieu qui les contient. Les autres copies obtiennent un point blanc sur l'icône de package qui indique qu'une mise à jour est disponible. Vous pouvez mettre à jour individuellement ou mettre à jour en masse eux comme nécessaire.
(Facultatif) Ajoutez une description de vos modifications :
- Faites un clic droit sur le package et sélectionnez Détails du package .
- Dans la fenêtre de configuration des ressources, sélectionnez les versions .
- Sous votre dernière modification, sélectionnez Ajouter .
- Décrivez vos modifications et cliquez sur Envoyer .
Mise à jour des copies obsolètes
Vous pouvez mettre à jour les copies de paquet obsolètes vers la dernière version, ou vous pouvez continuer à utiliser l'ancienne version.
Pour mettre à jour une ou plusieurs copies de package vers la dernière version :
Dans la fenêtre Explorateur, localisez les copies obsolètes par le point blanc sur l'icône de package. Vous pouvez également sélectionner la copie obsolète dans la fenêtre de jeu3D, mais cela peut être plus difficile à trouver.
Faites un clic droit sur la copie obsolète et sélectionnez Obtenir le dernier package . Vous pouvez également sélectionner plusieurs packages, faire un clic droit et Obtenir le dernier forfait sélectionné .
Mises à jour en masse
L'utilisation extensive des packages peut entraîner de nombreuses copies de packages dans plusieurs lieux dans une expérience. En plus de synchronisation individuelle et mises à jour automatiques, vous pouvez mettre à jour toutes les copies d'un package via mise à jour en masse.
(Recommandé) Fermez d'autres instances Studio avec l'un des endroits de l'expérience ouvert ; cela empêche une autre instance non enregistrée d'un lieu de potentiellement écraser vos mises à jour.
Dans la fenêtre Explorer ou la fenêtre de jeu3D, faites un clic droit sur le package souhaité et sélectionnez Mettre à jour tout .
Choisissez tous les endroits dans l'expérience ou un sous-ensemble d'endroits et cliquez sur Mettre à jour .
Pour empêcher les écrasures non prévues, la mise à jour en masse n'affecte pas les versions modifiées d'un package. Après la fin de la mise à jour en masse, Studio affiche un avertissement avec le nombre de packages qu'il a ne pas mis à jour, s'il y en a.
La mise à jour automatique des paquets sauvegarde automatiquement les lieux sélectionnés mais ne les publie pas.
Mises à jour automatiques
Pour rendre la synchronisation plus facile, vous pouvez configurer une copie de paquet pour se mettre à jour automatiquement chaque fois qu'une nouvelle version est publiée. La mise à jour automatique des copies de paquet se produira lorsqu'un lieu est ouvert dans Studio.
Dans la Explorateur fenêtre, élargissez l'arbre de hiérarchie du package et sélectionnez son objet PackageLink .
Dans la fenêtre propriétés, activez la propriété Mise à jour automatique. Si vous avez packages imbriqués, cette propriété ne s'applique qu'au parent de niveau supérieur, ce qui signifie que les mises à jour automatiques ne se produisent que lorsque le parent de niveau supérieur est mis à jour.
La mise à jour automatique ne s'applique pas aux copies de package modifiées. Une fois que vous avez modifié une instance de package, sa propriété AutoUpdate devient désactivée et est ignorée.
Niveaux d'accès et de partage
Si vous le souhaitez, vous pouvez partager des paquets avec des amis ou accorder l'accès à des rôles d'utilisateur spécifiques dans votre groupe.
Dans l'Explorer, la Boîte à outils ou le Gestionnaire des ressources, faites un clic droit sur le paquet souhaité et sélectionnez Détails du paquet .
Dans la fenêtre de configuration des ressources, sélectionnez permissions .
Pour un groupe possédé package, élargissez l'arbre des rôles. Puis choisissez un niveau d'autorisation pour chaque rôle. Les cases de sélection qui sont désactivées indiquent que l'autorisation est déjà configurée pour ce rôle et ne peut pas être modifiée à partir de cette fenêtre.
Permission Description Modifier Les membres du rôle peuvent utiliser, voiret modifier les versions actuelles et précédentes des packs, y compris la publication de modifications à son sujet. L'accès à l'édition à partir de cette fenêtre ne donne accès qu'à la pack spécifique . Pas d'accès Les membres du rôle n'ont pas accès à toutes les nouvelles versions du package, bien que они conservent l'accès à la version actuelle insérée dans le emplacement. Pour un package appartenant à l'utilisateur , recherchez des amis via le champ de recherche, cliquez sur leur nom d'utilisateur et choisissez un niveau d'autorisation.
Permission Description Utiliser et afficher L'utilisateur peut utiliser et afficher (mais pas modifier) les versions actuelles et précédentes des packs. Une fois que vous avez donné une permission à un utilisateur d'utiliser cette capacité, vous ne pouvez pas révoquer l'accès à une copie qu'ils ont déjà insérée dans leur expérience ; révoquer l'accès empêche la réinsertion ou les mises à jour de packs, mais les copies de packs dans leur modèle de données restent intacts. Modifier L'utilisateur peut utiliser, voiret modifier les versions actuelles et précédentes des packs, y compris la publication de modifications.
Modification des packages
Vous pouvez modifier les packages et leurs enfants comme d'autres objets. La modification des packages désactive la mise à jour automatique jusqu'à ce que vous publiez ou révertiez les changements.
La plupart des modifications édite le package comme modifié, bien que les modifications suivantes ne soient pas prises en compte :
- Modifier le nom du nœud racine.
- Modifier la position ou la rotation du nœud de racine d'un package qui est un Class.BasePart , BasePart ou 1> Class.GuiObject1> .
- Modifier une référence d'une partie d'un Weld à l'intérieur du package qui référence une instance en dehors du package.
Une fois modifié, les paquets avec des modifications non publiées obtiennent une icône modifiée dans la Explorateur fenêtre :
Ajouter ou mettre à jour les paramètres
Vous pouvez inclure attributs d'instance à la racine d'un package pour personnaliser son comportement, par exemple la vitesse maximale d'un véhicule packagé ou le débounce time for a packagé button.
Lorsque vous publiez un package, le ensemble d'attributs/de valeurs actuel deviendra le package's 配置 par défaut . Sur n'importe quelle copie d'un package, les configurations sont affichées en italiques en surbrillance et ces valeurs d'attribut peuvent être modifiées sur une base par instance. Lorsque les copies de packages sont mises à jour, les valeurs de configuration modifiées seront préservées, tandis que les autres vale
Actuellement, la seule façon de gérer les valeurs de configuration est d'ajouter des scripts dans le package qui lisent et appliquent le comportement en fonction du comportement au moment de l'exécution.
Si vous souhaitez simplement mettre à jour les valeurs par défaut pour les applications pour les配置, vous pouvez modifier ces valeurs d'attribut et republier le package (le package ne sera pas marqué comme modifié dans ce cas). Si vous voulez publier d'autres modifications mais pas changer les valeurs de configuration par défaut, vous devriez publier sur un package sans aucun changement de valeur, ou revenir aux valeurs par défaut avant de publier.
Packages imbriqués
Vous pouvez imbriquer des packages dans d'autres packages pour maintenir et collaborer sur des hiérarchies complexes, telles qu'une série de mécaniques de véhicules qui peuvent être modifiés indépendamment du package parent du véhicule. Cet exemple montre un package de voiture qui contient quatre copies du même package de roues :
Si vous modifiez un package imbriqué, le package imbriqué et le parent sont considérés comme modifiés. Vous devez publier les modifications à tout le parent imbriqué avant d'être autorisé à publier les modifications à son 1> parent imbriqué1> package, car la publication du parent marquerait le comme actuel/non modifié et pourrait entrer en conflit avec les modifications du package imbri
Scripts de package
Chaque script dans un package non modifié est l'objet d'une lecture seule et affiche une notification au-dessus avec un lien hypertexte pour déverrouiller le script.
Cliquez sur le lien hipertexte :
- Marque le package modifié indépendamment de si vous éditez le script.
- Supprime la notification/hyperlien à partir de autres scripts dans le package.
Une fois que le package est publié et déplacé dans un état non modifié, les scripts sous lui deviennent lisibles avec un lien hypertexte pour modifier.
Revenir aux modifications du package
Au lieu de annuler une série entière de changements de package un par un, vous pouvez rétablir les modifications non publiées dans une action, restaurer un package à une version précédente version ou rétablir les modifications dans des 配置 spécifiques .
Revenir aux modifications non publiées
Pour annuler une série entière de modifications non publiées :
Dans la fenêtre Explorer, localisez les copies modifiées par le point d'exclamation à côté de leurs noms. Vous pouvez également sélectionner des copies modifiées dans la fenêtre de jeu3D, ce qui peut être plus facile.
Faites un clic droit sur une seule copie modifiée et sélectionnez annuler les modifications des paquets , ou sélectionnez plusieurs copies (au moins l'une d'elles modifiée), faites un clic droit et sélectionnez annuler les modifications des paquets sélectionnés .
Restauration à la version
Pour restaurer un package à une version publiée précédemment :
Dans la fenêtre Explorateur, 3D fenêtre de jeu, Toolbox, ou Gestionnaire des contenus, faites un clic droit sur le package souhaité et sélectionnez Détails du package .
Dans la fenêtre de configuration des ressources, sélectionnez les versions . La fenêtre affiche les détails pour chaque version publique, y compris la date et l'heure de publication, ainsi que toute description des modifications.
Cliquez sur le checkmark à côté de la version que vous souhaitez restaurer et cliquez sur Envoyer .
Revenir les modifications à un package ne réinitialise pas la configuration par défaut. Voir Reverir la configuration .
Restauration des paramètres
Pour rétablir n'importe quelle attribut de configuration à sa valeur par défaut, sélectionnez l'option Réinitialiser dans le menu de l'engin dans la section Attributs de la fenêtre 2> propriétés2>.
Comparaison des versions de package
Lorsqu'un package a plusieurs versions, vous pouvez comparer les modifications entre les versions en utilisant le diff viewer, qui est utile pour la révision des mises à jour de package, la comparaison de vos modifications locales contre la dernière version et le check du contenu des versions antérieures avant la restauration.
L'outil a un menu de hiérarchie de package qui indique toutes les instances ajoutées, supprimées ou modifiées entre les versions en utilisant les icônes correspondantes, avec les onglets suivants disponibles :
Aperçu visuel montre les différences visuelles de la rendu 3D sous différentes positions de caméra. C'est la vue par défaut pour les packs avec un objet 3D (modèles, pièces) comme l'objet racine, et il n'est actuellement disponible que pour l'objet racine.
propriétés montre les modifications des propriétés et des attributs. C'est la vue par défaut pour les packs avec un objet non 3D (scripts, lumières, objets 2D) en tant qu'objet racine, et il est disponible pour toutes les instances dans un pack.
Script montre les différences de script ligne par ligne. Il est disponible pour les packages contenant des scripts, quelle que soit l'objet racine ou non.
Pour comparer les versions des paquets :
Dans la fenêtre Explorer ou la fenêtre de jeu3D, faites un clic droit sur le package cible et sélectionnez Comparer les versions du package .
Par défaut, la fenêtre compare les modifications entre votre copie locale et la dernière version. Utilisez les deux menus déroulants pour comparer les différentes versions.
Certaines anciennes versions peuvent être incompatibles avec l'outil de diff de package.
Après avoir sélectionné les versions :
Pour comparer les rendus visuels du modèlisationde racine, le cas applicable, sélectionnez l' Aperçu visuel onglet et ajustez le contrôle de la caméra pour votre angle souhaité. Les contrôles sont synchronisés à travers les vues :
- Panneau la caméra en utilisant les clics de souris à gauche.
- Faites pivoter la caméra en utilisant les clics de souris droits.
- Zoomez dans et hors la caméra avec la molette de la souris.
- Récupérer à l'aide du raccourci clavier -F.
Pour comparer les propriétés et les attributs d'une instance, sélectionnez l'instance et l'onglet Propriétés .
Pour comparer les différences de script, si applicable, sélectionnez n'importe quel script pour ouvrir l'onglet Script pour les modifications ligne par ligne entre vos versions sélectionnées, similaires aux applications de contrôle de la source.
Cet outil ne vous permet que de comparer les modifications de script entre la version actuelle et la dernière version publiée ou locale, sans indiquer les collaborateurs qui ont apporté la modification.
Alternativement, vous pouvez ouvrir l'outil de script directement :
- Dans la fenêtre Explorer ou la fenêtre de jeu3D, faites un clic droit sur le package cible, qui doit soit être un script, soit contenir des scripts, et sélectionnez Afficher les modifications de script .
- Dans l'onglet affichage qui s'ouvre, comparez toutes les modifications du script sélectionné entre la copie de paquet actuelle et la dernière version publiée ou locale.