Giao diện dòng lệnh Studio | Tài liệu - Trung Tâm Nhà Sáng Tạo Roblox

Roblox Studio hỗ trợ các tham số dòng lệnh cho phép bạn khởi động nó với chức năng đặc biệt, chẳng hạn như mở một địa điểm hoặc kịch bản cụ thể khi Studio khởi động. Tệp thực thi Roblox Studio thường được cài đặt tại các vị trí sau:

Hệ điều hành	Vị trí
Windows	%localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe
Mac	/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio

Khi khởi động từ dòng lệnh, Studio chuyển tiếp các nhật ký chi tiết đến stdout chi tiết hơn so với những gì xuất hiện trong cửa sổ Output. Các tham số sử dụng tiền tố dấu gạch đôi và không phân biệt chữ hoa chữ thường. Các đường dẫn tệp chứa khoảng trắng phải được đặt trong dấu ngoặc kép.

Bất kỳ tham số nào không được tài liệu ở đây chỉ dành cho sử dụng nội bộ và có thể thay đổi mà không cần thông báo trước.

Mở một địa điểm

Để mở một địa điểm đã xuất bản, hãy chỉ định ID địa điểm, ID vũ trụ và một tác vụ.

Các tham số bắt buộc

Tham số	Mô tả
--placeId <placeId>	ID số của địa điểm cần mở.
--universeId <universeId>	Vũ trụ sở hữu địa điểm.
--task <taskName>	Xác định cách Studio mở địa điểm dựa trên tác vụ đã cho. Xem bảng các tác vụ được hỗ trợ bên dưới để biết thêm thông tin.

Các tác vụ được hỗ trợ

Tham số	Mô tả
EditPlace	Mở phiên bản đã xuất bản mới nhất của địa điểm để chỉnh sửa.
EditPlaceRevision	Mở một phiên bản trước đó cụ thể của địa điểm. Cần --placeVersion <versionNumber> để chỉ định phiên bản.

Các tham số tùy chọn

Tham số	Mô tả
--targetInstanceId <guid>	Di chuyển camera của Studio để tập trung vào phiên bản có GUID này sau khi địa điểm được tải.
--annotationId <guid>	Mở chú thích có GUID này sau khi địa điểm được tải.

Ví dụ


# Mở phiên bản mới nhất của một địa điểm
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Mở một phiên bản trước đó cụ thể
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Mở một tệp cục bộ

Để mở một địa điểm cục bộ, sử dụng --task EditFile với tham số sau.

Tham số	Mô tả
--localPlaceFile <path>	Đường dẫn tuyệt đối đến một tệp địa điểm .rbxl hoặc .rbxlx để mở.

Bạn cũng có thể mở một tệp địa điểm cục bộ bằng cách truyền đường dẫn tệp như tham số đầu tiên mà không cần tên cờ.

Ví dụ


# Mở một tệp địa điểm cục bộ
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Viết tắt
RobloxStudio.exe "Projects\MyGame.rbxl"

Mở một kịch bản

Để mở một kịch bản, hãy chỉ định ID địa điểm, ID vũ trụ và tác vụ như đã mô tả trong phần mở một địa điểm. Sau đó cung cấp một trong các tham số sau tùy thuộc vào cách bạn muốn mở kịch bản.

Tham số	Mô tả
--openScriptPath <path>	Đường dẫn đến kịch bản. Phải sử dụng / làm dấu phân cách và tuân theo các quy tắc require-by-string tuyệt đối.
--openScriptFromId <uniqueId>	ID duy nhất của kịch bản để mở.

Tô sáng tùy chọn

Có thể tô sáng các dòng cụ thể hoặc một khoảng ký tự khi mở kịch bản.

Tham số	Mô tả
--startLine <n>	Dòng bắt đầu của phạm vi tô sáng. Tính từ 1 và bao gồm.
--endLine <n>	Dòng kết thúc của phạm vi tô sáng. Tính từ 1 và không bao gồm.
--startCharacter <n>	Vị trí ký tự bắt đầu trong dòng. Tính từ 1.
--endCharacter <n>	Vị trí ký tự kết thúc trong dòng. Tính từ 1 và không bao gồm.

Ví dụ


# Mở một kịch bản theo đường dẫn
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Mở một kịch bản theo ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Mở một kịch bản và tô sáng các dòng cụ thể
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Mở một kịch bản và tô sáng một khoảng ký tự
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Chạy một kịch bản

Sử dụng --task RunScript để thực thi một kịch bản Luau sau khi địa điểm hoàn tất tải. Các kịch bản chạy ở cùng trình độ phân quyền như thanh lệnh của Studio. Bạn có thể kết hợp điều này với --placeId và --universeId để chạy kịch bản trong một trải nghiệm cụ thể, hoặc --localPlaceFile để chạy kịch bản trong tệp địa điểm cục bộ. Nếu những tham số đó bị bỏ qua, Studio sẽ mở mẫu bản phẳng trống mặc định và chạy kịch bản ở đó.

Các tham số bắt buộc

Tham số	Mô tả
--runScriptFile <path>	Đường dẫn tuyệt đối đến tệp .lua hoặc .luau để thực thi.

Các tham số tùy chọn

Tham số	Mô tả
--outputFile <path>	Đường dẫn đến một tệp nơi đầu ra của kịch bản sẽ được ghi.
--quitAfterExecution	Nếu có, Studio sẽ đóng sau khi kịch bản thực thi xong.

Ví dụ


# Chạy một kịch bản trong một trải nghiệm cụ thể và thoát khi hoàn tất
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Chạy một kịch bản trong Bản phẳng mặc định
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Thử một tài sản

Sử dụng --task TryAsset để chèn một tài sản cụ thể vào mẫu bản phẳng và mở nó để chỉnh sửa.

Các tham số bắt buộc

Tham số	Mô tả
--assetId <id>	ID tài sản để chèn.

Ví dụ


RobloxStudio.exe --task TryAsset --assetId 53326

Xuất API

Sử dụng --api, --fullApi hoặc --apiV2 để ghi bề mặt API của Roblox vào một tệp và thoát.

Tham số	Mô tả
--api <path>	Ghi API lập trình Luau dưới dạng JSON vào tệp được chỉ định.
--fullApi <path>	Ghi bề mặt API đầy đủ dưới dạng JSON vào tệp được chỉ định.
--apiV2 <path>	Ghi API đầy đủ dưới dạng JSON trong định dạng lược đồ V2 vào tệp được chỉ định.

Ví dụ


RobloxStudio.exe --api "Desktop/output.json"

RobloxStudio.exe --fullApi "Desktop/output.json"

RobloxStudio.exe --apiV2 "Desktop/output.json"