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 2Abrir 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 6Ejecutar 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.luauProbar 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 53326Volcado 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"