Paket

*Konten ini diterjemahkan menggunakan AI (Beta) dan mungkin mengandung kesalahan. Untuk melihat halaman ini dalam bahasa Inggris, klik di sini.


Untuk menyimpan aset secara terorganisir dan dapat digunakan kembali di seluruh tim Anda atau di beberapa proyek, kumpulkan instans Anda dan konversi mereka menjadi paket yang dapat dikonversi. Paket membuat proses pembangunan dunia lebih cepat dan lebih ergonomis, tetapi mereka juga membantu dengan konsistensi, duplikasi, kolaborasi, dan versi:

  • Dengan mudah update all copies dari sebuah paket ke versi terbaru (atau hanya update specific copies).
  • Tetapkan paket ke otomatis update setiap kali ada versi baru.
  • Berikan otoritas Edit atau Gunakan kepada konten paket.
  • Lihat versi penuh sejarah untuk sebuah paket, bandingkan versi, dan restore versi lama.

Proses kerja yang paling efisien adalah membuat paket , berbagi dengan kolaborator , dan tetapkan untuk menyetel ulang secara otomatis. Dan Anda tidak harus menunggu model untuk selesai sebelum menggunakannya dalam paket. Bahkan jika paket adalah peng

Membuat Paket

Anda dapat menciptakan paket dari setiap objek tunggal atau cabang objek tunggal dan anak-anak. Jika Anda ingin menciptakan paket untuk objek tunggal, kami merekomendasikan menambahkannya ke grup Model pertama sehingga Anda dapat tambah, menghapus, atau menyesuaikan instans di dalam paket nanti tanpa menghancurkan paket.

  1. Di jendela Explorer atau 3D viewport, klik kanan objek yang diinginkan dan pilih Konversi ke Paket .

    The context menu that display when you right-click an object in the Explorer window. The Convert to Package menu item is highlighted.
  2. Di jendela baru, isi rincian paket. Khususnya, jika Anda bekerja di grup, set Milik Pemilik ke grup yang sesuai di mana Anda memiliki izin untuk membuat/mengedit pengalaman grup.

  3. Klik Kirimkan .

  4. Setelah konversi selesai, objek menerima simbol "chain tautkan" di jendela Explorer untuk mengidentifikasi dirinya sebagai paket. Selain itu, Anda dapat melihat objek baru PackageLink yang bermasalah dengan objek.

    A maple tree model in the Explorer window with the package icon next to it.
  5. (Opsional) Pilih objek PackageLink dan aktifkan AutoUpdate di jendela Properties . Perhatikan bagaimana ikon berubah untuk menunjukkan bahwa paket diatur untuk updatesecara otomatis.

    A maple tree model in the Explorer window with the auto-update package icon next to it.

MengInsert Paket

Untuk menyisipkan paket yang belum ada di tempat saat ini, Anda harus pertama-tama menyimpannya dari Toolbox :

  • Dari InventarisPaket Saya untuk paket yang AndaPublish ke atau dapatkan dari Toko Pencipta , serta paket yang dimiliki dan telah diberi izin oleh teman Anda.
  • Dari KaryaPaket Grup untuk paket yang diterbitkan oleh anggota kelompok Anda (termasuk diri Anda sendiri).
A close up view of the Toolbox with both the Inventory tab and the assets dropdown menu highlighted.
Kotak Alat → Inventaris → Paket Saya
A close up view of the Toolbox with the Creations tab highlighted.
Kotak Alat → Karya → Paket Grup

Setelah Anda menempatkan paket ke dalam model data tempat, itu muncul di Folder Packages dari Manajer Aset dan tetap ada bahkan jika Anda kemudian menghapus semua salinan dari itu. Namun, ketika Anda menerbitkan tempat, folder itu akan diperbarui untuk mencerminkan hanya paket yang digunakan di dalam tempat.

The Asset Manager window with a few example packages.
Paket dalam Manajer Aset

Menerbitkan Perubahan Paket

Anda dapat menerbitkan perubahan apa pun yang Anda buat ke paket sebagai versi baru untuk membuatnya tersedia untuk kopian lain dari paket di seluruh tempat dan melalui semua pengalaman. Catat bahwa bukan diperlukan untuk menerbitkan paket yang dimodifikasi sebelum menerbitkan tempat (versi dimodifikasi disimpan bersama dengan tempat untuk versi masa depan).

Untuk menerbitkan perubahan ke paket:

  1. Di jendela Explorer atau 3D viewport, klik kanan pada copy yang dimodifikasi dan pilih Publish to Package .

    The context menu that display when you right-click an object in the Explorer window. The Publish to Package menu item is highlighted.
  2. Jika kopian paket memiliki oto-update yang aktif, itu segera menarik versi yang diperbarui saat Anda membuka tempat yang mengandung mereka. Kopian lain mendapatkan titik putih di ikon paket yang menunjukkan bahwa pembaruan tersedia. Anda dapat Update individual atau Pembaruan massal mereka sesuai kebutuhan.

    Two packages in the Explorer set to auto-update, and one with an update available.
  3. (Opsional) Tambahkan deskripsi perubahan Anda:

    1. Klik kanan paket dan pilih Detail Paket .
    2. Di jendela Konfigurasi Aset, pilih Versi .
    3. Di bawah perubahan terbaru Anda, pilih Tambahkan .
    4. Deskripsikan perubahan Anda dan klik Kirimkan .

Mengembalikan Kopian Tua

Anda dapat menyetujui salinan paket tertinggal ke versi terbaru, atau Anda dapat terus menggunakan versi yang lebih tua.

Untuk menyetujui satu atau lebih salinan paket ke versi terbaru:

  1. Di jendela Explorer, cari salinan lama dengan titik putih di ikon paket. Anda juga dapat memilih salinan lama di 3D viewport, tetapi mungkin lebih sulit untuk menemukan cara ini.

    Two packages in the Explorer set to auto-update, and one with an update available.
  2. Klik kanan pada salinan yang diperbarui dan pilih Dapatkan Paket Terbaru . Anda juga dapat mengumpulkan beberapa paket, kanan klik, dan Dapatkan Paket Terbaru Untuk Packages Selektif .

Pemutakhiran Masal

Penggunaan ekstensif paket dapat menyebabkan banyak salinan paket di banyak lokasi dalam pengalaman. Selain sinkronisasi individuаль dan perbaruan otomatis, Anda dapat menyimpan semua salinan paket melalui pembaruan massal.

  1. (Direkomendasikan) Tutup instansi Studio lain dengan salah satu tempat pengalaman terbuka; ini mencegah instansi lain yang belum disimpan dari tempat menulis update Anda.

  2. Di jendela Explorer atau 3D viewport, klik kanan paket yang diinginkan dan pilih Update All .

  3. Pilih semua tempat dalam pengalaman atau beberapa subset tempat dan klik Perbarui .

    A view of the mass update window, showing two places.

    Untuk mencegah overwrite yang tidak sengaja, pembaruan massal tidak meng影響 versi dimodifikasi dari sebuah paket. Setelah pembaruan massal selesai, Studio menampilkan peringatan dengan jumlah paket yang itu tidak update , jika ada.

Pemutakhiran Otomatis

Untuk membuat sinkronisasi lebih mudah, Anda dapat mengatur salinan paket untuk diperbarui secara otomatis setiap kali versi baru diterbitkan. Pembaruan otomatis salinan paket akan terjadi saat lokasi dibuka di Studio.

  1. Di jendela Explorer, ekspansi pohon hierarki paket dan pilih objek PackageLink paket.

    A close up view of a packaged chandelier model in the Explorer window. The PackageLink object is highlighted.
  2. Di jendela Properti, aktifkan property Pembaruan Otomatis . Jika Anda memiliki paket terikat, property ini hanya berlaku untuk paket tertinggi, yang berarti pembaruan otomatis hanya terjadi ketika paket 1>orang tua1> diperbarui.

Tingkat Berbagi dan Akses

Jika diinginkan, Anda dapat berbagi paket dengan teman atau memberikan akses ke peran pengguna tertentu di grup Anda.

  1. Di Explorer, Toolbox, atau Asset Manager, klik paket yang diinginkan dan pilih Detail Paket .

  2. Di jendela Konfigurasi Aset, pilih Ijin .

    • Untuk paket group-owned , ekspansi pohon peran. Kemudian pilih tingkat izin untuk setiap peran. Kotak pilihan yang dinonaktifkan menunjukkan bahwa izin sudah dikonfigurasi untuk peran itu dan tidak dapat diubah dari jendela ini.

      A close up view of some settings in the pop-up window. The arrow icon next to the group icon and the member Edit dropdown menu are highlighted.
      IzinkanDeskripsi
      Editasi. Anggota peran dapat menggunakan, melihat, dan mengedit versi paket saat ini dan sebelumnya, termasuk menerbitkan perubahan kepada itu. Memberikan akses edit ke peran dari jendela ini hanya memberikan akses ke paket khusus .
      Tidak Akses Anggota peran tidak memiliki akses ke versi baru mana pun dari paket, meskipun mereka menyimpan akses ke versi saat ini yang ditambahkan ke tempat.
    • Untuk paket milik pengguna , cari teman melalui field pencarian, klik nama pengguna mereka, dan pilih levelizin.

      IzinkanDeskripsi
      Gunakan & Lihat Pengguna dapat menggunakan dan menampilkan (tetapi tidak dapat mengedit) versi paket saat ini dan sebelumnya. Setelah Anda memberikan kemampuan ini kepada pengguna, Anda tidak dapat menarik kembali akses ke salinan yang telah mereka masukkan ke dalam pengalaman mereka; menarik kembali akses menghalangi pengembalian atau pembaruan paket, tetapi kopian paket di model data mereka tetap utuh.
      Editasi. Pengguna dapat menggunakan, menampilkan, dan mengedit versi paket saat ini dan sebelumnya, termasuk menerbitkan perubahan kepada itu.

Mengubah Paket

Anda dapat mengedit paket dan anak-anak mereka sama seperti objek lainnya. Mengubah paket menonaktifkan pembaruan otomatis sampai Anda publikasi atau mundur perubahan.

The pop-up notice that you cannot update a modified package until you publish or revert your changes.

Sebagian besar perubahan mengidentifikasi paket sebagai dimodifikasi, meskipun perubahan berikut tidak dianggap perubahan paket:

  • Mengubah nama root node. * Mengubah posisi atau rotasi dari akar node paket yang merupakan Class.BasePart , 1> Class.Model1> , atau 4> Class.GuiObject4> .
  • Mengubah Diaktifkan property dari akhir Class.GuiObject seperti a 1>Class.ScreenGui1> , 4>Class.SurfaceGui4> , atau 7>Class.BillboardGui7> .
  • Mengubah referensi bagian dari Weld di dalam paket yang mengacu pada instans di luar paket.

Setelah diubah, paket dengan perubahan yang belum diterbitkan mendapatkan ikon yang dimodifikasi di jendela Explorer :

The Explorer window with an icon that identifies unpublished package changes.

Menambahkan atau Diperbarui Konfigurasi

Anda dapat meng包括 属性 instans di akhir paket untuk menyesuaikan perilaku, misalnya waktu maksimum sebuah kendaraan berkemas atau waktu pengembalian untuk tombol berkemas.

Ketika Anda menerbitkan paket, set saat ini dari属性/值 menjadi konfigurasi default paket . Di set setiap kopian paket, konfigurasi ditunjukkan dalam huruf italik tajam dan nilai属性 dapat diubah di basis per-instansi. Saat kopian paket diperbarui, nilai konfigurasi yang dimodifikasi akan tetap, sementara属

The Attributes section of the Properties window. Two properties are highlighted as having their default values while two other italicized properties are highlighted to show they have been configured.

Paket yang Dipasang

Anda dapat menyimpan dan berkolaborasi paket dalam paket lain untuk menjaga dan berkolaborasi pada piramida kompleks, seperti serangkaian mekanik kendaraan yang dapat diubah secara independen dari paket utama kendaraan:

An expanded hierarchy in the Explorer window showing how packages can contain packages.

Skrip Paket

Setiap skrip dalam paket yang tidak dimodifikasi ditunjukkan sebagai pembacaan saja dan menunjukkan notifikasi di atas dengan hiper-link untuk membuka skrip.

A script tab with a yellow notification that you can click to modifiy the script that's within an unmodified package.

Mengklik hiperlink:

  • Merekam paket sebagai dimodifikasi terlepas dari apakah Anda mengedit script.
  • Menghapus notifikasi/hyperlink dari script lainnya di dalam paket.

Setelah paket diterbitkan dan diubah menjadi tidak dimodifikasi status, skrip di bawahnya menjadi baca-hanya dengan hiperlink untuk dimodifikasi.

Mengembalikan Perubahan Paket

Alih-alih mengembalikan seluruh serangkaian perubahan paket satu per satu, Anda dapat mengembalikan perubahan yang belum diterbitkan dalam satu action, mengembalikan paket ke versi sebelumnya versi, atau mengembalikan perubahan ke konfigurasi khusus atau .

Mengembalikan Perubahan Tidak Diterbitkan

Untuk membatalkan seluruh serangkaian tidak diterbitkan perubahan:

  1. Di jendela Explorer, temukan salinan yang dimodifikasi oleh tanda exclamation point di samping nama mereka. Anda juga dapat memilih salinan yang dimodifikasi di 3D viewport, yang mungkin lebih mudah.

  2. Klik kanan pada salinan yang dimodifikasi tunggal dan pilih Batalkan Perubahan untuk Paket , atau pilih beberapa salinan (setidaknya salah satu dari mereka dimodifikasi), klik kanan, dan pilih Batalkan Perubahan untuk Paket yang Dipilih .

Mengembalikan ke Versi

Untuk mengembalikan paket ke versi sebelumnya yang diterbitkan :

  1. Di jendela Explorer, 3D viewport, Toolbox, atau Asset Manager, klik kanan paket yang diinginkan dan pilih Detail Paket .

  2. Di jendela Konfigurasi Aset, pilih Versi . Jendela menunjukkan rincian untuk setiap versi yang diterbitkan, termasuk tanggal dan waktu penerbitan, serta deskripsi dari perubahan.

  3. Klik tanda centang di samping versi yang ingin Anda restore dan klik Submit .

    The pop-up window for a chandelier asset. It displays multiple versions.

Mengembalikan Konfigurasi

Untuk mengembalikan setiap 属性 konfigurasi ke default, pilih opsi Reset dari menu peralatan di bagian Atribut dari jendela 1>Properti1>.

The Attributes section of the Properties window. The gear menu is expanded and the Reset menu item is highlighted.

Membandingkan Versi Paket

Ketika sebuah paket memiliki beberapa versi, Anda dapat membandingkan perubahan antara versi menggunakan pandangan diff, yang berguna untuk meninjau pembaruan paket, membandingkan perubahan lokal Anda terhadap versi terbaru, dan memeriksa konten dari versi sebelumnya sebelum di restore.

Alat ini memiliki menu hierarki paket yang menunjukkan semua instans yang ditambahkan, dihapus, atau dimodifikasi di antara versi menggunakan ikon yang sesuai, dengan tab berikut tersedia:

  • Pandangan Umum Visual menunjukkan perbedaan pandangan 3D render di bawah berbagai posisi kamera. Ini adalah pandangan default untuk paket dengan objek 3D (model, bagian) sebagai objek akhir, dan saat ini hanya tersedia untuk objek akhir.

    An example of the Visual Overview tab in the diff viewer. One version of a building displays on the left-hand side, and another on the right-hand side.
  • Properti menunjukkan perubahan properti dan属性. Ini adalah pandangan default untuk paket dengan objek non-3D (skrip, lampu, objek 2D) sebagai objek akar, dan itu tersedia untuk semua instans di paket.

    An example of the Properties tab in the diff viewer. Modified properties in different versions are highlighted.
  • Skrip menunjukkan perbedaan skrip satu baris. Ini tersedia untuk paket yang berisi skrip, terlepas dari apakah skrip adalah objek akar atau tidak.

    An example of the Script tab in the diff viewer. Modified script lines in different versions are highlighted.

Untuk membandingkan versi paket:

  1. Di jendela Explorer atau 3D viewport, klik kanan paket target dan pilih Bandingkan Versi Paket .

  2. Secara default, jendela membandingkan perubahan antara salinan lokal Anda dan versi terbaru. Gunakan dua menu dropdown untuk membandingkan versi yang berbeda.

    A close up view of an example diff viewer. The compare settings are highlighted.
  3. Setelah memilih versi:

    • Untuk membandingkan renderan visual dari model akar, jika berlaku, pilih tab Pandangan Umum dan sesuaikan kontrol kamera untuk sudut yang diinginkan. Kontrol di sinkronisasi di antara pandangan:

      • Pan kamera menggunakan klik mouse kiri.
      • Putar kamera menggunakan klik kanan mouse.
      • Perbesar dan kurangi kamera dengan roda mouse.
      • Recenter menggunakan pintas keyboard -F.
    • Untuk mengevaluasi proporsi dan属性 sebuah kejadian, pilih instansi dan tab Properti .

    • Untuk membandingkan perbedaan skrip, jika berlaku, pilih salah satu script untuk membuka tab Skrip untuk perubahan garis-garis antara versi yang Anda pilih, mirip dengan aplikasi kontrol sumber.

Alternatifnya, Anda dapat membuka alat script dif langsung:

  1. Di jendela Explorer atau 3D viewport, klik kanan paket target, yang harus menjadi skrip atau berisi skrip, dan pilih Lihat Perubahan Skrip .
  2. Di tab perbedaan yang terbuka, bandingkan semua perubahan script yang dipilih antara kopian paket saat ini dan versi terbaru yang diterbitkan atau lokal.