Pacchetti

Per mantenere gli asset organizzati e riutilizzabili all'interno del tuo team o tra più progetti, puoi raggruppare le tue istanze e convertirle in pacchetti riutilizzabili. I pacchetti rendono l'intero processo di costruzione dei mondi più veloce e ergonomico, ma aiutano anche con la coerenza, la deduplicazione, la collaborazione e la gestione delle versioni:

• Aggiorna facilmente tutte le copie di un pacchetto all'ultima versione, oppure aggiorna solo copie specifiche.
• Imposta i pacchetti per aggiornarsi automaticamente ogni volta che c'è una nuova versione.
• Assegna a collaboratori i permessi Modifica o Utilizza per i contenuti di un pacchetto.
• Visualizza la cronologia completa delle versioni di un pacchetto, confronta le versioni e ripristina versioni precedenti.

Il flusso di lavoro più efficiente è creare un pacchetto, condividerlo con i collaboratori e impostarlo per l'aggiornamento automatico. E non devi aspettare che un modello sia "completo" prima di utilizzarlo in un pacchetto. Anche se il pacchetto è un segnaposto sopra una forma semplice, puoi utilizzarlo per greyboxare il tuo ambiente e poi far aggiornare automaticamente le copie segnaposto man mano che pubblichi versioni più dettagliate.

Crea pacchetti

Puoi creare un pacchetto da qualsiasi oggetto singolo o da qualsiasi ramo di oggetti genitore e figli. Se desideri creare un pacchetto per un singolo oggetto, aggiungilo prima a un raggruppamento Model in modo da poter aggiungere, rimuovere o ridimensionare oggetti figli all'interno del pacchetto in seguito senza rompere il pacchetto.

Per creare un pacchetto:

1. Nella finestra Esplora o in un'area 3D, fai clic destro sull'oggetto o gli oggetti che desideri trasformare in un pacchetto e, nel menu contestuale, seleziona Converti in Pacchetto.

2. Nella nuova finestra, compila i dettagli del pacchetto. In particolare, se stai lavorando in un gruppo, imposta Proprietà sul gruppo appropriato in cui hai il permesso di creare/modificare giochi di gruppo.

   I trasferimenti di proprietà non sono supportati dal sistema di asset, quindi considera attentamente il proprietario quando crei un pacchetto.

3. Fai clic su Invia.

4. Dopo il completamento della conversione, l'oggetto riceve un simbolo "catena" nella finestra Esplora per identificarlo come un pacchetto. Inoltre, puoi vedere un nuovo oggetto PackageLink genitore dell'oggetto.

   

5. OPZIONALE

   Seleziona l'oggetto PackageLink e abilita AutoUpdate nella finestra Proprietà. Nota come l'icona cambia per indicare che il pacchetto è impostato per aggiornarsi automaticamente.

Inserisci pacchetti

Per inserire un pacchetto che non esiste già nel luogo attuale, devi inizialmente inserirlo dalla Cassetta degli attrezzi:

• Da Inventario ⟩ I Miei Pacchetti per i pacchetti che hai pubblicato o ottenuto dal Creator Store, così come pacchetti che un amico possiede e ti ha dato permessi per utilizzarli.
• Da Creazioni ⟩ Pacchetti di Gruppo per pacchetti pubblicati dai membri del tuo gruppo (incluso te stesso).

Una volta che hai inserito un pacchetto nel modello di dati di un luogo pubblicato, appare nell'Asset Manager e rimane lì anche se in seguito elimini tutte le copie di esso.

Modifica pacchetti

Puoi modificare pacchetti e i loro figli proprio come altri oggetti. La modifica dei pacchetti disabilita aggiornamenti automatici fino a quando non pubblichi o ripristini le modifiche.

La maggior parte delle modifiche contrassegna il pacchetto come modificato, anche se le seguenti modifiche non sono considerate modifiche del pacchetto:

• Cambiare il nome del nodo radice.
• Cambiare la posizione o la rotazione del nodo radice di un pacchetto che è un BasePart, Model, o GuiObject.
• Cambiare la proprietà Enabled di un nodo radice GuiObject come un ScreenGui, SurfaceGui, o BillboardGui.
• Cambiare un riferimento a una parte di un Weld all'interno del pacchetto che fa riferimento a un'istanza al di fuori del pacchetto.

Una volta modificato, i pacchetti con modifiche non pubblicate ricevono un'icona modificata nella finestra Esplora:

Aggiungi o aggiorna configurazioni

Puoi includere attributi delle istanze alla radice di un pacchetto per personalizzare il suo comportamento. Quando pubblichi un pacchetto, l'insieme attuale di attributi/valori diventerà le configurazioni predefinite del pacchetto. Su qualsiasi copia di un pacchetto, quei valori di attributo possono essere cambiati su base per istanza, e quelle modifiche sono annotate tramite corsivo grassetto. Quando le copie del pacchetto vengono aggiornate, i valori di configurazione modificati verranno mantenuti, mentre gli altri attributi verranno aggiornati al valore predefinito più recente.

Pacchetti nidificati

Puoi nidificare pacchetti all'interno di altri pacchetti per mantenere e collaborare su gerarchie complesse, come una serie di meccaniche di veicolo che possono essere modificate indipendentemente dal pacchetto principale del veicolo.

Se modifichi un pacchetto nidificato, sia il pacchetto nidificato che il pacchetto principale sono considerati come modificati. Devi pubblicare modifiche a qualsiasi pacchetto nidificato prima di poter pubblicare modifiche al suo pacchetto principale, poiché pubblicare il principale lo contrassegnerà come attuale/non modificato e confliggerebbe con le modifiche del pacchetto nidificato.

Script del pacchetto

Ogni script all'interno di un pacchetto non modificato è di sola lettura e mostra una notifica in cima con un collegamento per sbloccare lo script.

Cliccando sul collegamento:

• Contrassegna il pacchetto come modificato indipendentemente dal fatto che tu modifichi lo script.
• Rimuove la notifica/collegamento da altri script all'interno del pacchetto.

Una volta che il pacchetto viene pubblicato e spostato in uno stato non modificato, gli script al suo interno diventano di sola lettura con un collegamento per modificare.

Pubblica modifiche al pacchetto

Puoi pubblicare qualsiasi modifica a un pacchetto come nuova versione, rendendo i tuoi aggiornamenti disponibili ad altre copie del pacchetto in tutto il luogo e in tutti i giochi. Non è necessario pubblicare un pacchetto modificato prima di pubblicare un luogo, poiché la versione modificata viene salvata insieme al luogo per future iterazioni.

Per pubblicare modifiche a un pacchetto:

1. Nella finestra Esplora o in un'area 3D, fai clic destro sulla copia modificata e seleziona Pubblica su Pacchetto.

2. Se una copia del pacchetto ha l'aggiornamento automatico attivato, essa recupera immediatamente la versione aggiornata quando apri il luogo che le contiene. Altre copie ricevono un simbolo "download" che indica che è disponibile un aggiornamento. Puoi aggiornare individualmente o aggiornare di massa tutte le copie.

   

3. OPZIONALE

   Aggiungi una descrizione delle tue modifiche:

   1. Fai clic destro sul pacchetto e seleziona Dettagli Pacchetto.
   2. Nella finestra Configurazione Asset, seleziona Versioni.
   3. Sotto la tua modifica più recente, seleziona Aggiungi.
   4. Descrivi le tue modifiche, quindi fai clic sul pulsante Invia.

Aggiorna copie obsolete

Puoi aggiornare le copie obsolete del pacchetto all'ultima versione, oppure puoi continuare a utilizzare la versione più vecchia.

1. Nella finestra Esplora, individua le copie obsolete tramite il simbolo "download". Puoi anche selezionare la copia obsoleta nell'area 3D.

   

2. Fai clic destro su una copia obsoleta e seleziona Ottieni Ultimo Pacchetto. Puoi anche selezionare più pacchetti, fare clic destro e Ottieni Ultimo per Pacchetti Selezionati.

Aggiornamenti di massa

Un uso estensivo dei pacchetti può comportare molte copie di pacchetti in più luoghi in un gioco. Oltre alla sincronizzazione individuale e agli aggiornamenti automatici, puoi aggiornare tutte le copie di un pacchetto tramite aggiornamenti di massa.

1. RACCOMANDATO

   Chiudi altre istanze di Studio con qualsiasi luogo del gioco aperto; questo impedisce a un'altra istanza non salvata di un luogo di sovrascrivere potenzialmente i tuoi aggiornamenti.
2. Nella finestra Esplora o nell'area 3D, fai clic destro sul pacchetto desiderato e seleziona Aggiorna Tutto.
3. Scegli tutti i luoghi nel gioco o un sottoinsieme di luoghi e fai clic su Aggiorna.

Aggiornamenti automatici

Per facilitare la sincronizzazione, puoi impostare una copia del pacchetto per aggiornarsi automaticamente ogni volta che viene pubblicata una versione più recente. L'aggiornamento automatico delle copie del pacchetto avverrà quando un luogo viene aperto in Studio.

1. Nella finestra Esplora, espandi l'albero gerarchico del pacchetto e seleziona il suo oggetto PackageLink.

   

2. Nella finestra Proprietà, abilita la proprietà AutoUpdate. Se hai pacchetti nidificati, questa proprietà si applica solo al pacchetto principale di livello più alto, il che significa che gli aggiornamenti automatici si verificano solo quando il pacchetto principale viene aggiornato.

Condividi e livelli di accesso

Puoi concedere permessi ad amici, giochi, gruppi o ruoli utente di gruppo specifici in modo che possano utilizzare liberamente i tuoi pacchetti nelle loro creazioni. Per ulteriori informazioni sull'accesso agli asset, consulta Privacy degli asset.

Per modificare i permessi del pacchetto per un collaboratore, come un amico o un gruppo:

1. Nella finestra Esplora, Cassetta degli attrezzi o Asset Manager, fai clic destro sul pacchetto desiderato e seleziona Opzioni Pacchetto ⟩ Dettagli Pacchetto.

2. Nella finestra Configurazione Asset, seleziona Permessi.

3. Utilizzando la barra di ricerca, immetti e seleziona un collaboratore a cui desideri concedere il permesso di utilizzare il tuo pacchetto, quindi scegli un livello di permesso.

   Permesso	Descrizione
   Usa & Visualizza	Il collaboratore può utilizzare e visualizzare (ma non modificare) le versioni correnti e precedenti del pacchetto. Una volta che fornisci a un collaboratore questa possibilità, non puoi revocare l'accesso a una copia che hanno già inserito nel loro gioco; revocare l'accesso impedisce la reinserimento o gli aggiornamenti del pacchetto, ma le copie del pacchetto nel loro modello di dati rimangono intatte.
   Modifica	Il collaboratore può utilizzare, visualizzare e modificare le versioni correnti e precedenti del pacchetto, inclusa la pubblicazione delle modifiche ad esso.

Ripristina modifiche al pacchetto

Invece di annullare un'intera serie di modifiche al pacchetto una per una, puoi ripristinare modifiche non pubblicate in un'unica azione, ripristinare un pacchetto a una versione precedente o ripristinare modifiche a specifici configurazioni.

Ripristina modifiche non pubblicate

Per annullare un'intera serie di modifiche non pubblicate:

1. Nella finestra Esplora, individua le copie modificate tramite il punto sulle loro icone del pacchetto. Puoi anche selezionare copie modificate nell'area 3D.

   

2. Fai clic destro su una singola copia modificata e seleziona Annulla Modifiche al Pacchetto, oppure seleziona più copie (almeno una di esse modificata), fai clic destro e seleziona Annulla Modifiche ai Pacchetti Selezionati.

Ripristina a versione pubblicata

Per ripristinare un pacchetto a una versione pubblicata in precedenza:

1. Nella finestra Esplora, Cassetta degli attrezzi o Asset Manager, fai clic destro sul pacchetto desiderato e seleziona Opzioni Pacchetto ⟩ Dettagli Pacchetto.
2. Nella finestra Configurazione Asset, seleziona Versioni. La finestra visualizza i dettagli per ciascuna versione pubblicata, inclusa la data e l'ora di pubblicazione, insieme a qualsiasi descrizione delle modifiche.
3. Fai clic sulla casella accanto alla versione che desideri ripristinare e fai clic su Invia.

Ripristina configurazioni

Per ripristinare qualsiasi attributo di configurazione al suo valore predefinito, seleziona Ripristina dal menu opzioni nella sezione Attributi della finestra Proprietà.

Confronta versioni del pacchetto

Quando un pacchetto ha più versioni, puoi confrontare le modifiche tra le versioni utilizzando il visualizzatore diff. Lo strumento ha un menu gerarchico del pacchetto che indica tutte le istanze aggiunte, rimosse o modificate tra le versioni utilizzando icone corrispondenti, comprese le seguenti funzionalità:

• Panoramica Visiva mostra le differenze visive del rendering 3D sotto diverse posizioni della telecamera. È la vista predefinita per pacchetti con un oggetto 3D (modelli, parti) come oggetto radice, ed è attualmente disponibile solo per l'oggetto radice.

• Proprietà mostra le modifiche delle proprietà e degli attributi. È la vista predefinita per pacchetti con un oggetto non 3D (script, luci, oggetti 2D) come oggetto radice, ed è disponibile per tutte le istanze in un pacchetto.

• Script mostra le differenze di script riga per riga. È disponibile per pacchetti contenenti script, indipendentemente dal fatto che lo script sia l'oggetto radice o meno.

Per confrontare le versioni del pacchetto:

1. Nella finestra Esplora o nell'area 3D, fai clic destro sul pacchetto target e seleziona Opzioni Pacchetto ⟩ Confronta Versioni del Pacchetto.

2. Di default, la finestra confronta le modifiche tra la tua copia locale e l'ultima versione. Usa i due menu a discesa per confrontare versioni diverse.

   

   Alcune versioni più vecchie potrebbero non essere compatibili con lo strumento di differenziazione dei pacchetti.

3. Dopo aver selezionato le versioni:

   1. Per confrontare i rendering visivi del modello radice, se applicabile, seleziona la scheda Panoramica Visiva e regola il controllo della telecamera per il tuo angolo desiderato. I controlli sono sincronizzati tra le visualizzazioni:

      • Sposta la telecamera utilizzando clic con il pulsante sinistro del mouse.
      • Ruota la telecamera utilizzando clic con il pulsante destro del mouse.
      • Zooma in e out con la rotella del mouse.
      • Ri-centra utilizzando la scorciatoia da tastiera F.

   2. Per confrontare le proprietà e gli attributi di un'istanza, seleziona l'istanza e la scheda Proprietà.

   3. Per confrontare le differenze di script per un pacchetto che è uno script o contiene script, utilizza la scheda Script.

      Questo strumento ti consente solo di confrontare le modifiche agli script tra la versione attuale e l'ultima versione pubblicata o locale, senza indicare i collaboratori che hanno effettuato la modifica.

      In alternativa, puoi aprire direttamente lo strumento di differenziazione degli script facendo clic destro sul pacchetto target nella finestra Esplora o nell'area 3D e selezionando Visualizza Modifiche Script.