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

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

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

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

여기 문서화되지 않은 인수는 내부 용도로만 사용되며 예고 없이 변경될 수 있습니다.

장소 열기

게시된 장소를 열려면 장소 ID, 유니버스 ID 및 작업을 지정합니다.

필수 인수

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

지원되는 작업

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

선택적 인수

인수	설명
--targetInstanceId <guid>	장소가 로드된 후 이 GUID를 가진 인스턴스에 스튜디오 카메라를 집중시킵니다.
--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 스크립트를 실행합니다. 스크립트는 스튜디오 명령줄과 동일한 권한 수준에서 실행됩니다. 특정 게임에서 스크립트를 실행하기 위해 --placeId 및 --universeId와 결합하거나, 로컬 장소 파일에서 스크립트를 실행하기 위해 --localPlaceFile을 사용할 수 있습니다. 이러한 인수가 생략되면 스튜디오는 기본 빈 베이스플레이트 템플릿을 열고 그곳에서 스크립트를 실행합니다.

필수 인수

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

선택적 인수

인수	설명
--outputFile <path>	스크립트 출력이 기록될 파일의 경로입니다.
--quitAfterExecution	제공된 경우, 스크립트 실행이 완료된 후 스튜디오가 닫힙니다.

예시

# 특정 게임에서 스크립트 실행 후 종료
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"