Studio komut satırı arayüzü | Dokümantasyon

Roblox Studio, Studio'yu başlatırken belirli bir yer veya script açma gibi özel işlevsellik ile başlatmanıza olanak tanıyan komut satırı argümanlarını destekler. Roblox Studio yürütülebilir dosyası genellikle aşağıdaki konumlara kuruludur:

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

Komut satırından başlatıldığında, Studio, Çıktı penceresinde görünenlerden daha ayrıntılı olan stdout'e ayrıntılı günlükler aktarır. Argümanlar çift tire (--) ile başlar ve büyük/küçük harf duyarsızdır. Boşluk içeren dosya yolları tırnak içinde belirtilmelidir.

Burada belgelenmemiş argümanlar yalnızca dahili kullanım içindir ve bildirim olmaksızın değişikliğe tabi olabilir.

Bir yeri aç

Yayınlanmış bir yeri açmak için, yer kimliğini, evren kimliğini ve bir görevi belirtin.

Gerekli argümanlar

Argüman	Açıklama
--placeId <placeId>	Açılacak yerin sayısal kimliği.
--universeId <universeId>	Yerin sahibi olan evren.
--task <taskName>	Studio'nun yeri açarken belirli bir göreve dayalı olarak nasıl açılacağını belirtir. Daha fazla bilgi için aşağıdaki desteklenen görevler tablosuna bakın.

Desteklenen görevler

Argüman	Açıklama
EditPlace	Düzenleme için yerin en son yayınlanan sürümünü açar.
EditPlaceRevision	Yerin belirli bir önceki sürümünü açar. Sürümü belirtmek için --placeVersion <versionNumber> gerekir.

İsteğe bağlı argümanlar

Argüman	Açıklama
--targetInstanceId <guid>	Yer yüklendikten sonra bu GUID ile belirtilen örneğe odaklanması için Studio kamerasını hareket ettirir.
--annotationId <guid>	Yer yüklendikten sonra bu GUID ile belirtilen notu açar.

Örnekler

# Bir yerin en son sürümünü aç
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Belirli bir önceki sürümü aç
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Yerel bir dosya aç

Yerel bir yeri açmak için, aşağıdaki argümanı kullanarak --task EditFile belirtin.

Argüman	Açıklama
--localPlaceFile <path>	Açılacak yerel bir .rbxl veya .rbxlx dosyasının mutlak yolu.

Ayrıca, dosya yolunu bayrak adı olmadan ilk pozisyonel argüman olarak geçerek yerel bir yer dosyasını da açabilirsiniz.

Örnekler

# Yerel bir yer dosyasını aç
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Kısayol
RobloxStudio.exe "Projects\MyGame.rbxl"

Bir script aç

Bir script açmak için, bir yeri aç bölümünde açıklandığı gibi yer kimliğini, evren kimliğini ve görevi belirtin. Ardından, script'i nasıl açmak istediğinize bağlı olarak aşağıdaki argümanlardan birini sağlayın.

Argüman	Açıklama
--openScriptPath <path>	Scriptin yolu. / ayırıcı olarak kullanılmalı ve mutlak require-by-string anlamına uygun olmalıdır.
--openScriptFromId <uniqueId>	Açılacak scriptin benzersiz kimliği.

İsteğe bağlı vurgulama

Script'i açarken belirli satırları veya bir karakter aralığını vurgulamak isteğe bağlıdır.

Argüman	Açıklama
--startLine <n>	Vurgulama aralığının başlangıç satırı. 1 tabanlı ve kapsayıcıdır.
--endLine <n>	Vurgulama aralığının bitiş satırı. 1 tabanlı ve dışlayıcıdır.
--startCharacter <n>	Satır içindeki başlangıç karakter pozisyonu. 1 tabanlıdır.
--endCharacter <n>	Satır içindeki bitiş karakter pozisyonu. 1 tabanlı ve dışlayıcıdır.

Örnekler

# Bir scripti yoluna göre aç
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Bir scripti ID'sine göre aç
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Bir scripti aç ve belirli satırları vurgula
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Bir scripti aç ve bir karakter aralığını vurgula
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Bir script çalıştır

--task RunScript kullanarak, bir yer yüklendikten sonra bir Luau scriptini çalıştırın. Scriptler, Studio komut çubuğuyla aynı izin seviyesinde çalışır. Bunu --placeId ve --universeId ile bir özel deneyimde scripti çalıştırmak için veya --localPlaceFile ile yerel bir yer dosyasında scripti çalıştırmak için birleştirebilirsiniz. Bu argümanlar belirtilmezse, Studio varsayılan boş temel plaka şablonunu açar ve burada scripti çalıştırır.

Gerekli argümanlar

Argüman	Açıklama
--runScriptFile <path>	Çalıştırılacak bir .lua veya .luau dosyasının mutlak yolu.

İsteğe bağlı argümanlar

Argüman	Açıklama
--outputFile <path>	Script çıkışının yazıldığı bir dosyanın yolu.
--quitAfterExecution	Belirtilirse, script çalışmayı bitirdikten sonra Studio kapanır.

Örnekler

# Belirli bir deneyimde bir script çalıştır ve işlem bittiğinde çık
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Varsayılan Temel Plakada bir script çalıştır
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Bir varlık deneyin

Belirli bir varlığı temel plaka şablonuna ekleyip düzenlemek için --task TryAsset kullanın.

Gerekli argümanlar

Argüman	Açıklama
--assetId <id>	Ekleyeceğiniz varlık kimliği.

Örnek

RobloxStudio.exe --task TryAsset --assetId 53326

API dökümü

Roblox API yüzeyini bir dosyaya yazmak ve çıkmak için --api, --fullApi, veya --apiV2 kullanın.

Argüman	Açıklama
--api <path>	Luau script API'sini JSON formatında belirtilen dosyaya yazar.
--fullApi <path>	Tüm API yüzeyini JSON formatında belirtilen dosyaya yazar.
--apiV2 <path>	Tüm API'yi V2 şeması formatında JSON olarak belirtilen dosyaya yazar.

Örnekler

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

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

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