Untuk menjaga aset tetap terorganisir dan dapat digunakan kembali di seluruh tim Anda atau di berbagai proyek, Anda dapat mengelompokkan instance Anda dan mengubahnya menjadi paket yang dapat digunakan kembali. Paket membuat keseluruhan proses pembangunan dunia lebih cepat dan lebih ergonomis, tetapi juga membantu dengan konsistensi, penghapusan duplikasi, kolaborasi, dan versi:
- Dengan mudah perbarui semua salinan paket ke versi terbaru, atau hanya perbarui salinan tertentu.
- Atur paket untuk memperbarui secara otomatis setiap kali ada versi baru.
- Berikan kolaborator izin Edit atau Gunakan untuk konten paket.
- Lihat riwayat versi lengkap untuk paket, bandingkan versi, dan pulihkan versi lama.
Alur kerja yang paling efisien adalah membuat paket, membagikannya dengan kolaborator mana pun, dan mengatur untuk memperbarui otomatis. Dan Anda tidak perlu menunggu model untuk "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.
Buat paket
Jika Anda ingin membuat paket dengan aset terbatas yang tidak Anda miliki izin eksplisit untuk digunakan, Anda masih dapat membuat paket tetapi aset terbatas tertentu tersebut tidak akan terlihat atau terdengar saat runtime kecuali permainan itu sendiri memiliki izin untuk menggunakan aset tersebut.
Anda dapat membuat paket dari objek tunggal mana pun atau cabang objek orang tua dan anak tunggal. Jika Anda ingin membuat paket untuk objek tunggal, tambahkan ke pengelompokan Model terlebih dahulu sehingga Anda dapat menambahkan, menghapus, atau mengubah ukuran objek anak dalam paket nanti tanpa merusak paket.
Untuk membuat paket:
Di jendela Explorer atau viewport 3D, klik kanan objek yang ingin Anda ubah menjadi paket dan, di menu konteks, pilih Ubah menjadi Paket.
Di jendela baru, isi detail paket. Khususnya, jika Anda bekerja dalam grup, atur Kepemilikan ke grup yang sesuai di mana Anda memiliki izin untuk membuat/mengedit permainan grup.
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" 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! Melakukannya untuk salinan paket mana pun mengubah salinan kembali menjadi objek normal dan kehilangan kemampuan paket, seperti kemampuan untuk memperbarui dirinya sendiri saat ada versi baru.
Masukkan paket
Untuk memasukkan paket yang belum ada di tempat saat ini, Anda harus awal memasukkannya dari Toolbox:
- Dari Inventaris ⟩ Paket Saya untuk paket yang telah Anda terbitkan atau diperoleh dari Toko Pembuat, serta paket yang dimiliki teman dan telah memberikan Anda izin untuk digunakan.
- Dari Kreasi ⟩ Paket Grup untuk paket yang diterbitkan oleh anggota grup Anda (termasuk diri Anda sendiri).
Setelah Anda memasukkan paket ke dalam model data tempat yang diterbitkan, paket tersebut muncul di Pengelola Aset dan tetap ada di sana bahkan jika Anda kemudian menghapus semua salinannya.
Hati-hati saat memasukkan aset yang tidak Anda buat ke dalam permainan Anda, karena mereka dapat mengandung skrip berbahaya. Simpan permainan Anda terlebih dahulu dan kemudian periksa skrip dalam aset yang tidak dikenal sehingga Anda dapat dengan mudah kembali ke versi tempat.
Modifikasi paket
Anda dapat mengedit paket dan anak-anaknya seperti objek lainnya. Memodifikasi paket menonaktifkan pembaruan otomatis hingga Anda menerbitkan atau mengembalikan perubahan.
Sebagian besar edit menandai paket sebagai dimodifikasi, meskipun perubahan berikut tidak dianggap sebagai modifikasi paket:
- Mengubah nama dari node akar.
- Mengubah properti Enabled dari node akar GuiObject seperti ScreenGui, SurfaceGui, atau BillboardGui.
- Mengubah referensi bagian dari Weld di dalam paket yang merujuk ke instance di luar paket.
Setelah dimodifikasi, paket dengan perubahan yang belum diterbitkan mendapatkan ikon dimodifikasi di jendela Explorer:
Tambahkan atau perbarui konfigurasi
Anda dapat menyertakan atribut instance di akar paket untuk menyesuaikan perilakunya. Ketika Anda menerbitkan paket, set atribut/nilai saat ini akan menjadi konfigurasi default paket. Pada setiap salinan paket tertentu, nilai atribut tersebut dapat diubah berdasarkan instance, dan perubahan tersebut dicatat melalui huruf miring tebal. Ketika salinan paket diperbarui diperbarui, nilai konfigurasi yang dimodifikasi akan dipertahankan, 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 ulang paket (paket tidak akan 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 apa pun, atau mengembalikan konfigurasi ke defaultnya sebelum Anda menerbitkan.
Paket bersarang
Anda dapat menyimpan paket di dalam paket lain untuk mempertahankan dan berkolaborasi pada hierarki kompleks, seperti serangkaian mekanik kendaraan yang dapat dimodifikasi secara independen dari paket induk kendaraan.
Jika Anda memodifikasi paket bersarang, baik paket bersarang dan paket induk dianggap sebagai dimodifikasi. Anda harus menerbitkan perubahan ke paket bersarang mana pun sebelum Anda diizinkan untuk menerbitkan perubahan ke paket induknya, karena menerbitkan paket induk akan menandainya sebagai saat ini/tidak dimodifikasi dan bertentangan dengan modifikasi paket bersarang.
Skrip paket
Setiap skrip dalam paket yang tidak dimodifikasi bersifat hanya-baca dan menunjukkan pemberitahuan di bagian atas dengan hyperlink untuk membuka kunci skrip.
Mengklik hyperlink:
- Menandai paket sebagai dimodifikasi terlepas dari apakah Anda mengedit skrip.
- Menghapus pemberitahuan/hyperlink dari skrip lain dalam paket.
Setelah paket diterbitkan dan dipindahkan ke keadaan tidak dimodifikasi, skrip di bawahnya menjadi hanya-baca dengan hyperlink untuk memodifikasi.
Terbitkan 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 permainan. Tidak diperlukan untuk menerbitkan paket yang dimodifikasi sebelum menerbitkan tempat karena versi yang dimodifikasi disimpan bersama dengan tempat untuk iterasi di masa depan.
Untuk menerbitkan perubahan ke paket:
Di jendela Explorer atau viewport 3D, klik kanan salinan yang dimodifikasi dan pilih Terbitkan ke Paket.
Jika salinan paket memiliki pembaruan otomatis diaktifkan, ia segera menarik versi yang diperbarui saat Anda membuka tempat yang mengandungnya. Salinan lain mendapatkan simbol "unduh" yang menunjukkan bahwa pembaruan tersedia. Anda dapat memperbarui secara individu atau memperbarui 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 Tambahkan.
- Deskripsikan perubahan Anda, lalu klik tombol Kirim.
Perbarui salinan yang sudah ketinggalan
Anda dapat memperbarui salinan paket yang sudah ketinggalan ke versi terbaru, atau Anda dapat terus menggunakan versi yang lebih lama.
Di jendela Explorer, temukan salinan yang sudah ketinggalan dengan simbol "unduh". Anda juga dapat memilih salinan yang sudah ketinggalan di viewport 3D.
Klik kanan salinan yang sudah ketinggalan 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 permainan. Selain sinkronisasi individu dan pembaruan otomatis, Anda dapat memperbarui semua salinan paket melalui pembaruan massal.
- DISARANKANTutup instance Studio lain dengan tempat permainan mana pun yang terbuka; ini mencegah instance tempat yang tidak disimpan lainnya dari kemungkinan menimpa pembaruan Anda.
- Di jendela Explorer atau viewport 3D, klik kanan paket yang diinginkan dan pilih Perbarui Semua.
- Pilih semua tempat dalam permainan atau beberapa subset 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 sinkronisasi, Anda dapat mengatur salinan paket untuk memperbarui secara otomatis setiap kali versi yang lebih baru diterbitkan. Pembaruan otomatis salinan paket akan terjadi 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 tingkat tertinggi, yang berarti pembaruan otomatis hanya terjadi saat paket induk diperbarui.
Pembaruan otomatis tidak berlaku untuk salinan paket yang dimodifikasi. Setelah Anda memodifikasi instance paket, properti AutoUpdate-nya menjadi dinonaktifkan dan diabaikan.
Bagikan dan tingkat akses
Anda dapat memberikan izin kepada teman, permainan, grup, atau peran pengguna grup 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 tetapi aset terbatas tertentu tersebut tidak akan terlihat atau terdengar saat runtime kecuali teman, permainan, atau grup memiliki izin untuk menggunakan aset tersebut.
Untuk mengubah izin paket untuk kolaborator, seperti teman atau grup:
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, lalu 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 sudah mereka masukkan ke dalam permainan 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.
Kembalikan perubahan paket
Alih-alih membatalkan seluruh rangkaian perubahan paket satu per satu, Anda dapat mengembalikan perubahan yang belum diterbitkan dalam satu tindakan, memulihkan paket ke versi sebelumnya, atau mengembalikan perubahan ke konfigurasi tertentu.
Kembalikan perubahan yang belum diterbitkan
Untuk membatalkan seluruh rangkaian 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.
Pulihkan ke versi yang diterbitkan
Untuk memulihkan paket ke versi yang diterbitkan sebelumnya:
- 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 apa pun.
- Klik tanda centang di sebelah versi yang ingin Anda pulihkan dan klik Kirim.
Mengembalikan perubahan ke paket tidak mengatur konfigurasi ke default. Lihat kembalikan konfigurasi.
Kembalikan konfigurasi
Untuk mengembalikan atribut konfigurasi ke defaultnya, pilih Reset dari menu opsi di bagian Atribut jendela Properties.
Bandingkan versi paket
Ketika sebuah paket memiliki beberapa versi, Anda dapat membandingkan perubahan antara versi menggunakan alat pembanding. Alat ini memiliki menu hierarki paket yang menunjukkan semua instance yang ditambahkan, dihapus, atau dimodifikasi antara versi menggunakan 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 akar, dan saat ini hanya tersedia untuk objek akar.
Properti menunjukkan perubahan properti dan atribut. Ini adalah tampilan default untuk paket dengan objek non-3D (skrip, lampu, objek 2D) sebagai objek akar, 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 akar atau tidak.
Untuk membandingkan versi paket:
Di jendela 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 dropdown untuk membandingkan versi yang berbeda.
Beberapa versi yang lebih lama mungkin tidak kompatibel dengan alat pembanding paket.
Setelah memilih versi:
Untuk membandingkan rendering visual dari model akar, jika berlaku, pilih tab Tampilan Visual dan sesuaikan kontrol kamera untuk sudut yang Anda inginkan. Kontrol disinkronkan di seluruh tampilan:
- Pindahkan kamera menggunakan klik kiri mouse.
- Putar kamera menggunakan klik kanan mouse.
- Zoom in dan out kamera dengan roda mouse.
- Pusatkan kembali menggunakan pintasan keyboard F.
Untuk membandingkan properti dan atribut dari sebuah instance, pilih instance tersebut dan tab Properti.
Untuk membandingkan perbedaan skrip untuk paket yang merupakan skrip atau berisi skrip, gunakan tab Skrip.
Alat ini hanya memungkinkan Anda untuk membandingkan perubahan skrip antara versi saat ini dan versi yang diterbitkan atau lokal terbaru, tanpa menunjukkan kolaborator yang melakukan perubahan.
Sebagai alternatif, Anda dapat membuka alat perbandingan skrip secara langsung dengan mengklik kanan paket target di jendela Explorer atau viewport 3D dan memilih Lihat Perubahan Skrip.
