コマンドラインチュートリアル¶
一部の開発者は、コマンドラインを広範囲に使用することを好みます。Godotは使いやすく設計されているので、ここでは完全にコマンドラインから作業するための手順を説明します。エンジンが外部ライブラリーにほとんど依存しないことを考えると、初期化時間は非常に速く、このワークフローに適しています。
コマンドライン リファレンス¶
一般的なオプション
コマンド | 説明 |
-h , --help , /? |
コマンド ライン オプションの一覧を表示します。 |
--version |
バージョン文字列を表示します。 |
-v , --verbose |
詳細な標準出力モードを使用します。 |
--quiet |
静かなモード、標準出力メッセージを出力しません。エラーは引き続き表示されます。 |
実行オプション
コマンド | 説明 |
-e , --editor |
シーンを実行する代わりにエディタを起動します(tools を有効にする必要があります)。 |
-p , --project-manager |
プロジェクトが自動検出された場合でも、プロジェクトマネージャを起動します(tools を有効にする必要があります)。 |
-q , --quit |
最初のイテレーションの後に終了します。 |
-l <locale> , --language <locale> |
特定のロケールを使用します(<locale>は2文字のコードです)。詳細については、 ロケール を参照してください。 |
--path <directory> |
プロジェクトへのパス (<directory>には 'project.godot' ファイルが含まれている必要があります)。 |
-u , --upwards |
'project.godot' ファイルのフォルダを上方向にスキャンします。 |
--main-pack <file> |
読み込むパック (.pck) ファイルへのパス。 |
--render-thread <mode> |
レンダー スレッド モード ('unsafe', 'safe', 'separate')。詳細については、 Thread Model を参照してください。 |
--remote-fs <address> |
リモート ファイルシステム (<host/IP>[:<port>] アドレス)。 |
--audio-driver <driver> |
オーディオ ドライバー。最初に --help を使用して、使用可能なドライバーの一覧を表示します。 |
--video-driver <driver> |
ビデオドライバー。最初に --help を使用して、使用可能なドライバーの一覧を表示します。 |
表示オプション
コマンド | 説明 |
-f , --fullscreen |
全画面表示モードを指定します。 |
-m , --maximized |
ウィンドウの最大化を指定します。 |
-w , --windowed |
ウィンドウ モードを指定します。 |
-t , --always-on-top |
常時最前面 ウィンドウを指定します。 |
--resolution <W>x<H> |
ウィンドウの解像度を指定します。 |
--position <X>,<Y> |
ウィンドウの位置を指定します。 |
--low-dpi |
低DPIモードを強制します (macOS および Windows のみ)。 |
--no-window |
ウィンドウの作成を無効にします (Windows のみ)。 -script と併用すると便利です。 |
デバッグオプション
注釈
デバッグ オプションは、エディタおよびデバッグ エクスポート テンプレートでのみ使用できます (これらには debug
または release_debug
ビルド ターゲットが必要です、詳細については、 ターゲット を参照してください)。
コマンド | 説明 |
-d , --debug |
デバッグ (ローカル stdout デバッガー)。 |
-b , --breakpoints |
ブレークポイントとしてソースの行番号をカンマで区切って列挙します。スペースは使えません(代わりに%%20を使用できます)。 |
--profiling |
スクリプト デバッガーでプロファイリングを有効にします。 |
--remote-debug <address> |
リモート・デバッグ (addressは<ホスト/IP>:<ポート> ). |
--debug-collisions |
シーンを実行する際にコリジョン形状を表示する。 |
--debug-navigation |
シーンを実行する際にナビゲーション・ポリゴンを表示する。 |
--frame-delay <ms> |
高CPU負荷の再現 (毎フレームごとに <ms> ミリ秒遅らせる)。 |
--time-scale <scale> |
タイムスケールの強制 (値が大きいほど早く、1.0が標準)。 |
--disable-render-loop |
レンダリングのループの無効化。スクリプトにて明示的に呼び出した時にのみレンダーする。 |
--disable-crash-handler |
プラットフォーム・コードが対応している場合もクラッシュ・ハンドラを無効にする。 |
--fixed-fps <fps> |
フレーム毎秒の固定。この設定によりリアルタイム同期は無効化。 |
--print-fps |
stdoutにフレーム毎秒を出力。 |
スタンドアロンツール
コマンド | 説明 |
-s <script> 、--script <script> |
スクリプトの実行。 |
--check-only |
エラー分析のみ行って終了(--script と同時に使用)。 |
--export <target> |
指定されたエクスポート・ターゲットに向けてプロジェクトをエクスポートする。パスが .pck あるいは .zip で終わっている場合、メインのパックのみエクスポートする (toolsを有効にする必要あり)。 |
--export-debug <target> |
--export と同じだが、デバッグ・テンプレートを使用する。(toolsを有効にする必要あり)。 |
--doctool <path> |
指定した <path> にエンジンのAPIリファレンスをXML形式で出力する。すでにファイルが存在する場合は、それに結合する。(toolsを有効にする必要あり)。 |
--no-docbase |
基本タイプのダンプをしない (--doctool と共に使用。toolsを有効にする必要あり)。 |
--build-solutions |
スクリプトのソリューションをビルドする (例えばC#プロジェクトのために。toolsを有効にする必要あり)。 |
--gdnative-generate-json-api |
GDNativeバインディング用のGodot APIのJSONダンプを生成します (tools を有効にする必要があります)。 |
--test <test> |
単体テストを実行します。最初に --help を使用して、テストの一覧を表示します。(tools を有効にする必要があります)。 |
--export-pack <preset> <path> |
Like --export , but only export the game pack for the given preset. The <path> extension determines whether it will be in PCK or ZIP format.
(tools must be enabled). |
パス¶
godot
と入力すればどこからでも簡単に実行できるように、godotバイナリをPATH環境変数に含めることをお勧めします。Linuxでは、 /usr/local/bin
にgodotバイナリを配置し、それが godot
と呼ばれていることを確認することで、これを行うことができます。
プロジェクトパスの設定¶
Godotバイナリの場所と現在の作業ディレクトリによっては、次のコマンドを正しく機能させるためにプロジェクトへのパスを設定する必要があります。
これは、プロジェクトの project.godot
ファイルへのパスを最初の引数として指定することで実現できます:
godot path_to_your_project/project.godot [other] [commands] [and] [args]
または --path
引数を使用して:
godot --path path_to_your_project [other] [commands] [and] [args]
たとえば、ゲームをエクスポートするための完全なコマンド(以下に説明する)は次のようになります:
godot --path path_to_your_project --export my_export_preset_name game.exe
プロジェクトの作成¶
コマンドラインからプロジェクトを作成するには、シェルを目的の場所に移動してproject.godotファイルを作成します。
mkdir newgame
cd newgame
touch project.godot
これで、Godotでプロジェクトを開くことができます。
エディタの実行¶
エディタを実行するには、Godotに -e
フラグを付けて実行します。これは、プロジェクトディレクトリまたはサブディレクトリ内から実行する必要があります。それ以外の場合、コマンドは無視され、プロジェクトマネージャが表示されます。
godot -e
シーンが作成および保存されている場合は、そのシーンを引数として同じコードを実行することで、後で編集できます。
godot -e scene.tscn
シーンの削除¶
Godotはあなたのファイルシステムと友達であり、追加のメタデータファイルを作成することはありません。シーンファイルを削除するには、 rm
を使用します。 そのシーンを参照するものが何もないことを確認してください。
rm scene.tscn
ゲームの実行¶
ゲームを実行するには、プロジェクトディレクトリまたはサブディレクトリ内でGodotを実行します。
godot
特定のシーンをテストする必要がある場合は、そのシーンをコマンドラインに渡します。
godot scene.tscn
デバッグ¶
コマンドラインでエラーを検出するのは非常に困難な作業です。 -d
を追加することでコマンドラインデバッガが利用できます。これは、ゲームまたは単一のシーンを実行するために機能します。
godot -d
godot -d scene.tscn
エクスポート¶
コマンドラインからプロジェクトをエクスポートすることもサポートされています。これは継続的インテグレーション設定に特に役立ちます。これには、ヘッドレスのGodotバージョン(サーバービルド、ビデオなし)が理想的です。
godot --export "Linux/X11" /var/builds/project
godot --export Android /var/builds/project.apk
--export
スイッチによって認識されるプラットフォーム名は、エディタのエクスポートウィザードに表示されるものと同じです。サポートされているプラットフォームの一覧をコマンドラインから取得するには、認識されていないプラットフォームにエクスポートすると設定がサポートしているプラットフォームの一覧が表示されます。
ゲームのデバッグバージョンをエクスポートするには、 --export
の代わりに --export-debug
スイッチを使用します。パラメータと使用方法は同じです。
To export only a PCK file, use the --export-pack
option followed by the
preset name and output path, with the file extension, instead of --export
.
The output path extension determines the package's format, either PCK or ZIP.
スクリプトの実行¶
コマンドラインから単純な .gd
スクリプトを実行することは可能です。この機能は特に、大規模プロジェクトでアセットの一括変換やカスタムのインポート / エクスポート時に便利です。
スクリプトは SceneTree
または MainLoop
から継承する必要があります。
Here is a simple sayhello.gd
example of how it works:
#!/usr/bin/env -S godot -s
extends SceneTree
func _init():
print("Hello!")
quit()
実行方法:
# Prints "Hello!" to standard output.
godot -s sayhello.gd
パスに project.godot
が存在しない場合は、現在のパスが現在の作業ディレクトリであると見なされます (-path
が指定されている場合を除く)。
The first line of sayhello.gd
above is commonly referred to as
a shebang. If the Godot binary is in your PATH
as godot
,
it allows you to run the script as follows in modern Linux
distributions, as well as macOS:
# Mark script as executable.
chmod +x sayhello.gd
# Prints "Hello!" to standard output.
./sayhello.gd
If the above doesn't work in your current version of Linux or macOS, you can always have the shebang run Godot straight from where it is located as follows:
#!/usr/bin/godot -s