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 2Lokale 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 6Skript 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.luauAsset 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 53326API-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"