Gói

Để giữ cho các tài sản được tổ chức và tái sử dụng trong nhóm của bạn hoặc trong nhiều dự án, bạn có thể nhóm các đối tượng của mình và chuyển đổi chúng thành gói có thể tái sử dụng. Các gói giúp quá trình xây dựng thế giới nhanh hơn và tiện lợi hơn, đồng thời cũng hỗ trợ tính nhất quán, giảm thiểu trùng lặp, hợp tác và quản lý phiên bản:

• Dễ dàng cập nhật tất cả các bản sao của một gói lên phiên bản mới nhất, hoặc chỉ cập nhật các bản sao cụ thể.
• Đặt gói để tự động cập nhật bất cứ khi nào có phiên bản mới.
• Cấp quyền Chỉnh sửa hoặc Sử dụng cho những tài sản trong một gói cho những người hợp tác.
• Xem lịch sử phiên bản đầy đủ của một gói, so sánh các phiên bản và khôi phục các phiên bản cũ.

Quy trình làm việc hiệu quả nhất là tạo một gói, chia sẻ nó với những người hợp tác, và đặt nó thành tự động cập nhật. Và bạn không cần phải chờ đợi một mô hình "hoàn thành" trước khi sử dụng nó trong một gói. Ngay cả khi gói chỉ là một ký hiệu trên một hình dạng đơn giản, bạn vẫn có thể sử dụng nó để chuẩn bị môi trường và sau đó các bản sao ký hiệu sẽ tự động cập nhật khi bạn công bố các phiên bản chi tiết hơn.

Tạo gói

Bạn có thể tạo gói từ bất kỳ đối tượng đơn lẻ nào hoặc bất kỳ nhánh cha và con nào của các đối tượng. Nếu bạn muốn tạo gói cho một đối tượng đơn lẻ, hãy thêm nó vào nhóm Model trước để bạn có thể thêm, xóa hoặc điều chỉnh quy mô các đối tượng con bên trong gói sau mà không làm hỏng gói.

Để tạo một gói:

1. Trong cửa sổ Explorer hoặc cửa sổ 3D, nhấp chuột phải vào đối tượng mà bạn muốn chuyển đổi thành gói và trong trình đơn ngữ cảnh, chọn Chuyển đổi thành Gói.

2. Trong cửa sổ mới, điền thông tin chi tiết của gói. Đặc biệt, nếu bạn đang làm việc trong một nhóm, hãy đặt Quyền sở hữu vào nhóm thích hợp mà bạn có quyền tạo/chỉnh sửa trò chơi nhóm.

   Việc chuyển nhượng quyền sở hữu không được hỗ trợ bởi hệ thống tài sản, vì vậy hãy cân nhắc cẩn thận về người sở hữu khi tạo một gói.

3. Nhấp vào Gửi.

4. Sau khi chuyển đổi hoàn tất, đối tượng nhận được biểu tượng "chuỗi liên kết" trong cửa sổ Explorer để xác định nó là một gói. Thêm vào đó, bạn có thể thấy một đối tượng mới PackageLink được làm cha cho đối tượng đó.

   

5. TÙY CHỌN

   Chọn đối tượng PackageLink và bật Tự động cập nhật trong cửa sổ Thuộc tính. Lưu ý cách biểu tượng thay đổi để xác định rằng gói đã được đặt để tự động cập nhật.

Chèn gói

Để chèn một gói chưa tồn tại trong nơi hiện tại, bạn phải ban đầu chèn nó từ Toolbox:

• Từ Kho ⟩ Gói của tôi cho các gói mà bạn đã xuất bản hoặc nhận từ Cửa hàng Tạo, cũng như các gói mà một người bạn sở hữu và đã cấp cho bạn quyền để sử dụng.
• Từ Tác phẩm ⟩ Gói Nhóm cho các gói được xuất bản bởi các thành viên trong nhóm của bạn (bao gồm cả bạn).

Khi bạn đã chèn một gói vào mô hình dữ liệu của một nơi đã xuất bản, nó sẽ xuất hiện trong Trình quản lý Tài sản và vẫn ở đó ngay cả khi bạn sau này xóa tất cả các bản sao của nó.

Chỉnh sửa gói

Bạn có thể chỉnh sửa các gói và các đối tượng con của chúng giống như các đối tượng khác. Việc chỉnh sửa các gói sẽ vô hiệu hóa tự động cập nhật cho đến khi bạn xuất bản hoặc khôi phục những thay đổi.

Hầu hết các chỉnh sửa đều đánh dấu gói là đã sửa đổi, mặc dù các thay đổi sau đây không được coi là sửa đổi gói:

• Thay đổi tên của nút gốc.
• Thay đổi vị trí hoặc xoay của nút gốc của gói là BasePart, Model, hoặc GuiObject.
• Thay đổi thuộc tính Enabled của nút gốc GuiObject như là một ScreenGui, SurfaceGui, hoặc BillboardGui.
• Thay đổi một tham chiếu phần của một Weld bên trong gói tham chiếu đến một实例 bên ngoài của gói.

Khi đã được sửa đổi, các gói có thay đổi chưa công bố sẽ nhận được biểu tượng đã sửa đổi trong cửa sổ Explorer:

Thêm hoặc cập nhật cấu hình

Bạn có thể bao gồm thuộc tính đối tượng tại gốc của một gói để tùy chỉnh hành vi của nó. Khi bạn xuất bản một gói, tập hợp thuộc tính/gía trị hiện tại sẽ trở thành cấu hình mặc định của gói. Trên bất kỳ bản sao nào của một gói, các giá trị thuộc tính đó có thể được thay đổi theo từng thể hiện, và các thay đổi đó sẽ được ghi chú bằng in nghiêng đậm. Khi các bản sao gói được cập nhật, các giá trị cấu hình đã sửa đổi sẽ được bảo tồn, trong khi các thuộc tính khác sẽ được cập nhật lên giá trị mặc định mới nhất.

Gói lồng ghép

Bạn có thể lồng ghép các gói bên trong các gói khác để duy trì và hợp tác trên các cấu trúc phức tạp, chẳng hạn như một loạt cơ chế phương tiện có thể được sửa đổi độc lập với gói cha của phương tiện.

Nếu bạn sửa đổi một gói lồng ghép, cả gói lồng ghép và gói cha đều được coi là đã sửa đổi. Bạn phải xuất bản các thay đổi cho bất kỳ gói lồng ghép nào trước khi bạn được phép xuất bản các thay đổi cho gói cha của nó, vì việc xuất bản gói cha sẽ đánh dấu nó là hiện tại/chưa sửa đổi và sẽ xung đột với các sửa đổi của gói lồng ghép.

Tập lệnh gói

Mỗi tập lệnh trong một gói không bị sửa đổi là chỉ đọc và hiển thị thông báo ở trên cùng với một liên kết để mở khóa tập lệnh.

Nhấp vào liên kết:

• Đánh dấu gói là đã sửa đổi bất kể bạn chỉnh sửa tập lệnh hay không.
• Loại bỏ thông báo/liên kết từ các tập lệnh khác trong gói.

Khi gói được xuất bản và di chuyển đến trạng thái chưa sửa đổi, các tập lệnh bên dưới nó trở thành chỉ đọc với một liên kết để sửa đổi.

Xuất bản thay đổi gói

Bạn có thể xuất bản bất kỳ thay đổi nào cho một gói như một phiên bản mới, làm cho các cập nhật của bạn có sẵn cho các bản sao gói khác trong suốt nơi và trên tất cả các trò chơi. Không cần xuất bản một gói đã sửa đổi trước khi xuất bản một nơi vì phiên bản đã sửa đổi được lưu cùng với nơi để phân phối trong tương lai.

Để xuất bản các thay đổi cho một gói:

1. Trong cửa sổ Explorer hoặc cửa sổ 3D, nhấp chuột phải vào bản sao đã sửa đổi và chọn Xuất bản đến Gói.

2. Nếu một bản sao gói đã bật tự động cập nhật, nó sẽ ngay lập tức lấy phiên bản cập nhật khi bạn mở nơi chứa chúng. Các bản sao khác nhận được biểu tượng "tải xuống" cho biết có bản cập nhật đã sẵn sàng. Bạn có thể cập nhật từng bản hoặc cập nhật hàng loạt tất cả các bản sao.

   

3. TÙY CHỌN

   Thêm mô tả về những thay đổi của bạn:

   1. Nhấp chuột phải vào gói và chọn Thông tin Gói.
   2. Trong cửa sổ Cấu hình Tài sản, chọn Các Phiên bản.
   3. Dưới thay đổi gần đây nhất của bạn, chọn Thêm.
   4. Mô tả những thay đổi của bạn, sau đó nhấp vào nút Gửi.

Cập nhật các bản sao lỗi thời

Bạn có thể cập nhật các bản sao gói lỗi thời lên phiên bản mới nhất, hoặc bạn có thể tiếp tục sử dụng phiên bản cũ hơn.

1. Trong cửa sổ Explorer , xác định các bản sao lỗi thời bằng biểu tượng "tải xuống". Bạn cũng có thể chọn bản sao lỗi thời trong cửa sổ 3D.

   

2. Nhấp chuột phải vào một bản sao lỗi thời và chọn Lấy Gói Mới Nhất. Bạn cũng có thể lựa chọn nhiều gói, nhấp chuột phải và chọn Lấy Gói Mới Nhất cho Các Gói Đã Chọn.

Cập nhật hàng loạt

Việc sử dụng nhiều gói có thể dẫn đến nhiều bản sao gói xuất hiện trong nhiều nơi trong một trò chơi. Ngoài việc đồng bộ hóa từng bản và cập nhật tự động, bạn có thể cập nhật tất cả các bản sao của một gói thông qua cập nhật hàng loạt.

1. RECOMMENDED

   Đóng các phiên bản Studio khác mà có bất kỳ nơi nào của trò chơi đang mở; điều này ngăn ngừa một phiên bản chưa lưu của một nơi tiềm ẩn ghi đè lên các cập nhật của bạn.
2. Trong cửa sổ Explorer hoặc cửa sổ 3D, nhấp chuột phải vào gói mong muốn và chọn Cập nhật Tất cả.
3. Chọn tất cả các nơi trong trò chơi hoặc một tập hợp con của các nơi và nhấp vào Cập nhật.

Cập nhật tự động

Để dễ dàng đồng bộ hóa, bạn có thể đặt một bản sao gói để tự động cập nhật bất cứ khi nào một phiên bản mới hơn được xuất bản. Cập nhật tự động của các bản sao gói sẽ xảy ra khi một nơi được mở trong Studio.

1. Trong cửa sổ Explorer, mở rộng cây phân cấp của gói và chọn đối tượng PackageLink của nó.

   

2. Trong cửa sổ Thuộc tính, bật thuộc tính Tự động cập nhật. Nếu bạn có các gói lồng ghép, thuộc tính này chỉ áp dụng cho gói cha cấp cao nhất, có nghĩa là các cập nhật tự động chỉ xảy ra khi gói cha được cập nhật.

Chia sẻ và cấp độ truy cập

Bạn có thể cấp quyền cho bạn bè, trò chơi, nhóm hoặc vai trò người dùng nhóm cụ thể để họ có thể tự do sử dụng các gói của bạn trong các tác phẩm của họ. Để biết thêm thông tin về quyền truy cập tài sản, hãy xem Quyền riêng tư tài sản.

Để thay đổi quyền gói dành cho một người hợp tác, chẳng hạn như một người bạn hoặc nhóm:

1. Trong cửa sổ Explorer, Toolbox, hoặc Trình quản lý Tài sản, nhấp chuột phải vào gói mong muốn và chọn Tùy chọn Gói ⟩ Thông tin Gói.

2. Trong cửa sổ Cấu hình Tài sản, chọn Quyền.

3. Sử dụng thanh tìm kiếm, nhập và chọn một người hợp tác mà bạn muốn cấp quyền sử dụng gói của bạn, sau đó chọn một cấp độ quyền.

   Quyền	Mô tả
   Sử dụng & Xem	Người hợp tác có thể sử dụng và xem (nhưng không chỉnh sửa) các phiên bản gói hiện tại và trước đó. Khi bạn cấp quyền cho một người hợp tác với khả năng này, bạn không thể thu hồi quyền truy cập vào một bản sao mà họ đã chèn vào trò chơi của họ; việc thu hồi quyền truy cập ngăn chặn việc chèn lại hoặc cập nhật gói, nhưng các bản sao gói trong mô hình dữ liệu của họ vẫn giữ nguyên.
   Chỉnh sửa	Người hợp tác có thể sử dụng, xem và chỉnh sửa các phiên bản gói hiện tại và trước đó, bao gồm cả việc xuất bản các thay đổi cho nó.

Khôi phục các thay đổi của gói

Thay vì hoàn tác một loạt các thay đổi của gói một cách riêng lẻ, bạn có thể khôi phục các thay đổi chưa công bố trong một hành động, khôi phục một gói về một phiên bản trước đó, hoặc khôi phục các thay đổi về các cấu hình cụ thể.

Khôi phục các thay đổi chưa công bố

Để hoàn tác toàn bộ một loạt các thay đổi chưa công bố:

1. Trong cửa sổ Explorer, xác định các bản sao đã sửa đổi bằng dấu chấm trên biểu tượng gói của chúng. Bạn cũng có thể chọn các bản sao đã sửa đổi trong cửa sổ 3D.

   

2. Nhấp chuột phải vào một bản sao đã sửa đổi và chọn Hoàn tác thay đổi đối với Gói, hoặc chọn nhiều bản sao (ít nhất một trong số đó đã được sửa đổi), nhấp chuột phải và chọn Hoàn tác thay đổi cho Các Gói Đã Chọn.

Khôi phục về phiên bản đã xuất bản

Để khôi phục một gói về một phiên bản đã xuất bản trước đó:

1. Trong cửa sổ Explorer, Toolbox, hoặc Trình quản lý Tài sản, nhấp chuột phải vào gói mong muốn và chọn Tùy chọn Gói ⟩ Thông tin Gói.
2. Trong cửa sổ Cấu hình Tài sản, chọn Các Phiên bản. Cửa sổ sẽ hiển thị chi tiết cho mỗi phiên bản đã xuất bản, bao gồm ngày và giờ xuất bản, cùng với bất kỳ mô tả nào về các thay đổi.
3. Nhấp vào dấu kiểm cạnh phiên bản mà bạn muốn khôi phục và nhấp vào Gửi.

Khôi phục cấu hình

Để khôi phục bất kỳ thuộc tính cấu hình nào về mặc định, chọn Đặt lại từ menu tùy chọn của nó trong phần Thuộc tính trong cửa sổ Thuộc tính.

So sánh các phiên bản gói

Khi một gói có nhiều phiên bản, bạn có thể so sánh các thay đổi giữa các phiên bản bằng cách sử dụng công cụ so sánh. Công cụ có một menu phân cấp gói cho biết tất cả các đối tượng đã được thêm vào, loại bỏ hoặc sửa đổi giữa các phiên bản bằng các biểu tượng tương ứng, bao gồm các tính năng sau:

• Tổng quan Hình ảnh hiển thị sự khác biệt hình ảnh của việc kết xuất 3D dưới các vị trí camera khác nhau. Đây là chế độ xem mặc định cho các gói có một đối tượng 3D (mô hình, phần) làm đối tượng gốc và hiện tại chỉ có sẵn cho đối tượng gốc.

• Thuộc tính cho thấy các thay đổi của thuộc tính và thuộc tính. Đây là chế độ xem mặc định cho các gói có một đối tượng không phải 3D (tập lệnh, ánh sáng, đối tượng 2D) làm đối tượng gốc, và nó có sẵn cho tất cả các đối tượng trong một gói.

• Tập lệnh cho thấy sự khác biệt từng dòng của tập lệnh. Nó có sẵn cho các gói chứa tập lệnh, bất kể tập lệnh có phải là đối tượng gốc hay không.

Để so sánh các phiên bản gói:

1. Trong cửa sổ Explorer hoặc cửa sổ 3D, nhấp chuột phải vào gói mục tiêu và chọn Tùy chọn Gói ⟩ So sánh Các Phiên bản Gói.

2. Theo mặc định, cửa sổ so sánh các thay đổi giữa bản sao địa phương của bạn và phiên bản mới nhất. Sử dụng hai menu xổ xuống để so sánh các phiên bản khác nhau.

   

   Một số phiên bản cũ hơn có thể không tương thích với công cụ so sánh gói.

3. Sau khi chọn các phiên bản:

   1. Để so sánh các kết xuất hình ảnh của mô hình gốc, nếu áp dụng, chọn tab Tổng quan Hình ảnh và điều chỉnh điều khiển camera để có góc nhìn mong muốn. Các điều khiển được đồng bộ hóa giữa các chế độ xem:

      • Di chuyển camera bằng cách nhấp chuột trái.
      • Xoay camera bằng cách nhấp chuột phải.
      • Phóng to và thu nhỏ camera bằng cuộn chuột.
      • Trung tâm lại bằng cách sử dụng phím tắt F.

   2. Để so sánh các thuộc tính và đặc điểm của một thể hiện, chọn thể hiện và tab Thuộc tính.

   3. Để so sánh sự khác biệt trong kịch bản cho một gói là một kịch bản hoặc chứa các kịch bản, hãy sử dụng tab Kịch bản.

      Công cụ này chỉ cho phép bạn so sánh các thay đổi kịch bản giữa phiên bản hiện tại và phiên bản đã xuất bản hoặc địa phương mới nhất, mà không chỉ định các cộng tác viên đã thực hiện thay đổi.

      Ngoài ra, bạn có thể mở công cụ so sánh kịch bản trực tiếp bằng cách nhấp chuột phải vào gói mục tiêu trong cửa sổ Explorer hoặc cửa sổ 3D và chọn Xem Thay đổi Kịch bản.