Roblox Studio supporta argomenti da riga di comando che consentono di avviarlo con funzionalità speciali, come l'apertura di un luogo o di uno script specifico quando viene avviato Studio. L'eseguibile di Roblox Studio è generalmente 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 registri dettagliati a stdout che sono più dettagliati di quanto appare nella finestra Output. Gli argomenti utilizzano un prefisso a doppio trattino e sono insensibili al caso. I percorsi dei file che contengono spazi devono essere racchiusi tra virgolette.
Qualsiasi argomento non documentato qui è riservato all'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 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 specifica versione precedente del luogo. Richiede --placeVersion <versionNumber> per specificare la versione. |
Argomenti opzionali
| Argomento | Descrizione |
|---|---|
| --targetInstanceId <guid> | Muove la telecamera di Studio per focalizzarsi sull'istanza con questo GUID dopo che il luogo è stato caricato. |
| --annotationId <guid> | Apre l'annotazione con questo GUID dopo che il luogo è stato caricato. |
Esempi
Apri un file locale
Per aprire un luogo locale, usa --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 uno script
Per aprire uno script, specifica l'ID del luogo, l'ID dell'universo e l'attività come descritto nella sezione aprire un luogo. Dopodiché fornisci uno dei seguenti argomenti a seconda di come vuoi aprire lo script.
| Argomento | Descrizione |
|---|---|
| --openScriptPath <path> | Il percorso dello script. Deve utilizzare / come separatori e seguire le semantiche absolute require-by-string. |
| --openScriptFromId <uniqueId> | L'ID unico dello script da aprire. |
Evidenziazione opzionale
Facoltativamente, evidenzia righe specifiche o un intervallo di caratteri all'apertura dello script.
| Argomento | Descrizione |
|---|---|
| --startLine <n> | Riga di partenza dell'intervallo di evidenziazione. Basata su 1 e inclusiva. |
| --endLine <n> | Riga finale dell'intervallo di evidenziazione. Basata su 1 ed esclusiva. |
| --startCharacter <n> | Posizione del carattere iniziale all'interno della riga. Basata su 1. |
| --endCharacter <n> | Posizione del carattere finale all'interno della riga. Basata su 1 ed esclusiva. |
Esempi
Esegui uno script
Usa --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'esperienza specifica, o --localPlaceFile per eseguire lo script in un file di luogo locale. Se quegli argomenti sono omessi, Studio apre il modello 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 opzionali
| Argomento | Descrizione |
|---|---|
| --outputFile <path> | Percorso a un file dove viene scritto l'output dello script. |
| --quitAfterExecution | Se fornito, Studio si chiude dopo che lo script ha terminato di eseguire. |
Esempi
Prova un asset
Usa --task TryAsset per inserire un asset specifico in un modello di baseplate e aprirlo per la modifica.
Argomenti richiesti
| Argomento | Descrizione |
|---|---|
| --assetId <id> | L'ID dell'asset da inserire. |
Esempio
Dump API
Usa --api, --fullApi o --apiV2 per scrivere la superficie API di Roblox in un file ed 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