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 mengalirkan log yang lebih rinci ke stdout dibandingkan dengan yang muncul di jendela Output. Argumen menggunakan awalan double-dash dan tidak peka huruf besar/kecil. Jalur file yang mengandung spasi harus diapit tanda kutip.

Argumen 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 bagaimana 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 yang diterbitkan dari tempat untuk diedit.
EditPlaceRevision	Membuka versi sebelumnya dari tempat tersebut. Memerlukan --placeVersion <versionNumber> untuk menentukan versi.

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 melewatkan jalur file sebagai argumen posisi 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 di bagian buka tempat. Kemudian berikan salah satu argumen berikut tergantung pada bagaimana Anda ingin membuka skrip tersebut.

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 baris tertentu atau rentang karakter saat membuka skrip.

Argumen	Deskripsi
--startLine <n>	Baris awal dari rentang sorotan. 1-based dan inklusif.
--endLine <n>	Baris akhir dari rentang sorotan. 1-based dan eksklusif.
--startCharacter <n>	Posisi karakter awal dalam baris. 1-based.
--endCharacter <n>	Posisi karakter akhir dalam baris. 1-based 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 baris 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 menggabungkan ini dengan --placeId dan --universeId untuk menjalankan skrip di game 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 output skrip ditulis.
--quitAfterExecution	Jika disediakan, Studio akan menutup setelah skrip selesai dieksekusi.

Contoh

# Jalankan skrip di game tertentu dan keluar saat 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 permukaan API lengkap sebagai JSON ke file yang ditentukan.
--apiV2 <path>	Menulis API lengkap 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"