Studio-Befehlszeilen-Schnittstelle | Dokumentation

Roblox Studio unterstützt Befehlszeilenargumente, mit denen Sie es mit speziellen Funktionen starten können, wie z.B. beim Start von Studio einen bestimmten Ort oder ein bestimmtes Skript zu öffnen. Die ausführbare Datei von Roblox Studio wird normalerweise an den folgenden Standorten installiert:

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

Wenn Studio von der Befehlszeile aus gestartet wird, leitet es ausführliche Protokolle an stdout, die detaillierter sind als die, die im Ausgabe-Fenster angezeigt werden. Argumente verwenden ein Doppelbindestrich-Präfix und sind nicht groß-/kleinschreibungsempfindlich. Datei-Pfade, die Leerzeichen enthalten, müssen in Anführungszeichen gesetzt werden.

Alle hier nicht dokumentierten Argumente sind nur für den internen Gebrauch bestimmt und unterliegen Änderungen ohne Vorankündigung.

Ort öffnen

Um einen veröffentlichten Ort zu öffnen, geben Sie die Ort-ID, die Universum-ID und eine Aufgabe an.

Erforderliche Argumente

Argument	Beschreibung
--placeId <placeId>	Die numerische ID des zu öffnenden Ortes.
--universeId <universeId>	Das Universum, dem der Ort gehört.
--task <taskName>	Gibt an, wie Studio den Ort basierend auf der angegebenen Aufgabe öffnet. Siehe die Tabelle der unterstützten Aufgaben weiter unten für weitere Informationen.

Unterstützte Aufgaben

Argument	Beschreibung
EditPlace	Öffnet die neueste veröffentlichte Version des Ortes zur Bearbeitung.
EditPlaceRevision	Öffnet eine bestimmte vorherige Version des Ortes. Erfordert --placeVersion <versionNumber>, um die Version anzugeben.

Optionale Argumente

Argument	Beschreibung
--targetInstanceId <guid>	Bewegt die Studio-Kamera, um sich nach dem Laden des Ortes auf die Instanz mit dieser GUID zu konzentrieren.
--annotationId <guid>	Öffnet die Annotation mit dieser GUID, nachdem der Ort geladen wurde.

Beispiele


# Öffne die neueste Version eines Ortes
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Öffne eine bestimmte vorherige Version
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Lokale Datei öffnen

Um einen lokalen Ort zu öffnen, verwenden Sie --task EditFile mit dem folgenden Argument.

Argument	Beschreibung
--localPlaceFile <path>	Absoluter Pfad zu einer lokalen .rbxl oder .rbxlx Ort-Datei, die geöffnet werden soll.

Sie können auch eine lokale Ort-Datei öffnen, indem Sie den Dateipfad als erstes positionales Argument ohne einen Flag-Namen übergeben.

Beispiele


# Öffne eine lokale Ort-Datei
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Abkürzung
RobloxStudio.exe "Projects\MyGame.rbxl"

Skript öffnen

Um ein Skript zu öffnen, geben Sie die Ort-ID, die Universum-ID und die Aufgabe wie im Abschnitt Ort öffnen beschrieben an. Geben Sie dann eines der folgenden Argumente an, abhängig davon, wie Sie das Skript öffnen möchten.

Argument	Beschreibung
--openScriptPath <path>	Der Pfad zum Skript. Muss / als Trenner verwenden und den absoluten require-by-string-Semantiken folgen.
--openScriptFromId <uniqueId>	Die eindeutige ID des zu öffnenden Skripts.

Optionale Hervorhebung

Optional können bestimmte Zeilen oder einen Zeichenausschnitt beim Öffnen des Skripts hervorgehoben werden.

Argument	Beschreibung
--startLine <n>	Startzeile des Hervorhebungsbereichs. 1-basiert und inklusive.
--endLine <n>	Endzeile des Hervorhebungsbereichs. 1-basiert und exklusiv.
--startCharacter <n>	Startzeichenposition innerhalb der Zeile. 1-basiert.
--endCharacter <n>	Endzeichenposition innerhalb der Zeile. 1-basiert und exklusiv.

Beispiele


# Öffne ein Skript nach Pfad
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Öffne ein Skript nach ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Öffne ein Skript und hebe bestimmte Zeilen hervor
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Öffne ein Skript und hebe einen Zeichenausschnitt hervor
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Skript ausführen

Verwenden Sie --task RunScript, um ein Luau-Skript auszuführen, nachdem ein Ort fertig geladen wurde. Skripte werden auf dem gleichen Berechtigungsniveau wie die Befehlszeile von Studio ausgeführt. Sie können dies mit --placeId und --universeId kombinieren, um das Skript in einem bestimmten Erlebnis auszuführen, oder --localPlaceFile, um das Skript in einer lokalen Ort-Datei auszuführen. Wenn diese Argumente weggelassen werden, öffnet Studio die standardmäßige leere Grundplatte und führt das Skript dort aus.

Erforderliche Argumente

Argument	Beschreibung
--runScriptFile <path>	Absoluter Pfad zu einer .lua oder .luau Datei, die ausgeführt werden soll.

Optionale Argumente

Argument	Beschreibung
--outputFile <path>	Pfad zu einer Datei, in der die Skriptausgabe geschrieben wird.
--quitAfterExecution	Wenn angegeben, schließt Studio, nachdem das Skript ausgeführt wurde.

Beispiele


# Führen Sie ein Skript in einem bestimmten Erlebnis aus und beenden Sie, wenn es fertig ist
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Führen Sie ein Skript in der standardmäßigen Grundplatte aus
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Asset testen

Verwenden Sie --task TryAsset, um ein bestimmtes Asset in eine Grundplattenschablone einzufügen und es zum Bearbeiten zu öffnen.

Erforderliche Argumente

Argument	Beschreibung
--assetId <id>	Die Asset-ID, die eingefügt werden soll.

Beispiel


RobloxStudio.exe --task TryAsset --assetId 53326

API-Dump

Verwenden Sie --api, --fullApi oder --apiV2, um die Roblox-API-Oberfläche in eine Datei zu schreiben und zu beenden.

Argument	Beschreibung
--api <path>	Schreibt die Luau-Scripting-API als JSON in die angegebene Datei.
--fullApi <path>	Schreibt die vollständige API-Oberfläche als JSON in die angegebene Datei.
--apiV2 <path>	Schreibt die vollständige API als JSON im V2-Schemaformat in die angegebene Datei.

Beispiele


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

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

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