Untuk menjaga aset terorganisir dan dapat digunakan kembali di seluruh tim Anda atau di berbagai proyek, Anda dapat mengelompokkan instansi Anda dan mengonversinya menjadi paket yang dapat digunakan kembali. Paket membuat proses membangun dunia secara keseluruhan lebih cepat dan ergonomis, tetapi juga membantu dengan konsistensi, pengurangan duplikasi, kolaborasi, dan pengelolaan versi:
- Dengan mudah memperbarui semua salinan suatu paket ke versi terbaru, atau hanya memperbarui salinan tertentu.
- Menetapkan paket untuk memperbarui secara otomatis setiap kali ada versi baru.
- Memberikan kolaborator izin Edit atau Gunakan untuk konten suatu paket.
- Melihat riwayat versi lengkap untuk suatu paket, membandingkan versi, dan memulihkan versi lama.
Alur kerja yang paling efisien adalah membuat paket, membagikannya dengan kolaborator mana pun, dan menetapkannya untuk pembaruan otomatis. Dan Anda tidak perlu menunggu model "selesai" sebelum menggunakannya dalam paket. Bahkan jika paket adalah placeholder di atas bentuk sederhana, Anda dapat menggunakannya untuk greybox lingkungan Anda dan kemudian memiliki salinan placeholder yang diperbarui secara otomatis saat Anda menerbitkan versi yang lebih detail.
Membuat paket
Jika Anda ingin membuat paket dengan aset terbatas yang tidak Anda miliki izin eksplisit untuk digunakan, Anda masih dapat membuat paket tersebut tetapi aset terbatas spesifik tersebut tidak akan terlihat atau terdengar saat runtime kecuali game itu sendiri memiliki izin untuk menggunakan aset tersebut.
Anda dapat membuat paket dari objek tunggal mana pun atau cabang orang tua dan anak objek tunggal mana pun. Jika Anda ingin membuat paket untuk objek tunggal, tambahkan ke pengelompokan Model terlebih dahulu agar Anda dapat menambahkan, menghapus, atau mengubah ukuran objek anak dalam paket tanpa merusak paket.
Untuk membuat paket:
Di jendela Explorer atau viewport 3D, klik kanan objek yang ingin Anda ubah menjadi paket dan, di menu kontekstual, pilih Konversi ke Paket.
Di jendela baru, isi detail paket. Khususnya, jika Anda bekerja dalam sebuah kelompok, atur Kepemilikan ke kelompok yang sesuai di mana Anda memiliki izin untuk membuat/mengedit game kelompok.
Transfer kepemilikan tidak didukung oleh sistem aset, jadi pertimbangkan dengan hati-hati pemilik saat membuat paket.
Klik Kirim.
Setelah konversi selesai, objek menerima simbol "rantai link" di jendela Explorer untuk mengidentifikasinya sebagai paket. Selain itu, Anda dapat melihat objek baru PackageLink yang diparent ke objek tersebut.
- OPSIONALPilih objek PackageLink dan aktifkan AutoUpdate di jendela Properties. Perhatikan bagaimana ikon berubah untuk menunjukkan bahwa paket diatur untuk memperbarui secara otomatis.
Jangan hapus atau pindahkan objek PackageLink! Melakukan itu untuk salinan paket mana pun mengubah salinan tersebut kembali menjadi objek normal dan kehilangan kemampuan paket, seperti kemampuan untuk memperbarui dirinya sendiri ketika ada versi baru.
Menyisipkan paket
Untuk menyisipkan paket yang belum ada di tempat saat ini, Anda harus awal-awal menyisipkannya dari Toolbox:
- Dari Inventaris ⟩ Paket Saya untuk paket yang telah Anda terbitkan atau diperoleh dari Creator Store, serta paket yang dimiliki teman dan telah memberi Anda izin untuk digunakan.
- Dari Kreasi ⟩ Paket Grup untuk paket yang diterbitkan oleh anggota kelompok Anda (termasuk diri Anda sendiri).
Setelah Anda menyisipkan paket ke dalam model data tempat yang diterbitkan, ia akan muncul di Pengelola Aset dan tetap ada di sana bahkan jika Anda menghapus semua salinannya nanti.
Hati-hati saat menyisipkan aset yang tidak Anda buat ke dalam game Anda, karena dapat mengandung skrip jahat. Simpan game Anda terlebih dahulu dan kemudian selidiki skrip yang ada dalam aset yang tidak dikenal sehingga Anda dapat dengan mudah kembali ke versi tempat.
Memodifikasi paket
Anda dapat mengedit paket dan anak-anaknya seperti objek lainnya. Memodifikasi paket menonaktifkan pembaruan otomatis hingga Anda menerbitkan atau mengembalikan perubahan.
Kebanyakan pengeditan menandai paket sebagai dimodifikasi, meskipun perubahan berikut tidak dianggap sebagai modifikasi paket:
- Mengubah nama simpul root.
- Mengubah properti Enabled dari simpul root GuiObject seperti ScreenGui, SurfaceGui, atau BillboardGui.
- Mengubah referensi bagian dari Weld di dalam paket yang merujuk ke instansi di luar paket.
Setelah dimodifikasi, paket dengan perubahan yang belum diterbitkan mendapatkan ikon dimodifikasi di jendela Explorer:
Menambahkan atau memperbarui konfigurasi
Anda dapat menyertakan atribut instansi di root paket untuk menyesuaikan perilakunya. Ketika Anda menerbitkan suatu paket, set saat ini dari atribut/nilai akan menjadi konfigurasi default paket tersebut. Pada setiap salinan paket, nilai atribut tersebut dapat diubah berdasarkan instansi, dan perubahan tersebut dicatat melalui teks miring tebal. Ketika salinan paket diperbarui pembaruan, nilai konfigurasi yang dimodifikasi akan dilestarikan, sementara atribut lainnya akan diperbarui ke nilai default terbaru.
Saat ini satu-satunya cara untuk menangani nilai konfigurasi adalah dengan menambahkan skrip dalam paket yang membaca dan menerapkan perilaku berdasarkan konfigurasi saat runtime.
Jika Anda hanya ingin memperbarui nilai default untuk konfigurasi, Anda dapat mengubah nilai atribut tersebut dan menerbitkan kembali paket (paket akan tidak ditandai sebagai dimodifikasi dalam hal ini). Jika Anda ingin menerbitkan modifikasi lain tetapi tidak mengubah nilai konfigurasi default, Anda harus menerbitkan pada paket tanpa perubahan nilai apapun, atau mengembalikan konfigurasi ke defaultnya sebelum Anda menerbitkan.
Paket bersarang
Anda dapat menempatkan paket di dalam paket lain untuk mempertahankan dan berkolaborasi pada hierarki kompleks, seperti serangkaian mekanika kendaraan yang dapat dimodifikasi secara independen dari paket induk kendaraan tersebut.
Jika Anda memodifikasi paket bersarang, paket yang bersarang dan paket induk dianggap sebagai dimodifikasi. Anda harus menerbitkan perubahan ke paket bersarang mana pun sebelum Anda diizinkan untuk menerbitkan perubahan ke paket induk-nya, karena menerbitkan paket induk akan menandainya sebagai saat ini/tidak dimodifikasi dan bertentangan dengan modifikasi paket yang bersarang.
Skrip paket
Setiap skrip dalam paket yang tidak dimodifikasi bersifat hanya-baca dan menunjukkan pemberitahuan di bagian atas dengan tautan untuk membuka kunci skrip.
Mengklik tautan tersebut:
- Menandai paket sebagai dimodifikasi terlepas dari apakah Anda mengedit skrip atau tidak.
- Menghapus pemberitahuan/tautan dari skrip lain dalam paket.
Setelah paket diterbitkan dan dipindahkan ke keadaan tidak dimodifikasi, skrip di bawahnya menjadi hanya-baca dengan tautan untuk mengubah.
Menerbitkan perubahan paket
Anda dapat menerbitkan perubahan apa pun ke paket sebagai versi baru, membuat pembaruan Anda tersedia untuk salinan paket lain di seluruh tempat dan di semua game. Tidak diperlukan untuk menerbitkan paket yang dimodifikasi sebelum menerbitkan tempat karena versi dimodifikasi disimpan bersama tempat untuk iterasi selanjutnya.
Untuk menerbitkan perubahan ke paket:
Di jendela Explorer atau viewport 3D, klik kanan salinan yang dimodifikasi dan pilih Menerbitkan ke Paket.
Jika salinan paket memiliki pembaruan otomatis diaktifkan, ia segera menarik versi yang diperbarui saat Anda membuka tempat yang mengandungnya. Salinan lainnya mendapatkan simbol "unduh" yang menunjukkan bahwa pembaruan tersedia. Anda dapat memperbarui secara individu atau memperbarui secara massal semua salinan.
- OPSIONALTambahkan deskripsi perubahan Anda:
- Klik kanan paket dan pilih Detail Paket.
- Di jendela Konfigurasi Aset, pilih Versi.
- Di bawah perubahan terbaru Anda, pilih Tambah.
- Deskripsikan perubahan Anda, kemudian klik tombol Kirim.
Memperbarui salinan yang sudah kadaluarsa
Anda dapat memperbarui salinan paket yang sudah kadaluarsa ke versi terbaru, atau Anda dapat terus menggunakan versi yang lebih lama.
Di jendela Explorer , temukan salinan yang kadaluarsa dengan simbol "unduh". Anda juga dapat memilih salinan kadaluarsa itu di viewport 3D.
Klik kanan salinan kadaluarsa dan pilih Dapatkan Paket Terbaru. Anda juga dapat memilih beberapa paket, klik kanan, dan Dapatkan Terbaru untuk Paket yang Dipilih.
Pembaruan massal
Penggunaan paket yang luas dapat menghasilkan banyak salinan paket di berbagai tempat dalam suatu game. Selain sinkronisasi individua dan pembaruan otomatis, Anda dapat memperbarui semua salinan paket melalui pembaruan massal.
- DISARANKANTutup instansi Studio lain dengan semua tempat game yang terbuka; ini mencegah instansi tempat yang belum disimpan lain dari berpotensi menimpa pembaruan Anda.
- Di jendela Explorer atau viewport 3D, klik kanan paket yang diinginkan dan pilih Perbarui Semua.
- Pilih semua tempat dalam game atau sebagian tempat dan klik Perbarui.
Pembaruan massal paket secara otomatis menyimpan tempat yang dipilih tetapi tidak menerbitkannya. Selain itu, untuk mencegah penimpaan yang tidak diinginkan, pembaruan massal tidak mempengaruhi versi paket yang dimodifikasi; setelah pembaruan massal selesai, Studio menampilkan peringatan dengan jumlah paket yang tidak diperbarui, jika ada.
Pembaruan otomatis
Untuk memudahkan penyelarasan, Anda dapat mengatur salinan paket untuk diperbarui secara otomatis setiap kali versi baru diterbitkan. Pembaruan otomatis salinan paket akan berlangsung saat tempat dibuka di Studio.
Di jendela Explorer , perluas pohon hierarki paket dan pilih objek PackageLink-nya.
Di jendela Properties, aktifkan properti AutoUpdate. Jika Anda memiliki paket bersarang, properti ini hanya berlaku untuk paket induk yang paling tinggi, artinya pembaruan otomatis hanya terjadi saat paket induk diperbarui.
Pembaruan otomatis tidak berlaku untuk salinan paket yang dimodifikasi. Setelah Anda memodifikasi instansi paket, properti AutoUpdate-nya menjadi dinonaktifkan dan diabaikan.
Tingkat izin dan akses
Anda dapat memberikan izin kepada teman, permainan, kelompok, atau peran pengguna kelompok tertentu sehingga mereka dapat dengan bebas menggunakan paket Anda dalam kreasi mereka. Untuk informasi lebih lanjut tentang akses aset, lihat Privasi Aset.
Jika Anda membagikan paket dengan aset terbatas yang tidak Anda miliki izin eksplisit untuk digunakan, Anda masih dapat membagikan paket tersebut tetapi aset terbatas spesifik tersebut tidak akan terlihat atau terdengar saat runtime kecuali teman, game, atau kelompok memiliki izin untuk menggunakan aset tersebut.
Untuk mengubah izin paket untuk kolaborator, seperti teman atau kelompok:
Di jendela Explorer, Toolbox, atau Pengelola Aset, klik kanan paket yang diinginkan dan pilih Opsi Paket ⟩ Detail Paket.
Di jendela Konfigurasi Aset, pilih Izin.
Menggunakan bilah pencarian, masukkan dan pilih kolaborator yang ingin Anda berikan izin untuk menggunakan paket Anda, kemudian pilih tingkat izin.
Izin Deskripsi Gunakan & Lihat Kolaborator dapat menggunakan dan melihat (tetapi tidak mengedit) versi paket saat ini dan sebelumnya. Setelah Anda memberikan kemampuan ini kepada kolaborator, Anda tidak dapat mencabut akses ke salinan yang telah mereka masukkan ke dalam game mereka; mencabut akses mencegah penyisipan ulang atau pembaruan paket, tetapi salinan paket dalam model data mereka tetap utuh. Edit Kolaborator dapat menggunakan, melihat, dan mengedit versi paket saat ini dan sebelumnya, termasuk menerbitkan perubahan padanya.
Mengembalikan perubahan paket
Alih-alih membatalkan seluruh serangkaian perubahan paket satu per satu, Anda dapat mengembalikan perubahan yang belum diterbitkan dalam satu tindakan, memulihkan paket ke sebelumnya versi, atau mengembalikan perubahan ke konfigurasi tertentu.
Mengembalikan perubahan yang belum diterbitkan
Untuk membatalkan seluruh serangkaian perubahan yang belum diterbitkan:
Di jendela Explorer, temukan salinan yang dimodifikasi dengan titik pada ikon paket mereka. Anda juga dapat memilih salinan yang dimodifikasi di viewport 3D.
Klik kanan satu salinan yang dimodifikasi dan pilih Batalkan Perubahan ke Paket, atau pilih beberapa salinan (setidaknya satu di antaranya dimodifikasi), klik kanan, dan pilih Batalkan Perubahan ke Paket yang Dipilih.
Memulihkan ke versi yang diterbitkan
Untuk memulihkan suatu paket ke versi yang pernah diterbitkan:
- Di jendela Explorer, Toolbox, atau Pengelola Aset, klik kanan paket yang diinginkan dan pilih Opsi Paket ⟩ Detail Paket.
- Di jendela Konfigurasi Aset, pilih Versi. Jendela menampilkan detail untuk setiap versi yang diterbitkan, termasuk tanggal dan waktu penerbitan, bersama dengan deskripsi perubahan apapun.
- Klik tanda centang di sebelah versi yang ingin Anda pulihkan dan klik Kirim.
Mengembalikan perubahan ke suatu paket tidak mengatur konfigurasi ke default. Lihat mengembalikan konfigurasi.
Mengembalikan konfigurasi
Untuk mengembalikan atribut konfigurasi ke defaultnya, pilih Reset dari menu opsi di bagian Atribut dari jendela Properties.
Membandingkan versi paket
Ketika suatu paket memiliki beberapa versi, Anda dapat membandingkan perubahan antara versi menggunakan penampil diff. Alat ini memiliki menu hierarki paket yang menunjukkan semua instance yang ditambahkan, dihapus, atau dimodifikasi antara versi dengan ikon yang sesuai, termasuk fitur berikut:
Tampilan Visual menunjukkan perbedaan visual dari rendering 3D di bawah posisi kamera yang berbeda. Ini adalah tampilan default untuk paket dengan objek 3D (model, bagian) sebagai objek root, dan saat ini hanya tersedia untuk objek root.
Properti menunjukkan perubahan pada properti dan atribut. Ini adalah tampilan default untuk paket dengan objek non-3D (skrip, lampu, objek 2D) sebagai objek root, dan tersedia untuk semua instance dalam paket.
Skrip menunjukkan perbedaan skrip baris demi baris. Ini tersedia untuk paket yang berisi skrip, terlepas dari apakah skrip tersebut adalah objek root atau tidak.
Untuk membandingkan versi paket:
Di Explorer atau viewport 3D, klik kanan paket target dan pilih Opsi Paket ⟩ Bandingkan Versi Paket.
Secara default, jendela membandingkan perubahan antara salinan lokal Anda dan versi terbaru. Gunakan dua menu drop-down untuk membandingkan versi yang berbeda.
Beberapa versi yang lebih lama mungkin tidak kompatibel dengan alat diff paket.
Setelah memilih versi:
Untuk membandingkan rendering visual model root, jika berlaku, pilih tab Tampilan Visual dan sesuaikan kontrol kamera untuk sudut yang Anda inginkan. Kontrol disinkronkan di seluruh tampilan:
- Gerakkan kamera menggunakan klik kiri mouse.
- Putar kamera menggunakan klik kanan mouse.
- Perbesar dan perkecil kamera dengan roda mouse.
- Pusatkan kembali menggunakan pintasan keyboard F.
Untuk membandingkan properti dan atribut dari suatu instansi, pilih instansi dan tab Properti.
Untuk membandingkan perbedaan skrip untuk paket yang merupakan skrip atau berisi skrip, gunakan tab Skrip.
Alat ini hanya memungkinkan Anda membandingkan perubahan skrip antara versi saat ini dan versi terbaru yang diterbitkan atau lokal, tanpa menunjukkan kolaborator yang melakukan perubahan.
Sebagai alternatif, Anda dapat membuka alat diff skrip secara langsung dengan mengklik kanan paket target di jendela Explorer atau viewport 3D dan memilih Lihat Perubahan Skrip.
