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 più 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.
- Dai ai collaboratori permessi di Modifica o Utilizzo sui 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 eventuali collaboratori e impostarlo per l'aggiornamento automatico. E non devi aspettare che un modello sia "completo" prima di usarlo in un pacchetto. Anche se il pacchetto è un segnaposto su una forma semplice, puoi usarlo per greyboxare il tuo ambiente e poi avere le copie del segnaposto che si aggiornano automaticamente man mano che pubblichi versioni più dettagliate.
Crea pacchetti
Se desideri creare un pacchetto con asset riservati di cui non hai permesso esplicito di utilizzo, puoi comunque creare il pacchetto, ma quegli asset riservati specifici non saranno visibili o udibili durante l'esecuzione a meno che il gioco stesso non abbia il permesso di utilizzare quegli asset.
Puoi creare un pacchetto da qualsiasi singolo oggetto 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 scalare oggetti figli all'interno del pacchetto in seguito senza rompere il pacchetto.
Per creare un pacchetto:
Nella finestra Explorer o nel viewport 3D, fai clic con il tasto destro sugli oggetti che desideri trasformare in un pacchetto e, nel menu contestuale, seleziona Converti in Pacchetto.
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 degli asset, quindi considera attentamente il proprietario quando crei un pacchetto.
Fai clic su Invia.
Dopo che la conversione è completata, l'oggetto riceve un simbolo "catena" nella finestra Explorer per identificarlo come un pacchetto. Inoltre, puoi vedere un nuovo oggetto PackageLink genitore dell'oggetto.
- OPZIONALESeleziona l'oggetto PackageLink e abilita AutoUpdate nella finestra Proprietà. Nota come l'icona cambia per indicare che il pacchetto è impostato per aggiornarsi automaticamente.
Non eliminare o spostare l'oggetto PackageLink! Farlo per qualsiasi copia del pacchetto converte la copia di nuovo in un oggetto normale e perde le capacità del pacchetto, come la possibilità di aggiornarsi quando c'è una nuova versione.
Inserisci pacchetti
Per inserire un pacchetto che non esiste già nel luogo attuale, devi inizialmente inserirlo dal Toolbox:
- Da Inventario ⟩ I miei pacchetti per i pacchetti che hai pubblicato o ottenuto dal Creator Store, così come i pacchetti di cui un amico è proprietario e ti ha dato permessi per usarli.
- Da Creazioni ⟩ Pacchetti di gruppo per i 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 successivamente elimini tutte le sue copie.
Fai attenzione quando inserisci asset che non hai creato nei tuoi giochi, poiché possono contenere script dannosi. Salva prima il tuo gioco e poi indaga su eventuali script all'interno di asset sconosciuti in modo da poter tornare facilmente alla versione del luogo.
Modifica pacchetti
Puoi modificare i pacchetti e i loro figli proprio come altri oggetti. Modificare i pacchetti disabilita l'aggiornamento automatico 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 al pacchetto:
- Cambiare il nome del nodo radice.
- Cambiare la proprietà Enabled di un nodo radice GuiObject come un ScreenGui, SurfaceGui o BillboardGui.
- Cambiare un riferimento a parte di un Weld all'interno del pacchetto che fa riferimento a un'istanza al di fuori del pacchetto.
Una volta modificati, i pacchetti con modifiche non pubblicate ottengono un'icona modificata nella finestra Explorer:
Aggiungi o aggiorna configurazioni
Puoi includere attributi di istanza alla radice di un pacchetto per personalizzarne il comportamento. Quando pubblichi un pacchetto, l'attuale insieme di attributi/valori diventa 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 preservati, mentre altri attributi verranno aggiornati al valore predefinito più recente.
Attualmente l'unico modo per gestire i valori di configurazione è aggiungere script nel pacchetto che leggono e applicano il comportamento in base alla configurazione durante l'esecuzione.
Se desideri semplicemente aggiornare i valori predefiniti per le configurazioni, puoi cambiare quei valori di attributo e ripubblicare il pacchetto (il pacchetto non verrà contrassegnato come modificato in questo caso). Se desideri pubblicare altre modifiche ma non cambiare i valori di configurazione predefiniti, dovresti pubblicare su un pacchetto senza alcuna modifica di valore, oppure ripristinare le configurazioni ai loro valori predefiniti prima di pubblicare.
Pacchetti annidati
Puoi annidare pacchetti all'interno di altri pacchetti per mantenere e collaborare su gerarchie complesse, come una serie di meccaniche di veicoli che possono essere modificate indipendentemente dal pacchetto genitore del veicolo.
Se modifichi un pacchetto annidato, sia il pacchetto annidato che il pacchetto genitore sono considerati modificati. Devi pubblicare le modifiche a qualsiasi pacchetto annidato prima di poter pubblicare modifiche al suo pacchetto genitore, poiché la pubblicazione del genitore lo contrassegnerebbe come attuale/non modificato e confliggerebbe con le modifiche del pacchetto annidato.
Script del pacchetto
Ogni script all'interno di un pacchetto non modificato è di sola lettura e mostra una notifica in alto con un collegamento ipertestuale per sbloccare lo script.
Facendo clic sul collegamento ipertestuale:
- 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 è pubblicato e spostato in uno stato non modificato, gli script al suo interno diventano di sola lettura con un collegamento ipertestuale per modificare.
Pubblica modifiche al pacchetto
Puoi pubblicare qualsiasi modifica a un pacchetto come una 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 perché la versione modificata viene salvata insieme al luogo per future iterazioni.
Per pubblicare modifiche a un pacchetto:
Nella finestra Explorer o nel viewport 3D, fai clic con il tasto destro sulla copia modificata e seleziona Pubblica su Pacchetto.
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 ottengono un simbolo "download" che indica che è disponibile un aggiornamento. Puoi aggiornare individualmente o aggiornare in massa tutte le copie.
- OPZIONALEAggiungi una descrizione delle tue modifiche:
- Fai clic con il tasto destro sul pacchetto e seleziona Dettagli pacchetto.
- Nella finestra Configurazione asset, seleziona Versioni.
- Sotto la tua modifica più recente, seleziona Aggiungi.
- 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 precedente.
Nella finestra Explorer , individua le copie obsolete tramite il simbolo "download". Puoi anche selezionare la copia obsoleta nel viewport 3D.
Fai clic con il tasto destro su una copia obsoleta e seleziona Ottieni pacchetto più recente. Puoi anche selezionare più pacchetti, fare clic con il tasto destro e Ottieni il più recente per i pacchetti selezionati.
Aggiornamenti in massa
L'uso estensivo di 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 in massa.
- RACCOMANDATOChiudi altre istanze di Studio con uno qualsiasi dei luoghi del gioco aperti; questo previene un'altra istanza non salvata di un luogo che potrebbe sovrascrivere i tuoi aggiornamenti.
- Nella finestra Explorer o nel viewport 3D, fai clic con il tasto destro sul pacchetto desiderato e seleziona Aggiorna tutto.
- Scegli tutti i luoghi nel gioco o un sottoinsieme di luoghi e fai clic su Aggiorna.
L'aggiornamento in massa dei pacchetti salva automaticamente i luoghi selezionati ma non li pubblica. Inoltre, per prevenire sovrascritture indesiderate, l'aggiornamento in massa non influisce sulle versioni modificate di un pacchetto; dopo il completamento dell'aggiornamento in massa, Studio visualizza un avviso con il numero di pacchetti che non ha aggiornato, se ce ne sono.
Aggiornamenti automatici
Per semplificare 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.
Nella finestra Explorer , espandi l'albero gerarchico del pacchetto e seleziona il suo oggetto PackageLink.
Nella finestra Proprietà , abilita la proprietà AutoUpdate. Se hai pacchetti annidati, questa proprietà si applica solo al pacchetto genitore di livello più alto, il che significa che gli aggiornamenti automatici si verificano solo quando il pacchetto genitore viene aggiornato.
L'aggiornamento automatico non si applica alle copie di pacchetti modificate. Una volta che modifichi un'istanza di pacchetto, la sua proprietà AutoUpdate diventa disabilitata e viene ignorata.
Condivisione e livelli di accesso
Puoi concedere permessi a amici, giochi, gruppi o ruoli utente specifici di un gruppo in modo che possano utilizzare liberamente i tuoi pacchetti nelle loro creazioni. Per ulteriori informazioni sull'accesso agli asset, consulta Privacy degli asset.
Se condividi un pacchetto con asset riservati di cui non hai permesso esplicito di utilizzo, puoi comunque condividere il pacchetto, ma quegli asset riservati specifici non saranno visibili o udibili durante l'esecuzione a meno che l'amico, il gioco o il gruppo non abbia il permesso di utilizzare quegli asset.
Per cambiare i permessi del pacchetto per un collaboratore, come un amico o un gruppo:
Nella finestra Explorer , Toolbox o Asset Manager, fai clic con il tasto destro sul pacchetto desiderato e seleziona Opzioni pacchetto ⟩ Dettagli pacchetto.
Nella finestra Configurazione asset, seleziona Permessi.
Utilizzando la barra di ricerca, inserisci e seleziona un collaboratore a cui desideri concedere il permesso di utilizzare il tuo pacchetto, quindi scegli un livello di permesso.
Permesso Descrizione Utilizza e Visualizza Il collaboratore può utilizzare e visualizzare (ma non modificare) le versioni attuali 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 reinserzione 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 attuali e precedenti del pacchetto, inclusa la pubblicazione delle modifiche.
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 specifiche configurazioni.
Ripristina modifiche non pubblicate
Per annullare un'intera serie di modifiche non pubblicate:
Nella finestra Explorer , individua le copie modificate tramite il punto sulle loro icone del pacchetto. Puoi anche selezionare copie modificate nel viewport 3D.
Fai clic con il tasto destro su una singola copia modificata e seleziona Annulla modifiche al pacchetto, oppure seleziona più copie (almeno una di esse modificata), fai clic con il tasto destro e seleziona Annulla modifiche ai pacchetti selezionati.
Ripristina a versione pubblicata
Per ripristinare un pacchetto a una versione pubblicata in precedenza:
- Nella finestra Explorer , Toolbox o Asset Manager, fai clic con il tasto destro sul pacchetto desiderato e seleziona Opzioni pacchetto ⟩ Dettagli pacchetto.
- 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 eventuali descrizioni delle modifiche.
- Fai clic sulla spunta accanto alla versione che desideri ripristinare e fai clic su Invia.
Ripristinare le modifiche a un pacchetto non ripristina la configurazione al valore predefinito. Vedi ripristina configurazioni.
Ripristina configurazioni
Per ripristinare qualsiasi attributo di configurazione al suo valore predefinito, seleziona Ripristina dal menu delle 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 di differenze. 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 i 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 i 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 riga per riga degli script. È disponibile per i pacchetti contenenti script, indipendentemente dal fatto che lo script sia l'oggetto radice o meno.
Per confrontare le versioni del pacchetto:
Nella finestra Explorer o nel viewport 3D, fai clic con il tasto destro sul pacchetto target e seleziona Opzioni pacchetto ⟩ Confronta versioni del pacchetto.
Per impostazione predefinita, 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 differenze del pacchetto.
Dopo aver selezionato le versioni:
Per confrontare i rendering visivi del modello radice, se applicabile, seleziona la scheda Panoramica visiva e regola il controllo della telecamera per l'angolo desiderato. I controlli sono sincronizzati tra le viste:
- Panoramica della telecamera utilizzando i clic del mouse sinistro.
- Ruota la telecamera utilizzando i clic del mouse destro.
- Zoom avanti e indietro con la rotellina del mouse.
- Ricentra utilizzando la scorciatoia da tastiera F.
Per confrontare le proprietà e gli attributi di un'istanza, seleziona l'istanza e la scheda Proprietà.
Per confrontare le differenze degli script per un pacchetto che è uno script o contiene script, utilizza la scheda Script.
Questo strumento consente solo di confrontare le modifiche degli 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 differenze degli script facendo clic con il tasto destro sul pacchetto target nella finestra Explorer o nel viewport 3D e selezionando Visualizza modifiche agli script.
