Interfejs wiersza poleceń Studio | Dokumentacja

Roblox Studio obsługuje argumenty wiersza poleceń, które pozwalają uruchamiać je z specjalnymi funkcjami, takimi jak otwieranie konkretnego miejsca lub skryptu, gdy Studio się uruchamia. Wykonawalny plik Roblox Studio jest zazwyczaj instalowany w następujących lokalizacjach:

System operacyjny	Lokalizacja
Windows	%localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe
Mac	/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio

Gdy zostanie uruchomione z wiersza poleceń, Studio przesyła szczegółowe logi do stdout, które są bardziej szczegółowe niż to, co pojawia się w oknie Output. Argumenty używają podwójnego prefiksu i są nieczułe na wielkość liter. Ścieżki plików, które zawierają spacje, muszą być cytowane.

Jakiekolwiek argumenty, które nie zostały udokumentowane tutaj, są zarezerwowane do użytku wewnętrznego i mogą ulec zmianie bez powiadomienia.

Otwórz miejsce

Aby otworzyć opublikowane miejsce, określ identyfikator miejsca, identyfikator wszechświata oraz zadanie.

Wymagane argumenty

Argument	Opis
--placeId <placeId>	Numeryczny identyfikator miejsca, które ma zostać otwarte.
--universeId <universeId>	Wszechświat, który jest właścicielem miejsca.
--task <taskName>	Określa, jak Studio otwiera miejsce na podstawie podanego zadania. Zobacz tabelę obsługiwane zadania poniżej w celu uzyskania dalszych informacji.

Obsługiwane zadania

Argument	Opis
EditPlace	Otwiera najnowszą opublikowaną wersję miejsca do edycji.
EditPlaceRevision	Otwiera konkretną wcześniejszą wersję miejsca. Wymaga --placeVersion <versionNumber>, aby określić wersję.

Opcjonalne argumenty

Argument	Opis
--targetInstanceId <guid>	Przenosi kamerę Studio, aby skupić się na instancji z tym GUID, po załadowaniu miejsca.
--annotationId <guid>	Otwiera adnotację z tym GUID, po załadowaniu miejsca.

Przykłady


# Otwórz najnowszą wersję miejsca
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Otwórz konkretną wcześniejszą wersję
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Otwórz lokalny plik

Aby otworzyć lokalne miejsce, użyj --task EditFile z następującym argumentem.

Argument	Opis
--localPlaceFile <path>	Ścieżka bezwzględna do lokalnego pliku miejsca .rbxl lub .rbxlx, który ma zostać otwarty.

Możesz także otworzyć lokalny plik miejsca, przekazując ścieżkę pliku jako pierwszy argument pozycyjny bez nazwy flagi.

Przykłady


# Otwórz lokalny plik miejsca
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Skrót
RobloxStudio.exe "Projects\MyGame.rbxl"

Otwórz skrypt

Aby otworzyć skrypt, określ identyfikator miejsca, identyfikator wszechświata oraz zadanie, jak opisano w sekcji otwórz miejsce. Następnie podaj jeden z następujących argumentów, w zależności od tego, jak chcesz otworzyć skrypt.

Argument	Opis
--openScriptPath <path>	Ścieżka do skryptu. Musi używać / jako separatorów i stosować się do absolutnej semantyki require-by-string.
--openScriptFromId <uniqueId>	Unikalny identyfikator skryptu do otwarcia.

Opcjonalne podświetlenie

Opcjonalnie można podświetlić konkretne linie lub zakres znaków podczas otwierania skryptu.

Argument	Opis
--startLine <n>	Początkowa linia zakresu podświetlenia. 1-bazowy i włącznie.
--endLine <n>	Końcowa linia zakresu podświetlenia. 1-bazowy i wyłącznie.
--startCharacter <n>	Początkowa pozycja znaku w linii. 1-bazowa.
--endCharacter <n>	Końcowa pozycja znaku w linii. 1-bazowa i wyłącznie.

Przykłady


# Otwórz skrypt według ścieżki
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Otwórz skrypt według ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Otwórz skrypt i podświetl konkretne linie
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Otwórz skrypt i podświetl zakres znaków
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Uruchom skrypt

Użyj --task RunScript, aby wykonać skrypt Luau po zakończeniu ładowania miejsca. Skrypty działają na tym samym poziomie uprawnień, co pasek poleceń Studio. Możesz to połączyć z --placeId i --universeId, aby uruchomić skrypt w konkretnej grze, lub --localPlaceFile, aby uruchomić skrypt w lokalnym pliku miejsca. Jeśli te argumenty są pominięte, Studio otwiera domyślny pusty szablon płyty podstawowej i uruchamia skrypt tam.

Wymagane argumenty

Argument	Opis
--runScriptFile <path>	Ścieżka bezwzględna do pliku .lua lub .luau, który ma zostać wykonany.

Opcjonalne argumenty

Argument	Opis
--outputFile <path>	Ścieżka do pliku, do którego zapisany jest wynik skryptu.
--quitAfterExecution	Jeśli podano, Studio zamyka się po zakończeniu wykonywania skryptu.

Przykłady


# Uruchom skrypt w konkretnej grze i zakończ po zakończeniu
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Uruchom skrypt w domyślnej płycie podstawowej
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Wypróbuj zasób

Użyj --task TryAsset, aby wstawić konkretny zasób do szablonu płyty podstawowej i otworzyć go do edycji.

Wymagane argumenty

Argument	Opis
--assetId <id>	Identyfikator zasobu do wstawienia.

Przykład


RobloxStudio.exe --task TryAsset --assetId 53326

Zrzut API

Użyj --api, --fullApi lub --apiV2, aby zapisać powierzchnię API Roblox w pliku i zakończyć.

Argument	Opis
--api <path>	Zapisuje API skryptowe Luau jako JSON do określonego pliku.
--fullApi <path>	Zapisuje pełną powierzchnię API jako JSON do określonego pliku.
--apiV2 <path>	Zapisuje pełne API jako JSON w formacie schematu V2 do określonego pliku.

Przykłady


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

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

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