Công cụ bên thứ ba | Tài liệu - Trung Tâm Nhà Sáng Tạo Roblox

Đối với các studio phát triển chuyên nghiệp, việc thiết lập các công cụ bên thứ ba và đầu tư vào tự động hóa có thể cải thiện đáng kể năng suất của nhà phát triển. Cách tiếp cận ưu tiên đám mây của Roblox có nhiều lợi thế, nhưng việc di chuyển một số phần của quy trình phát triển ra ngoài đám mây có thể giúp các nhóm lớn theo dõi sự thay đổi theo thời gian, xem xét mã và sử dụng các ngôn ngữ và công cụ mà họ đã quen thuộc.

Nếu bạn chỉ muốn sử dụng một trình soạn thảo văn bản bên ngoài hoặc giữ mã trong kiểm soát phiên bản, Script Sync là một lựa chọn tuyệt vời.
Nếu bạn muốn quản lý toàn bộ dự án của mình dưới dạng một tập hợp các tệp cục bộ, trang này sẽ đề cập đến một số công cụ và chiến lược.
Để so sánh quy trình làm việc của toàn bộ nhóm và những ưu nhược điểm của chúng, hãy xem So sánh quy trình làm việc dựa trên tệp.

Mặc dù trang này đề cập đến một số công cụ phổ biến, nhưng không nên coi đây là một khuyến nghị nghiêm ngặt về chúng. Mỗi nhóm có những nhu cầu khác nhau, vì vậy trang này nhằm giúp bạn xem xét các cách để cải thiện quy trình làm việc của mình thay vì bảo bạn tải xuống bất kỳ thứ gì cụ thể.

Các công cụ trên trang này không được Roblox duy trì và có thể thay đổi hoặc ngừng hoạt động bất cứ lúc nào.

Vấn đề đồng bộ hóa

Về cơ bản, việc sử dụng các công cụ bên ngoài với Roblox là một vấn đề đồng bộ hóa:

Bạn muốn các phiên bản Roblox của mình tồn tại dưới dạng các tệp trên đĩa để bạn có thể sử dụng các công cụ của riêng mình để làm việc với chúng.
Bạn phải đưa các tệp của mình trở lại dự án Roblox sau khi bạn đã hoàn thành công việc với chúng.
Nếu người khác đã thay đổi những tệp đó trong thời gian đó, bạn phải xử lý bất kỳ xung đột nào.

Để toàn bộ giải pháp cảm thấy liền mạch và tự động, bạn cần a) lắng nghe các thay đổi đối với các tệp và b) tích hợp những thay đổi này trở lại vào Studio.

Thay vì cách tiếp cận ưu tiên đám mây của Roblox, Rojo cho phép một cách tiếp cận "ưu tiên hệ thống tệp". Nó chạy một máy chủ trên máy của bạn giao tiếp với một plugin Studio để đồng bộ hóa các tệp của bạn và mô hình dữ liệu Studio.

Rojo

Rojo là công cụ phổ biến nhất để đồng bộ hóa các tệp với Studio. Để cài đặt và chạy nó, và để chọn giữa các dự án được quản lý một phần và hoàn toàn, hãy xem Rojo.

Rokit

Việc các thành viên trong nhóm sử dụng các phiên bản khác nhau của cùng một công cụ gây ra những vấn đề khó chẩn đoán. Một trình quản lý chuỗi công cụ như Rokit giải quyết điều này với một tệp rokit.toml liệt kê từng công cụ và phiên bản của nó, để rokit install thiết lập cùng một phiên bản trên mọi máy. Bởi vì nó quản lý môi trường phát triển cơ bản của bạn thay vì các gói trong dự án của bạn, Rokit giống như nvm hơn là npm. Để xem một ví dụ về rokit.toml, hãy xem Cài đặt Rojo.

Trình quản lý gói

Roblox có một bộ API mạnh mẽ, nhưng nếu bạn muốn sử dụng các gói phần mềm cộng đồng một cách nhất quán và có thể tái tạo, bạn cần một trình quản lý gói. Wally là một lựa chọn phổ biến. Bạn có thể cài đặt nó thông qua Rokit, giống như Rojo.

Trong thư mục Rojo của trò chơi của bạn, chạy wally init. Sau đó thêm các gói bạn muốn vào wally.toml. Tệp có thể trông như thế này:

[package]
name = "my-home-directory/my-new-experience"
version = "0.1.0"
registry = "https://github.com/UpliftGames/wally-index"
realm = "shared"

[dependencies]
react = "jsdotlua/react@17.2.1"
react-roblox = "jsdotlua/react-roblox@17.2.1"
cryo = "phalanxia/cryo@1.0.3"

Sau đó chạy wally install. Wally tạo một thư mục Packages và tải xuống các gói đã chỉ định vào đó. Bước cuối cùng là thêm thư mục Packages vào Rojo để nội dung của nó đồng bộ trở lại Roblox. Mở default.project.json và thêm đường dẫn. Để đơn giản, ví dụ này thêm toàn bộ thư mục vào ReplicatedStorage để tất cả các gói có sẵn cho tất cả các kịch bản, nhưng bạn có thể muốn thêm các gói cụ thể vào ServerScriptService hoặc StarterPlayerScripts:

{
  "name": "my-new-experience",
  "tree": {
    "$className": "DataModel",

    "ReplicatedStorage": {
      "Shared": {
        "$path": "src/shared"
      },
      "Packages": {
        "$path": "Packages"
      }
    },

    ...

  }
}

Sau đó, bạn có thể yêu cầu các gói trong các kịch bản của mình giống như bất kỳ ModuleScript nào khác:

local Players = game:GetService("Players")
local ReplicatedStorage = game:GetService("ReplicatedStorage")

local React = require(ReplicatedStorage.Packages.react)
local ReactRoblox = require(ReplicatedStorage.Packages["react-roblox"])

local handle = Instance.new("ScreenGui", Players.LocalPlayer.PlayerGui)
local root = ReactRoblox.createRoot(handle)

local helloFrame = React.createElement("TextLabel", {
	Text = "Xin chào thế giới!",
	Size = UDim2.new(0, 200, 0, 200),
	Position = UDim2.new(0.5, 0, 0.5, 0),
	AnchorPoint = Vector2.new(0.5, 0.5),
	BackgroundColor3 = Color3.fromRGB(248, 217, 109),
	Font = Enum.Font.LuckiestGuy,
	TextSize = 24
})

root:render(helloFrame)

Giống như hầu hết các dự án phần mềm khác, mục tiêu là các cộng tác viên có thể sao chép một kho lưu trữ, cài đặt Rokit, chạy một vài lệnh và có cùng một môi trường phát triển như phần còn lại của nhóm.

Để có hướng dẫn chi tiết về việc sử dụng React để tạo giao diện người dùng Roblox, hãy xem React + Roblox.

Kiểm soát phiên bản

Có một tập hợp các tệp văn bản thuần trên máy tính của bạn mở khóa nhiều khả năng, nhưng khả năng chính là kiểm soát phiên bản. Bạn có thể lưu trữ các tệp của mình trong một kho lưu trữ Git hoặc Mercurial; lưu trữ các kho lưu trữ từ xa và xem xét các thay đổi mã trong GitHub, GitLab, hoặc Bitbucket; và sử dụng bất kỳ trình soạn thảo văn bản nào bạn thích.

Visual Studio Code và Cursor có hệ sinh thái mở rộng lớn nhất, nhưng Sublime Text và Notepad++, và Vim đều là những lựa chọn phổ biến. Dù bạn chọn trình soạn thảo nào, việc khớp các khả năng của trình soạn thảo kịch bản Studio sẽ yêu cầu một số tiện ích mở rộng.

Bạn cũng có thể xem xét việc thêm:

Một trình phân tích mã như selene để phát hiện các vấn đề phổ biến và thực thi các tiêu chuẩn lập trình
Một trình định dạng mã như StyLua
Một máy chủ ngôn ngữ như Luau Language Server cho tự động hoàn thành, kiểm tra kiểu và nhiều hơn nữa
Các kịch bản Open Cloud (không đồng bộ với Studio) để cập nhật một trò chơi đã xuất bản hoặc khởi động lại các máy chủ

Công cụ xây dựng, tài sản và hợp nhất

Lune là một runtime Luau độc lập mà nhiều nhóm sử dụng cho các kịch bản xây dựng, triển khai và tự động hóa.
Tarmac tải lên hình ảnh từ đĩa lên Roblox và tạo một mô-đun ánh xạ các đường dẫn tệp đến các ID tài sản.
rbx-merge cho phép Git hiển thị các khác biệt có thể đọc được của các tệp địa điểm và mô hình Roblox và hợp nhất các thay đổi không xung đột. Để thiết lập, hãy xem Rojo được quản lý hoàn toàn.

Hoàn tác mọi thứ

Bởi vì các công cụ bên thứ ba đồng bộ hóa các thay đổi trở lại Roblox Studio thay vì thay thế nó, không phần nào của quy trình làm việc này liên quan đến bất kỳ sự ràng buộc nào. Bất cứ lúc nào, bạn có thể ngừng sử dụng một hoặc tất cả các công cụ này và quay lại chỉnh sửa trò chơi của bạn hoàn toàn trong Studio. Việc thiếu rủi ro khiến việc thử nghiệm với các công cụ bên thứ ba trở nên đặc biệt hấp dẫn.