スタジオコマンドラインインターフェイス | 文書

Roblox Studio は、特定の場所やスクリプトをスタジオ起動時に開くなどの特別な機能を持って起動するためのコマンドライン引数をサポートしています。Roblox Studio の実行可能ファイルは通常、以下の場所にインストールされます：

OS	場所
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"