อินเทอร์เฟซคำสั่งของ Studio | เอกสาร - ศูนย์กลางครีเอเตอร์ Roblox

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"