Roblox Studio admite argumentos de línea de comandos que te permiten lanzarlo con funcionalidades especiales, como abrir un lugar o script específico cuando se inicia Studio. El ejecutable de Roblox Studio se instala típicamente en las siguientes ubicaciones:
| Sistema Operativo | Ubicación |
|---|---|
| Windows | %localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe |
| Mac | /Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio |
Cuando se lanza desde la línea de comandos, Studio envía registros detallados a stdout que son más detallados que lo que aparece en la ventana de Salida. Los argumentos utilizan un prefijo de doble guion y son insensibles a mayúsculas. Las rutas de archivo que contienen espacios deben estar entre comillas.
Cualquier argumento no documentado aquí es solo para uso interno y está sujeto a cambios sin previo aviso.
Abrir un lugar
Para abrir un lugar publicado, especifica el ID del lugar, el ID del universo y una tarea.
Argumentos requeridos
| Argumento | Descripción |
|---|---|
| --placeId <placeId> | El ID numérico del lugar a abrir. |
| --universeId <universeId> | El universo que posee el lugar. |
| --task <taskName> | Especifica cómo Studio abre el lugar según la tarea dada. Consulta la tabla de tareas soportadas a continuación para más información. |
Tareas soportadas
| Argumento | Descripción |
|---|---|
| EditPlace | Abre la última versión publicada del lugar para editar. |
| EditPlaceRevision | Abre una versión anterior específica del lugar. Requiere --placeVersion <versionNumber> para especificar la versión. |
Argumentos opcionales
| Argumento | Descripción |
|---|---|
| --targetInstanceId <guid> | Mueve la cámara de Studio para enfocarse en la instancia con este GUID después de que se carga el lugar. |
| --annotationId <guid> | Abre la anotación con este GUID después de que se carga el lugar. |
Ejemplos
# Abrir la última versión de un lugar
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708
# Abrir una versión anterior específica
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2Abrir un archivo local
Para abrir un lugar local, usa --task EditFile con el siguiente argumento.
| Argumento | Descripción |
|---|---|
| --localPlaceFile <path> | Ruta absoluta a un archivo de lugar local .rbxl o .rbxlx para abrir. |
También puedes abrir un archivo de lugar local pasando la ruta del archivo como el primer argumento posicional sin un nombre de bandera.
Ejemplos
# Abrir un archivo de lugar local
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"
# Abreviatura
RobloxStudio.exe "Projects\MyGame.rbxl"Abrir un script
Para abrir un script, especifica el ID del lugar, el ID del universo y la tarea como se describe en la sección de abrir un lugar. Luego proporciona uno de los siguientes argumentos dependiendo de cómo quieras abrir el script.
| Argumento | Descripción |
|---|---|
| --openScriptPath <path> | La ruta al script. Debe usar / como separadores y seguir la semántica de require-by-string absoluta. |
| --openScriptFromId <uniqueId> | El ID único del script a abrir. |
Resaltado opcional
Opcionalmente, resalta líneas específicas o un rango de caracteres al abrir el script.
| Argumento | Descripción |
|---|---|
| --startLine <n> | Línea inicial del rango de resaltado. Basado en 1 e inclusivo. |
| --endLine <n> | Línea final del rango de resaltado. Basado en 1 y exclusivo. |
| --startCharacter <n> | Posición del carácter inicial dentro de la línea. Basado en 1. |
| --endCharacter <n> | Posición del carácter final dentro de la línea. Basado en 1 y exclusivo. |
Ejemplos
# Abrir un script por ruta
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript
# Abrir un script por ID
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f
# Abrir un script y resaltar líneas específicas
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5
# Abrir un script y resaltar un rango de caracteres
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6Ejecutar un script
Usa --task RunScript para ejecutar un script de Luau después de que un lugar termine de cargar. Los scripts se ejecutan al mismo nivel de permiso que la barra de comandos de Studio. Puedes combinar esto con --placeId y --universeId para ejecutar el script en un juego específico, o --localPlaceFile para ejecutar el script en un archivo de lugar local. Si se omiten esos argumentos, Studio abre la plantilla base de placa vacía predeterminada y ejecuta el script allí.
Argumentos requeridos
| Argumento | Descripción |
|---|---|
| --runScriptFile <path> | Ruta absoluta a un archivo .lua o .luau para ejecutar. |
Argumentos opcionales
| Argumento | Descripción |
|---|---|
| --outputFile <path> | Ruta a un archivo donde se escribe la salida del script. |
| --quitAfterExecution | Si se proporciona, Studio se cierra después de que el script termina de ejecutarse. |
Ejemplos
# Ejecutar un script en un juego específico y salir cuando termine
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution
# Ejecutar un script en la Baseplate predeterminada
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luauProbar un activo
Usa --task TryAsset para insertar un activo específico en una plantilla de placa base y abrirlo para editar.
Argumentos requeridos
| Argumento | Descripción |
|---|---|
| --assetId <id> | El ID del activo a insertar. |
Ejemplo
RobloxStudio.exe --task TryAsset --assetId 53326Volcado de API
Usa --api, --fullApi o --apiV2 para escribir la superficie de la API de Roblox en un archivo y salir.
| Argumento | Descripción |
|---|---|
| --api <path> | Escribe la API de scripting de Luau como JSON en el archivo especificado. |
| --fullApi <path> | Escribe la superficie completa de la API como JSON en el archivo especificado. |
| --apiV2 <path> | Escribe la API completa como JSON en el formato de esquema V2 en el archivo especificado. |
Ejemplos
RobloxStudio.exe --api "Desktop/output.json"
RobloxStudio.exe --fullApi "Desktop/output.json"
RobloxStudio.exe --apiV2 "Desktop/output.json"