【マイクラ統合版】/script（スクリプト）コマンドの使い方！アドオン開発用のデバッガー接続やプロファイラー機能の解説

マイクラ統合版（スイッチ・スマホ・PS5・PC）・教育版の/scriptコマンドの解説です。このコマンドは、自作のアドオン（ビヘイビアーパック）に組み込んだ「スクリプトAPI（JavaScript）」の動作をテスト・検証・最適化するための開発者専用デバッグコマンドです。外部のコードエディタ（VS Codeなど）のデバッガーとマイクラを通信接続したり、スクリプトの処理重さを測るプロファイラーを起動したりできます。一般的なゲームプレイや通常のコマンドブロックによる自動化ではなく、一歩進んだ「マイクラのアドオン・Mod開発」を行うクリエイター向けの高度なシステムコマンドです。

/script（スクリプトデバッガーコマンド）統合版対応（開発者向け）

/script profiler start

【実行例】現在動作しているJavaScript（スクリプトAPI）のパフォーマンス計測（プロファイリング）を開始します。

⚙️ /script コマンドの3つの主要モードと構文

`/script` コマンドには、外部エディタと連動する「debugger」、診断データを集める「diagnostics」、負荷を測定する「profiler」の3つのサブコマンドが存在します。

① デバッガー接続の開始・接続・終了（debugger）

        /script debugger listen <ポート番号: int>

        /script debugger connect [ホストIP: string] [ポート番号: int]

        /script debugger close

② スクリプト診断データのキャプチャ開始・終了（diagnostics）

        /script diagnostics startcapture

        /script diagnostics stopcapture

③ パフォーマンス計測（プロファイラー）の開始・終了（profiler）

        /script profiler start

        /script profiler stop

📋 各引数（サブコマンド）の詳しい意味と開発時における役割

構文（パーツ）	設定値・記述ルール	詳しい効果と説明
debugger listen	<port: int> 例: 19144	マイクラ側で指定したポート番号を開放し、外部の統合開発環境（VS CodeのMinecraft Debugger拡張機能など）からのデバッグ接続を待ち受け（リスン）状態にします。
debugger connect	[host: string] [port: int] 例: localhost 19144	すでに外部で立ち上がっているデバッガーツールに対して、マイクラ側からIPアドレスとポート番号を指定して直接能動的に接続（コネクト）を試みます。
debugger close	（引数なし）	現在確立されている外部エディタとのデバッグ通信セッションを安全に切断し、ポートを閉じます。
diagnostics	startcapture stopcapture	スクリプトAPIのメモリ使用量やエラーログなど、動作中の詳細なシステム状態（診断データ）のキャプチャ（記録）を開始・停止します。
profiler	start stop	JavaScriptコードの実行速度を測定します。アドオンを入れてからゲームが重くなった際、関数のどれが処理のボトルネック（負荷の原因）になっているかを突き止めるためにプロファイリングを行います。

🛠️ 開発現場で役立つ！実践コマンド実例集

自作のJavaScriptコード（スクリプトAPI）を検証する際の一般的なデバッグ手順の流れです。

手順1：外部エディタ（VS Codeなど）からの通信を受け付ける

/script debugger listen 19144

マイクラ内でポート番号「19144」を開放します。この状態でVS Code側から「マイクラへのアタッチ設定」を行って起動すると、ゲーム内のスクリプトの動きとエディタが同期し、ブレークポイント（コードの一時停止）や変数の中身のリアルタイムチェックが可能になります。

手順2：自作アドオンの動作負荷（処理の重さ）を検証する

/script profiler start

（しばらく重い処理やモブの大量召喚イベントなどをテストした後に）
/script profiler stop

スクリプトのプロファイラーを回し、テスト走行後にストップさせます。出力されたデータを確認することで、コード内のどのループ処理やTick毎の監視イベントが世界のラグ（Tick遅延）を引き起こしているのかをデータとして正確に把握できます。

💡 補足：関連する重要コマンド「/scriptevent」との違い

ゲーム画面にも予測表示されているように、よく似たコマンドに `/scriptevent` があります。この2つは役割が完全に異なります。
・/script：当ページで解説している、プログラム自体を「テスト・解析」するためのデバッガーツール。
・/scriptevent：マイクラの通常の「コマンドブロック」から、JavaScript（スクリプト側）に向けて、独自のカスタムIDやメッセージを送信してシステムを無理やり「トリガー（起動）」させるための連携用通信コマンド。

🛑 前提条件と注意点

※このコマンドを実行するには、ワールドの「チートの実行」がオンになっており、実行するプレイヤーが「必要権限レベル 1」以上（オペレーター権限）を持っている必要があります。
また、当然ですがワールドに「スクリプトAPI（JavaScript）を含んだビヘイビアーパック」が一切適用されていないバニラの環境では、コマンドを実行してもデバッグ対象が存在しないため作動しません。