Antarmuka baris perintah Studio | Dokumentasi

Roblox Studio mendukung argumen baris perintah yang memungkinkan Anda meluncurkannya dengan fungsionalitas khusus, seperti membuka tempat atau skrip tertentu saat Studio dimulai. Eksekutabel Roblox Studio biasanya diinstal di lokasi berikut:

OS	Lokasi
Windows	%localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe
Mac	/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio

Saat diluncurkan dari baris perintah, Studio mengarahkan log verbose ke stdout yang lebih rinci daripada apa yang muncul di jendela Output. Argumen menggunakan awalan double-dash dan tidak peka huruf. Jalur file yang mengandung spasi harus diapit tanda kutip.

Argumen apa pun yang tidak didokumentasikan di sini hanya untuk penggunaan internal dan dapat berubah tanpa pemberitahuan.

Buka tempat

Untuk membuka tempat yang diterbitkan, tentukan ID tempat, ID alam semesta, dan tugas.

Argumen yang diperlukan

Argumen	Deskripsi
--placeId <placeId>	ID numerik dari tempat yang akan dibuka.
--universeId <universeId>	Alam semesta yang memiliki tempat tersebut.
--task <taskName>	Menentukan cara Studio membuka tempat berdasarkan tugas yang diberikan. Lihat tabel tugas yang didukung di bawah untuk informasi lebih lanjut.

Tugas yang didukung

Argumen	Deskripsi
EditPlace	Membuka versi terbaru tempat yang diterbitkan untuk diedit.
EditPlaceRevision	Membuka versi sebelumnya yang spesifik dari tempat tersebut. Memerlukan --placeVersion <versionNumber> untuk menentukan versinya.

Argumen opsional

Argumen	Deskripsi
--targetInstanceId <guid>	Memindahkan kamera Studio untuk fokus pada instance dengan GUID ini setelah tempat dimuat.
--annotationId <guid>	Membuka anotasi dengan GUID ini setelah tempat dimuat.

Contoh

# Buka versi terbaru dari sebuah tempat
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Buka versi sebelumnya yang spesifik
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Buka file lokal

Untuk membuka tempat lokal, gunakan --task EditFile dengan argumen berikut.

Argumen	Deskripsi
--localPlaceFile <path>	Jalur absolut ke file tempat lokal .rbxl atau .rbxlx yang akan dibuka.

Anda juga dapat membuka file tempat lokal dengan memberikan jalur file sebagai argumen posisional pertama tanpa nama flag.

Contoh

# Buka file tempat lokal
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Singkatan
RobloxStudio.exe "Projects\MyGame.rbxl"

Buka skrip

Untuk membuka skrip, tentukan ID tempat, ID alam semesta, dan tugas seperti yang dijelaskan dalam bagian buka tempat. Kemudian berikan salah satu argumen berikut tergantung pada bagaimana Anda ingin membuka skrip.

Argumen	Deskripsi
--openScriptPath <path>	Jalur ke skrip. Harus menggunakan / sebagai pemisah dan mengikuti semantik require-by-string absolut.
--openScriptFromId <uniqueId>	ID unik dari skrip yang akan dibuka.

Penyorotan opsional

Secara opsional, soroti garis tertentu atau rentang karakter saat membuka skrip.

Argumen	Deskripsi
--startLine <n>	Garis awal dari rentang sorotan. Berbasis 1 dan inklusif.
--endLine <n>	Garis akhir dari rentang sorotan. Berbasis 1 dan eksklusif.
--startCharacter <n>	Posisi karakter awal di dalam garis. Berbasis 1.
--endCharacter <n>	Posisi karakter akhir di dalam garis. Berbasis 1 dan eksklusif.

Contoh

# Buka skrip berdasarkan jalur
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Buka skrip berdasarkan ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Buka skrip dan soroti garis tertentu
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Buka skrip dan soroti rentang karakter
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Jalankan skrip

Gunakan --task RunScript untuk mengeksekusi skrip Luau setelah tempat selesai dimuat. Skrip dijalankan pada tingkat izin yang sama dengan bilah perintah Studio. Anda dapat menggabungkannya dengan --placeId dan --universeId untuk menjalankan skrip di pengalaman tertentu, atau --localPlaceFile untuk menjalankan skrip di file tempat lokal. Jika argumen tersebut dihilangkan, Studio akan membuka template baseplate kosong default dan menjalankan skrip di sana.

Argumen yang diperlukan

Argumen	Deskripsi
--runScriptFile <path>	Jalur absolut ke file .lua atau .luau yang akan dieksekusi.

Argumen opsional

Argumen	Deskripsi
--outputFile <path>	Jalur ke file tempat keluaran skrip ditulis.
--quitAfterExecution	Jika diberikan, Studio ditutup setelah skrip selesai dieksekusi.

Contoh

# Jalankan skrip di pengalaman tertentu dan keluar setelah selesai
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Jalankan skrip di Baseplate default
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Coba aset

Gunakan --task TryAsset untuk menyisipkan aset tertentu ke dalam template baseplate dan membukanya untuk diedit.

Argumen yang diperlukan

Argumen	Deskripsi
--assetId <id>	ID aset yang akan disisipkan.

Contoh

RobloxStudio.exe --task TryAsset --assetId 53326

Dump API

Gunakan --api, --fullApi, atau --apiV2 untuk menulis permukaan API Roblox ke file dan keluar.

Argumen	Deskripsi
--api <path>	Menulis API skrip Luau sebagai JSON ke file yang ditentukan.
--fullApi <path>	Menulis seluruh permukaan API sebagai JSON ke file yang ditentukan.
--apiV2 <path>	Menulis seluruh API sebagai JSON dalam format skema V2 ke file yang ditentukan.

Contoh

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

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

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