スクリプト編集機

*このコンテンツは、ベータ版のAI(人工知能)を使用して翻訳されており、エラーが含まれている可能性があります。このページを英語で表示するには、 こちら をクリックしてください。

Studio の スクリプトエディタ は、RRoblox(ロブロックス)blox でのスクリプト作成の主なツールです。高インパクトなコードを書き、開発時間を短縮し、経験を反復するのに役立つ自己改善環境です。スクリプトエクスペリエンスを改善することができます:

  • コードで構文の形式化と強調表示。
  • コードを入力するときに、自動完了 フレーズを提供する方法
  • 変数と機能宣言にジャンプしてコードをナビゲートするのを助けるnavigate code
  • 開いたスクリプトまたはすべてのスクリプトでコードを見つけて置換するのを助けます find and replace コード。
  • コード品質とパフォーマンスにリアルタイムフィードバックを提供する。

スクリプトエディタは、すべての種類の スクリプト をサポートし、新しいスクリプトを作成するか、エクスプローラ ウィンドウで既存のスクリプトをダブルクリックすると自動的に開きます。

自動完了機能

スクリプトエディタの自動完了機能は、次のようなプログラミング効率を向上させるコード関連情報を生成します:

  • 情報付きの提案 は、エクスペリエンスの データモデル に関連するフレーズを入力する方法について、どのように完了するか。たとえば、 に RocketShip と呼ばれる がある場合、自動完了は を入力するときに を示し、それが であることを示します。

    Autocomplete showing suggestions based on the experience's data model
  • 自動で名前を満たす 変数と機能の名前を宣言し、煩わしいタイプミスを避けるのを助けます。

    Autocomplete showing suggestions based on a previously declared variable.
  • コードサンプル付きドキュメントポップアップ は、エンジン API 参照 と似ており、API の使用に関するコンテキストを提供します。

    Autocomplete showing suggestions based on a Roblox Engine API.
  • ホバーツールチップ をカスタマイズできる独自の定義済みドキュメント。

    Autocomplete showing custom documentation.
  • オンホバリングスクリプト分析診断 に、エラーを解決するために使用できる情報があります。

    Autocomplete showing diagnostic information.
  • 機能の署名 引数と返却値の参照を提供するときにアルゴリズムを入力すると、機能のパラメータと返却値が参照されます。

    Autocomplete showing function signature

コードナビゲーション

宣言に移動

呼び出しをクリックすると、Windows で Ctrl または Mac で を押して、機能または変数の宣言にジャンプできます。または、呼び出しを右クリックし、 宣言に移動 をクリックします。

Go to Declaration workflow on a declared function

スクリプト機能フィル並べ替え

スクリプト機能フィルタ は、スクリプトで宣言されたすべての機能のリストを表示します。開くには、Windows では Alt F 、Mac では F を押します。リストが開いていると、各機能の署名をブラウズし、名前でフィルタリングし、1つをダブルクリックして宣言にジャンプできます。

Script Function Filter showing all functions inside a script

見つけて置換

検索/置換 ウィジェットでは、オープンスクリプトでコードを見つけて置換できます。ウィジェットは一致するケース、全ワードの一致、および正規表現による検索をサポートします。開くには、Windows では Ctrl F 、Mac では F を押します。

Find/Replace widget labeled

リアルタイムフィードバック

スクリプト分析

[ビュー] タブからアクセス可能な スクリプト分析 ウィンドウは、スクリプトに静的分析を実行し、アクティブなエラーと警告を表示します。エラーと警告に関する詳細は、Luau linting ドキュメントを参照してください。

Script with various marked errors
スクリプトエディタで強調されたスクリプトエラー
Script Analysis window with details on marked errors from script
スクリプト分析ウィンドウで説明されるエラー

出力

出力 ウィンドウは、ビュー タブからアクセス可能で、スクリプトの実行中にキャプチャされたエラー、Roblox エンジンからのメッセージ、print() への呼び出しからのエラー、および warn() への呼び出しからのエラーを表示します。ワークフロー用に構成する方法の詳細は、出力 を参照してください。

コードアシスト

コードアシスト は、タイプするとコードの行や機能を提案する機能で、コードをより効率的に書き、集中して取り組むのを助けます。コメントとコードのコンテキストに基づいて、提案は 2 つの方法でトリガーされます:

  • 自動 線を数秒間停止し、AI モデルに十分なコンテキストがあるとき、いくつかの提案が行われます。
  • 手動 にショートカット を使用して Windows または Mac 上で (このショートカットを カスタマイズ できます)。

プレス Tab を押して、提案を承認するか、タイプを続けて無視します。現在、スクリプトには、提案をトリガーするために少なくともいくつかのコード行が含まれている必要があります。

提案を改善

より正確で関連性の高い提案を得るには、アシストに関係なく、クリーンなコーディングプラクティスに従うことをお勧めし、そして:

  • コードをより小さな機能に分解する。
  • 各スクリプトの全体の意図を捉える説明的なスクリプト名を使用する。たとえば、スクリプトの名前を SyncCustomSounds ではなく Sounds として指定します。
  • パラメータ、機能、スクリプトに説明的な名前を割り当てる。たとえば、パーツの名前を グリーンスフィア ではなく、単に grs と呼ぶか、機能の名前を generateSphere() ではなく gen() と呼ぶ。名前付き関数と無名の関数の使用は、ヒントをより良く生成することもできます。
  • 実装しているタスクと、入力/出力が何であるべきかを説明する、うまく書かれた コメント を一貫して含める
    • コメントに予想される結果を含むサンプルコールを含めることを検討してください。
    • 問題を解決する方法を提案してください、例えば -- Use raycast
    • 例えば、-- Create 10 greenSphere objects ではなく -- Create 10 spheres のように、定義した正確な機能または変数名を使用します。
  • 初心者スクリプターの場合、「プレイヤーがパーツに触れるとジャンプする」などの基本的なプロジェクトから始めるか、ツールを使用して、知識が増えるにつれて拡大できる小さなコードスニップを生成します。

制限

ツールは基本的なコーディングタスクの自動化を助けますが、完全なコードを常に提案するわけではありません。既知の制限には以下があります:

  • 手動トリガーは、常に 提案を強制生成する ことはありません。
  • 提案はコードのコーパスからマシン学習され、それゆえトレーニングされたコードのいくつかの制限を反映することができます。たとえば、提案は新しい API を古い API のために使用しないかもしれません、または Luau の代わりに Lua を使用するかもしれません。
  • ツールは、目的には役に立たない不正確な情報や誤導情報を生成する可能性があります。
  • 内部フィルタは攻撃的な言語をブロックしようとしますが、包括的ではなく、ツールが攻撃的または偏向的な情報を生成する可能性があります。
  • 提案は、同じ、似ている、または異なるものがユーザー間である可能性がありますが、同じプロンプトでもあります。しかし、コードは決して他の人と共有されません。
  • 学習モデルからの出力の長さが限られているため、提案が不完全になる可能性があります。
  • 提案数には毎日の制限があり、制限に達すると、翌日まで提案が得られなくなります。

コードのプライバシー

現在、Roblox は学習モデルを訓練するために非公開データを使用していません。ツールは、大きな言語モデルの調整にのみ、無料のマーケットプレイス資産の小さなサブセットのみを使用し、サブセットは品質と安全性のフィルターの各種チェックに合格しました。

さらに、すべての提案は AI モデル によって 生成され、1人のユーザーから別のユーザーに移行しません。コードがモデルトレーニングに使用されていないため、 コードアシスト の他のユーザーには、コードが無料のマーケットプレイスアイテムに投稿される一例を除いて、提案はされません。

マルチカーソル

スクリプトエディタは、複数のカーソルを使用して同時に編集を行うことをサポートします。マウスクリックまたはキーボードショートカットで、必要に応じてカーソルを追加できます。初期のカーソルは 基本カーソル と呼ばれ、追加のカーソルは セカンダリカーソル と呼ばれます。

  • プライマリーカーソルからセカンダリーカーソルに作る編集。それぞれの編集は 1操作のアクションとしてカウントされるので、編集の取り消し/やり直しはすべてのカーソルに適用されます。
  • 自動完了 などのウィジェットは、メインのカーソルに表示されますが、セカンダリカーソルには表示されません。
  • スクリプト編集ワークに使用される標準の キーボードショートカット は、コードのインデント、コメントの切り替え、行の削除を含むマルチカーソル編集で機能します。

次の表では、マルチカーソルワークフローとそのショートカットを概要にします。

コマンドウィンドウマック
マウスの位置でカーソルを追加/削除 Alt クリック クリック
最も最近追加されたカーソルを削除 Ctrl U U
マウスドラッグでカーソルを追加/変更 Alt ドラッグ+ ドラッグ+
上下にカーソルを追加 Ctrl Alt  / Ctrl Alt  /
次の一致する選択にカーソルを追加 Ctrl D D
一致する選択肢すべてにカーソルを追加 Shift Alt LShift L
列/ブロックの選択 Shift Alt  + ドラッグShift  + ドラッグ
選択を行に分割する Shift Alt IShift I

カーソルを追加

キーボードショートカットとマウス操作の組み合わせでカーソルを追加できます。カーソルが同じスペースを占有する場合、例えば矢印キーのカーソルを追加したり、カーソル間のすべての文字を削除したりすると、カーソルがマージされます。

マウスの位置で

マウスポインタの場所にカーソルを追加するには:

  1. Windows では Alt 、Mac では を保持します。

  2. カーソルを追加したい場所をクリックします。

マウスドラッグで

マウスをドラッグして選択にカーソルを追加したり、マルチラインの選択をラインに分割したり、コードの列とブロックを選択したり、白いスペースを選択したりできます。

ドラッグでコードの選択にカーソルを追加するには:

  1. Windows では Alt 、Mac では を保持します。

  2. クリックしてマウスをドラッグしてコードの選択に移動します。

上下のプライマリカーソル

プライマリーカーソルの上または下に直接カーソルを追加するには:

  1. Windows では Ctrl Alt 、Mac では を押し続けます。

  2. Press the または arrows.

選択と一致するには

選択のすべてのマッチや次の/前のマッチにカーソルを追加し、オプションでマッチが大文字と小文字で区別されるかどうか、または全文を一致させるかどうかを切り替えることができます。

選択した部分のすべての一致をカーソルに追加するには:

  1. 検索する一致するコードを選択します。

  2. Windows では Shift Alt L 、Mac では Shift L を押します。

カーソルを削除

次のキーボードショートカットとマウス操作で、カーソルを削除できます。代わりに、Esc を押してマルチカーソル編集を終了できます。

マウスの位置で

カーソルを削除するには:

  1. Windows では Alt 、Mac では を押し続けます。

  2. 削除したいカーソルをクリックします。

最も最近追加された

最も最近追加されたカーソルを削除するには、Windows では Ctrl U 、Mac では U を押します。

カーソルをコピーして貼り付ける

コードの選択をコピーすると、その中のカーソルも含まれます。貼り付けの動作は、ソースのカーソル数と目的地のカーソル数に依存します:

  • カーソルの数が同じなら、それぞれのコピーカーソルは対応するデスティネーションカーソルに貼り付けられます。
  • カーソルの数が異なる場合、目的地の各カーソルは、コピーされたすべてのカーソルを新しい行として受け取ります。

オンタイプ形式化

Enter/Return を押すと、以前の行に対して新しい行でカーソルが自動的に改行されます。前の行が不完全なブロックで始まっている場合、フォーマッターはそれを完了しようとします。

エディタ設定

多くのカスタマイズオプションは、 ファイル > スタジオ設定 (AltS Windows 上; S Mac 上) を介してアクセス可能です。

A close up view of the Studio Settings window with the Script Editor tab selected.

一般的に変更されるオプションには以下が含まれます:

オプション説明
フォント エディタ内のコードのフォント面とサイズ。
タブ幅 Tab インデントを表すスペースの数。
スペースを使って引き出す 有効にすると、 タブ幅 と同じスペースが挿入され、Tab を押すと挿入されます。
テキスト包装 有効にすると、長いコードラインが次の行に包まれます。
スクリプトエディタカラープリセット コード要素、選択色などのカラープリセットプリセットを選択した後、 選択色コメント色 などのオプションに特定の色を設定できます。

キーボードショートカット

スクリプトエディタには次のキーボードショートカットがあります。スクリプトを表示または編集するたびに Studio ツールバーに表示される スクリプト タブからも多くのコマンドにアクセスできます。

コマンドウィンドウマック
スクリプトを閉じる Ctrl W W
最後に閉じたスクリプトを再開 Ctrl Shift T Shift T
クイックオープン Ctrl P P
エクスプローラでスクリプトを表示 Ctrl Alt K K
拡大する Ctrl = =
縮小する Ctrl - -
スクリプトズームをリセット Ctrl 0 0