Roblox Studio รองรับอาร์กิวเมนต์ในบรรทัดคำสั่งที่ช่วยให้คุณเปิดด้วยฟังก์ชันพิเศษ เช่น การเปิดสถานที่หรือสคริปต์เฉพาะเมื่อ Studio เริ่มต้น ไฟล์ที่ใช้ในการเรียกใช้งาน Roblox Studio ส่วนใหญ่จะติดตั้งในตำแหน่งดังต่อไปนี้:
| OS | ตำแหน่ง |
|---|---|
| Windows | %localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe |
| Mac | /Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio |
เมื่อเปิดจากบรรทัดคำสั่ง Studio จะส่งข้อมูลบันทึกที่มีรายละเอียดมากกว่าที่ปรากฏในหน้าต่าง Output ไปที่ stdout อาร์กิวเมนต์จะใช้พรีฟิกเป็น double-dash และไม่คำนึงถึงตัวพิมพ์ใหญ่-เล็ก เส้นทางไฟล์ที่มีช่องว่างต้องใส่อัญประกาศ
อาร์กิวเมนต์ใด ๆ ที่ไม่ได้เอกสารไว้ที่นี่มีไว้สำหรับการใช้งานภายในเท่านั้นและอาจมีการเปลี่ยนแปลงโดยไม่ต้องแจ้งให้ทราบ
เปิดสถานที่
ในการเปิดสถานที่ที่เผยแพร่แล้ว ให้ระบุ ID สถานที่, ID จักรวาล และงาน
อาร์กิวเมนต์ที่จำเป็น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --placeId <placeId> | หมายเลข ID ของสถานที่ที่ต้องการเปิด |
| --universeId <universeId> | จักรวาลที่เป็นเจ้าของสถานที่นั้น |
| --task <taskName> | ระบุวิธีที่ Studio จะเปิดสถานที่ตามงานที่กำหนด ดูตาราง งานที่รองรับ ด้านล่างเพื่อข้อมูลเพิ่มเติม |
งานที่รองรับ
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| EditPlace | เปิดเวอร์ชันที่เผยแพร่ล่าสุดของสถานที่สำหรับการแก้ไข |
| EditPlaceRevision | เปิดเวอร์ชันก่อนหน้าที่เฉพาะเจาะจงของสถานที่ จำเป็นต้องใช้ --placeVersion <versionNumber> เพื่อระบุเวอร์ชัน |
อาร์กิวเมนต์ที่ไม่จำเป็น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --targetInstanceId <guid> | เคลื่อนที่กล้องใน Studio เพื่อมุ่งเน้นไปที่อินสแตนซ์ที่มี GUID นี้หลังจากที่สถานที่โหลดเสร็จ |
| --annotationId <guid> | เปิดหมายเหตุที่มี GUID นี้หลังจากที่สถานที่โหลดเสร็จ |
ตัวอย่าง
# เปิดเวอร์ชันล่าสุดของสถานที่
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708
# เปิดเวอร์ชันก่อนหน้าที่เฉพาะเจาะจง
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2เปิดไฟล์ในเครื่อง
ในการเปิดสถานที่ในเครื่อง ให้ใช้ --task EditFile พร้อมกับอาร์กิวเมนต์ดังต่อไปนี้
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --localPlaceFile <path> | เส้นทางที่แน่นอนไปยังไฟล์สถานที่ .rbxl หรือ .rbxlx ที่จะเปิด |
คุณยังสามารถเปิดไฟล์สถานที่ในเครื่องโดยการส่งเส้นทางไฟล์เป็นอาร์กิวเมนต์เชิงตำแหน่งตัวแรกโดยไม่ใช้ชื่อแฟล็ก
ตัวอย่าง
# เปิดไฟล์สถานที่ในเครื่อง
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"
# ย่อ
RobloxStudio.exe "Projects\MyGame.rbxl"เปิดสคริปต์
ในการเปิดสคริปต์ ให้ระบุ ID สถานที่, ID จักรวาล และงานตามที่กล่าวถึงในส่วน เปิดสถานที่ แล้ว ระบุหนึ่งในอาร์กิวเมนต์ต่อไปนี้ขึ้นอยู่กับวิธีที่คุณต้องการเปิดสคริปต์
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --openScriptPath <path> | เส้นทางไปยังสคริปต์ จะต้องใช้ / เป็นตัวคั่นและปฏิบัติตามความหมาย require-by-string แบบสัมบูรณ์ |
| --openScriptFromId <uniqueId> | หมายเลข ID เฉพาะของสคริปต์ที่ต้องการเปิด |
การเน้นที่ไม่จำเป็น
เลือกที่จะเน้นบรรทัดเฉพาะหรือช่วงตัวอักขระเมื่อเปิดสคริปต์
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --startLine <n> | บรรทัดเริ่มต้นของช่วงการเน้น 1-based และรวมอยู่ในช่วง |
| --endLine <n> | บรรทัดสิ้นสุดของช่วงการเน้น 1-based และไม่รวมอยู่ในช่วง |
| --startCharacter <n> | ตำแหน่งตัวอักขระเริ่มต้นภายในบรรทัด 1-based |
| --endCharacter <n> | ตำแหน่งตัวอักขระสิ้นสุดภายในบรรทัด 1-based และไม่รวมอยู่ในช่วง |
ตัวอย่าง
# เปิดสคริปต์ตามเส้นทาง
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript
# เปิดสคริปต์ตาม ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f
# เปิดสคริปต์และเน้นบรรทัดเฉพาะ
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5
# เปิดสคริปต์และเน้นช่วงตัวอักขระ
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6รันสคริปต์
ใช้ --task RunScript เพื่อดำเนินการสคริปต์ Luau หลังจากที่สถานที่โหลดเสร็จ สคริปต์จะทำงานที่ระดับสิทธิ์เดียวกันกับแถบคำสั่งของ Studio คุณสามารถรวมสิ่งนี้กับ --placeId และ --universeId เพื่อรันสคริปต์ในประสบการณ์เฉพาะ หรือ --localPlaceFile เพื่อรันสคริปต์ในไฟล์สถานที่ในเครื่อง หากไม่มีอาร์กิวเมนต์เหล่านั้น Studio จะเปิดเทมเพลตฐานเปล่าที่มีค่าเริ่มต้นและรันสคริปต์ที่นั่น
อาร์กิวเมนต์ที่จำเป็น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --runScriptFile <path> | เส้นทางที่แน่นอนไปยังไฟล์ .lua หรือ .luau ที่จะดำเนินการ |
อาร์กิวเมนต์ที่ไม่จำเป็น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --outputFile <path> | เส้นทางไปยังไฟล์ที่ผลลัพธ์ของสคริปต์จะเขียนลง |
| --quitAfterExecution | หากระบุ Studio จะปิดหลังจากที่สคริปต์เสร็จสิ้นการดำเนินการ |
ตัวอย่าง
# รันสคริปต์ในประสบการณ์เฉพาะและออกเมื่อเสร็จ
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution
# รันสคริปต์ใน Baseplate เริ่มต้น
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luauทดสอบทรัพย์สิน
ใช้ --task TryAsset เพื่อแทรกทรัพย์สินเฉพาะลงในเทมเพลตฐานแล้วเปิดเพื่อแก้ไข
อาร์กิวเมนต์ที่จำเป็น
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --assetId <id> | หมายเลข ID ของทรัพย์สินที่จะนำเข้า |
ตัวอย่าง
RobloxStudio.exe --task TryAsset --assetId 53326การให้ข้อมูล API
ใช้ --api, --fullApi, หรือ --apiV2 เพื่อเขียนพื้นผิว API ของ Roblox ลงในไฟล์และออก
| อาร์กิวเมนต์ | คำอธิบาย |
|---|---|
| --api <path> | เขียน API สคริปต์ Luau เป็น JSON ลงในไฟล์ที่ระบุ |
| --fullApi <path> | เขียนพื้นผิว API ทั้งหมดเป็น JSON ลงในไฟล์ที่ระบุ |
| --apiV2 <path> | เขียน API ทั้งหมดเป็น JSON ในรูปแบบสกีมา V2 ลงในไฟล์ที่ระบุ |
ตัวอย่าง
RobloxStudio.exe --api "Desktop/output.json"
RobloxStudio.exe --fullApi "Desktop/output.json"
RobloxStudio.exe --apiV2 "Desktop/output.json"