Godot でゲームのプロジェクトを作っていると、そのうちゲームの規模がある程度大きくなった時に、ファイルシステムドックですぐに編集したいシーンが見つからなかったり、さっき修正しようと思っていたスクリプトがどこに行ったかわからなくなったりすることがあるかもしれない。

今回は Godot エディタに備わっているキーボードショートカットでの便利な検索機能を紹介する。これらを知っているだけで「見つからない何かを探す」という、おそらく最も楽しくない時間を激減させることができるだろう。なんなら、ファイルシステムやスクリプトエディタで直接ファイルにカーソルを合わせてクリックして選択していた手順を、毎回検索する手順に切り替えてしまっても良いだろう。

ちなみにショートカット集は公式オンラインドキュメントにまとまっているのでショートカットに興味がある方はそちらもご参照いただきたい。ちなみに、macOS の Option キーを Alt と記載しているのを確認したので注意してほしい。

公式オンラインドキュメント
デフォルトのエディタ用ショートカット

とにかく作業効率アップ間違いなしなので、この記事を見たあとからさっそく使ってみてほしい。では具体的に検索範囲が広い機能から順番に紹介していく。



クイックオープン

「クイックオープン」を使用するには、Godot エディタ上で以下のキーボードショートカット操作を行う。ただし、スクリプトエディタ上では使用できないので 2D または 3D ワークスペースに切り替える必要がある。

Windows: Shift + Alt + O
macOS: Shift + Option + O

QuickOpen

大量のアセットのファイルをインポートしている状況では綺麗にフォルダ分けしていたとしても、一つひとつファイル名まで覚えていられない。そこで便利なのが「クイックオープン」での検索だ。

この「クイックオープン」は全てのファイルが検索対象だ。だからインポートしたサウンドファイルもテクスチャファイルもフォントファイルもシーンファイルもスクリプトファイルも拡張子で検索したり、ファイル名の一部や保存されているフォルダで検索すれば、簡単に見つけることができるだろう。また、そもそもファイルシステムドックからディレクトリをたどっていくのが面倒な場合も検索すれば一発でファイルを開くことができる。



シーンのクイックオープン

「シーンのクイックオープン」を使用するには、Godot エディタ上で以下のキーボードショートカット操作を行う。

Windows: Ctrl + Shift + O
macOS: Cmd + Shift + O

QuickOpenScene

先に紹介した「クイックオープン」と似たようなこの「シーンのクイックオープン」は、検索対象がシーンファイルのみになる。特定のシーンを開きたい時に便利だ。操作画面もほとんど「クイックオープン」と同じだ。



スクリプトのクイックオープン

「スクリプトのクイックオープン」を使用するには、Godot エディタ上で以下のキーボードショートカット操作を行う。

Windows: Ctrl + Alt + O
macOS: Cmd + Option + O

QuickOpenScript

こちらの「スクリプトのクイックオープン」も先に紹介した「クイックオープン」と似た機能だが、検索対象がスクリプトファイルに限定される。特定のスクリプトを開きたい時に便利だ。操作画面もほとんど「クイックオープン」と同じだ。

スクリプトファイルが増えてくるとスクリプトエディタの左サイドバーからは見つけにくい。おまけに、公式ドキュメントをスクリプトエディタで開いたままにしていると余計にアイテム数が増えていく。アルファベット順で表示されるとはいえ、目視ではかなり辛い。この「スクリプトのクイックオープン」をぜひ使いこなしていきたいところだ。



複数ファイル内を検索

「複数ファイル内を検索」するには、Godot エディタ上で「スクリプトエディタ」を開き、以下のキーボードショートカット操作を行う。

Windows: Ctrl + Shift + F
macOS: Cmd + Shift + F

複数ファイル内を検索

こちらはスクリプトエディタ上での検索機能だ。複数のスクリプトフォイルからキーワードを含むファイルを検索できる。エディタ下部の検索結果パネル上にキーワードにヒットした項目が表示され、それをクリックすれば、スクリプトエディタが該当の箇所を含むスクリプトを表示してくれる。

特定のフォルダに保存されているファイルに限定して検索したい場合は、フォルダのパスを指定してあげれば、さらに絞り込むことができる。
複数ファイル内を検索時にフォルダを指定


また、すでに複数のスクリプトの中にたくさん記述してしまっている変数(プロパティ)や関数(メソッド)の名前を変えたい時には全部まとめて置換することができる。まずは検索キーワードを入れて、置換ボタンをクリックする。
複数ファイル内を検索時にフォルダを指定

その後、検索結果パネル上で以下の手順を進める。

  1. 置換する対象にチェックを入れる。
  2. 置換後の文字列を入力する。
  3. 全て置換ボタンをクリックする。

複数ファイル内を検索時に置換



ファイル内を検索

「ファイル内を検索」するには、Godot エディタの「スクリプトエディタ」で特定のスクリプトファイルを開き、以下のキーボードショートカット操作を行う。

Windows: Ctrl + F
macOS: Cmd + F

ファイル内を検索

こちらはスクリプト単体を対象とした検索だ。こちらはシンプルに特定の変数や関数の名前、コメントの内容などを探すときに便利だ。コードが長くなってくると、スクロールしながら目視で該当の箇所を見つけるのが大変になってくる。場所は大体わかっていたとしても検索してしまった方が早いこともあるので、うまく利用したい。



ファイル内を検索して置換

「ファイル内を検索して置換」を行うには、Godot エディタの「スクリプトエディタ」で特定のスクリプトファイルを開き、以下のキーボードショートカット操作を行う。

Windows: Ctrl + Alt + F
macOS: Cmd + Option + F

ファイル内を検索して置換

先の「ファイル内を検索」のショートカットのキーコンビネーションを少し変えれば、スクリプトの中で文字の置換をすることができる。そのスクリプトでしか使用しないプロパティの名前を変えるときなど便利だ。



おわりに

今回は Godot エディタの便利な検索機能について紹介した。ショートカットの操作はどれも最初は慣れが必要だが、一度手がキーコンビネーションを覚えてしまえば、高速で作業できるようになるだろう。ぜひ積極的に使っていこう。


UPDATE
2022/05/29 「ブログ」から「チュートリアル」に移行