Interfaccia a riga di comando di Studio | Documentazione

Roblox Studio supporta argomenti da riga di comando che ti consentono di avviarlo con funzionalità speciali, come l'apertura di un luogo o di uno script specifico all'avvio di Studio. L'eseguibile di Roblox Studio è tipicamente installato nei seguenti percorsi:

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

Quando avviato dalla riga di comando, Studio invia log dettagliati a stdout che sono più dettagliati di quelli che appaiono nella finestra Output. Gli argomenti utilizzano un prefisso a doppio trattino e non fanno distinzione tra maiuscole e minuscole. I percorsi dei file che contengono spazi devono essere racchiusi tra virgolette.

Qualsiasi argomento non documentato qui è destinato a uso interno e può essere soggetto a modifiche senza preavviso.

Apri un luogo

Per aprire un luogo pubblicato, specifica l'ID del luogo, l'ID dell'universo e un'attività.

Argomenti richiesti

Argomento	Descrizione
--placeId <placeId>	L'ID numerico del luogo da aprire.
--universeId <universeId>	L'universo che possiede il luogo.
--task <taskName>	Specifica come Studio apre il luogo in base all'attività fornita. Vedi la tabella delle attività supportate qui sotto per ulteriori informazioni.

Attività supportate

Argomento	Descrizione
EditPlace	Apre l'ultima versione pubblicata del luogo per la modifica.
EditPlaceRevision	Apre una versione precedente specifica del luogo. Richiede --placeVersion <versionNumber> per specificare la versione.

Argomenti facoltativi

Argomento	Descrizione
--targetInstanceId <guid>	Sposta la telecamera di Studio per concentrarsi sull'istanza con questo GUID dopo il caricamento del luogo.
--annotationId <guid>	Apre l'annotazione con questo GUID dopo il caricamento del luogo.

Esempi

# Apri l'ultima versione di un luogo
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# Apri una versione precedente specifica
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

Apri un file locale

Per aprire un luogo locale, utilizza --task EditFile con il seguente argomento.

Argomento	Descrizione
--localPlaceFile <path>	Percorso assoluto a un file di luogo locale .rbxl o .rbxlx da aprire.

Puoi anche aprire un file di luogo locale passando il percorso del file come primo argomento posizionale senza un nome di flag.

Esempi

# Apri un file di luogo locale
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# Forma abbreviata
RobloxStudio.exe "Projects\MyGame.rbxl"

Apri uno script

Per aprire uno script, specifica l'ID del luogo, l'ID dell'universo e l'attività come descritto nella sezione apri un luogo. Poi fornisci uno dei seguenti argomenti a seconda di come desideri aprire lo script.

Argomento	Descrizione
--openScriptPath <path>	Il percorso dello script. Deve utilizzare / come separatori e seguire la semantica require-by-string assoluta.
--openScriptFromId <uniqueId>	L'ID unico dello script da aprire.

Evidenziazione facoltativa

Facoltativamente, evidenzia righe specifiche o un intervallo di caratteri quando apri lo script.

Argomento	Descrizione
--startLine <n>	Riga iniziale dell'intervallo di evidenziazione. Basato su 1 e inclusivo.
--endLine <n>	Riga finale dell'intervallo di evidenziazione. Basato su 1 ed esclusivo.
--startCharacter <n>	Posizione del carattere iniziale all'interno della riga. Basato su 1.
--endCharacter <n>	Posizione del carattere finale all'interno della riga. Basato su 1 ed esclusivo.

Esempi

# Apri uno script per percorso
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# Apri uno script per ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# Apri uno script e evidenzia righe specifiche
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# Apri uno script e evidenzia un intervallo di caratteri
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

Esegui uno script

Utilizza --task RunScript per eseguire uno script Luau dopo che un luogo ha terminato il caricamento. Gli script vengono eseguiti allo stesso livello di autorizzazione della barra dei comandi di Studio. Puoi combinare questo con --placeId e --universeId per eseguire lo script in un gioco specifico, o --localPlaceFile per eseguire lo script in un file di luogo locale. Se quegli argomenti vengono omessi, Studio apre il modello di base vuoto predefinito e esegue lo script lì.

Argomenti richiesti

Argomento	Descrizione
--runScriptFile <path>	Percorso assoluto a un file .lua o .luau da eseguire.

Argomenti facoltativi

Argomento	Descrizione
--outputFile <path>	Percorso a un file in cui viene scritto l'output dello script.
--quitAfterExecution	Se fornito, Studio si chiude dopo che lo script ha terminato l'esecuzione.

Esempi

# Esegui uno script in un gioco specifico e chiudi al termine
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# Esegui uno script nel Baseplate predefinito
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

Prova un asset

Utilizza --task TryAsset per inserire un asset specifico in un modello di base e aprirlo per la modifica.

Argomenti richiesti

Argomento	Descrizione
--assetId <id>	L'ID dell'asset da inserire.

Esempio

RobloxStudio.exe --task TryAsset --assetId 53326

Dump API

Utilizza --api, --fullApi o --apiV2 per scrivere la superficie API di Roblox in un file e uscire.

Argomento	Descrizione
--api <path>	Scrive l'API di scripting Luau come JSON nel file specificato.
--fullApi <path>	Scrive l'intera superficie API come JSON nel file specificato.
--apiV2 <path>	Scrive l'intera API come JSON nel formato schema V2 nel file specificato.

Esempi

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

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

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