스튜디오 명령줄 인터페이스 | 설명서

Roblox Studio는 특별한 기능으로 실행할 수 있는 명령줄 인수를 지원하며, Studio가 시작될 때 특정 장소나 스크립트를 열 수 있습니다. Roblox Studio 실행 파일은 일반적으로 다음 위치에 설치됩니다:

운영 체제	위치
Windows	%localappdata%\Roblox\Versions\[version]\RobloxStudioBeta.exe
Mac	/Applications/RobloxStudio.app/Contents/MacOS/RobloxStudio

명령줄에서 실행할 때, Studio는 stdout에 보다 자세한 로그를 파이프합니다. 로그는 Output 창에 표시되는 것보다 더 상세합니다. 인수는 이중 대시 접두사를 사용하며 대소문자를 구분하지 않습니다. 공백이 포함된 파일 경로는 따옴표로 묶어야 합니다.

여기 문서화되지 않은 인수는 내부 사용 용도로만 제공되며 향후 변경될 수 있습니다.

장소 열기

게시된 장소를 열려면 장소 ID, 우주 ID 및 작업을 지정해야 합니다.

필수 인수

인수	설명
--placeId <placeId>	열려는 장소의 숫자 ID입니다.
--universeId <universeId>	장소를 소유한 우주입니다.
--task <taskName>	주어진 작업에 따라 Studio가 장소를 여는 방법을 지정합니다. 더 많은 정보는 아래의 지원되는 작업 표를 참조하십시오.

지원되는 작업

인수	설명
EditPlace	최신 게시된 버전의 장소를 편집할 수 있도록 엽니다.
EditPlaceRevision	특정 이전 버전의 장소를 엽니다. 버전을 지정하기 위해 --placeVersion <versionNumber>가 필요합니다.

선택적 인수

인수	설명
--targetInstanceId <guid>	장소가 로드된 후 이 GUID를 가진 인스턴스에 초점을 맞추기 위해 Studio 카메라를 이동합니다.
--annotationId <guid>	장소가 로드된 후 이 GUID와 함께 주석을 엽니다.

예시


# 최신 버전의 장소 열기
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708

# 특정 이전 버전 열기
RobloxStudio.exe --task EditPlaceRevision --placeId 74265016723074 --universeId 7127583708 --placeVersion 2

로컬 파일 열기

로컬 장소를 열려면 --task EditFile을 사용하고 다음 인수를 지정합니다.

인수	설명
--localPlaceFile <path>	열려는 로컬 .rbxl 또는 .rbxlx 장소 파일의 절대 경로입니다.

또한 플래그 이름 없이 첫 번째 위치 인수로 파일 경로를 전달하여 로컬 장소 파일을 열 수 있습니다.

예시


# 로컬 장소 파일 열기
RobloxStudio.exe --task EditFile --localPlaceFile "Projects\MyGame.rbxl"

# 간편하게
RobloxStudio.exe "Projects\MyGame.rbxl"

스크립트 열기

스크립트를 열려면 장소 ID, 우주 ID 및 작업을 장소 열기 섹션에서 설명한 대로 지정합니다. 그런 다음 스크립트를 여는 방법에 따라 다음 인수 중 하나를 제공합니다.

인수	설명
--openScriptPath <path>	스크립트의 경로입니다. /를 구분자로 사용해야 하며 절대 require-by-string 의미론을 따라야 합니다.
--openScriptFromId <uniqueId>	열려는 스크립트의 고유 ID입니다.

선택적 강조

스크립트를 열 때 특정 줄이나 문자 범위를 강조할 수 있습니다.

인수	설명
--startLine <n>	강조 범위의 시작 줄입니다. 1 기반이며 포함됩니다.
--endLine <n>	강조 범위의 끝 줄입니다. 1 기반이며 포함되지 않습니다.
--startCharacter <n>	줄 내의 시작 문자 위치입니다. 1 기반입니다.
--endCharacter <n>	줄 내의 끝 문자 위치입니다. 1 기반이며 포함되지 않습니다.

예시


# 경로로 스크립트 열기
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript

# ID로 스크립트 열기
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptFromId 604a6aa2-04cc-c820-09b3-a1dc0000537f

# 스크립트를 열고 특정 줄 강조하기
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 5

# 스크립트를 열고 문자 범위 강조하기
RobloxStudio.exe --task EditPlace --placeId 74265016723074 --universeId 7127583708 --openScriptPath Workspace/MyFolder/MyScript --startLine 1 --endLine 1 --startCharacter 1 --endCharacter 6

--task RunScript를 사용하여 장소가 로드된 후 Luau 스크립트를 실행합니다. 스크립트는 Studio 명령 줄에서와 동일한 권한 수준으로 실행됩니다. 특정 경험에서 스크립트를 실행하려면 --placeId와 --universeId로 결합하거나 로컬 장소 파일에서 스크립트를 실행하려면 --localPlaceFile을 사용할 수 있습니다. 그 인수가 생략되면 Studio는 기본 빈 베이스플레이트 템플릿을 열고 그곳에서 스크립트를 실행합니다.

필수 인수

인수	설명
--runScriptFile <path>	실행할 .lua 또는 .luau 파일의 절대 경로입니다.

선택적 인수

인수	설명
--outputFile <path>	스크립트 출력을 작성할 파일의 경로입니다.
--quitAfterExecution	제공될 경우, 스크립트 실행이 끝난 후 Studio가 종료됩니다.

예시


# 특정 경험에서 스크립트를 실행하고 완료되면 종료
RobloxStudio.exe --task RunScript --placeId 74265016723074 --universeId 7127583708 --runScriptFile smokeTest.luau --outputFile out.log --quitAfterExecution

# 기본 베이스플레이트에서 스크립트 실행
RobloxStudio.exe --task RunScript --runScriptFile smokeTest.luau

자산 사용해보기

--task TryAsset를 사용하여 특정 자산을 베이스플레이트 템플릿에 삽입하고 편집할 수 있도록 엽니다.

필수 인수

인수	설명
--assetId <id>	삽입할 자산 ID입니다.

예시


RobloxStudio.exe --task TryAsset --assetId 53326

API 덤프

--api, --fullApi, 또는 --apiV2를 사용하여 Roblox API 표면을 파일에 기록하고 종료합니다.

인수	설명
--api <path>	Luau 스크립팅 API를 JSON 형식으로 지정된 파일에 기록합니다.
--fullApi <path>	전체 API 표면을 JSON 형식으로 지정된 파일에 기록합니다.
--apiV2 <path>	V2 스키마 형식으로 전체 API를 JSON 형식으로 지정된 파일에 기록합니다.

예시


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

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

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