Interfaz de línea de comandos de Studio | Documentación del Centro de creación de Roblox

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 generalmente se instala en las siguientes ubicaciones:

S.O.	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 específicos que los que aparecen en la ventana de Salida. Los argumentos utilizan un prefijo de doble guión y no son sensibles 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 que se debe 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	Abrir la última versión publicada del lugar para edición.
EditPlaceRevision	Abrir una versión específica anterior del lugar. Requiere --placeVersion <versionNumber> para especificar la versión.

Argumentos opcionales

Argumento	Descripción
--targetInstanceId <guid>	Desplaza la cámara de Studio para enfocarse en la instancia con este GUID después de que se cargue el lugar.
--annotationId <guid>	Abrir la anotación con este GUID después de que se cargue 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 2

Abrir un archivo local

Para abrir un lugar local, utiliza --task EditFile con el siguiente argumento.

Argumento	Descripción
--localPlaceFile <path>	Ruta absoluta a un archivo de lugar .rbxl o .rbxlx que se debe 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 utilizar / como separadores y seguir la semántica de require-by-string absoluta.
--openScriptFromId <uniqueId>	El ID único del script que se debe abrir.

Resaltado opcional

Opcionalmente, puedes resaltar 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 inicial del carácter dentro de la línea. Basado en 1.
--endCharacter <n>	Posición final del carácter 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 6

Ejecutar un script

Utiliza --task RunScript para ejecutar un script de Luau después de que un lugar finalice su carga. Los scripts se ejecutan al mismo nivel de permisos que la barra de comandos de Studio. Puedes combinar esto con --placeId y --universeId para ejecutar el script en una experiencia específica, o --localPlaceFile para ejecutarlo en un archivo de lugar local. Si esos argumentos son omitidos, Studio abre la plantilla de baseplate vacía predeterminada y ejecuta el script allí.

Argumentos requeridos

Argumento	Descripción
--runScriptFile <path>	Ruta absoluta a un archivo .lua o .luau que se debe 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 termine de ejecutarse.

Ejemplos


# Ejecutar un script en una experiencia específica y salir al finalizar
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.luau

Probar un activo

Utiliza --task TryAsset para insertar un activo específico en una plantilla de baseplate y abrirlo para edición.

Argumentos requeridos

Argumento	Descripción
--assetId <id>	El ID del activo a insertar.

Ejemplo


RobloxStudio.exe --task TryAsset --assetId 53326

Volcado de API

Utiliza --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"