5.

UE5のプロジェクトとは|.uprojectとフォルダ構成・設定の基本

編集

Unreal Engine 5(以下、UE5)におけるプロジェクトとは、ゲームやアプリ1つ分のアセット・設定・コードをまとめた単位です。レベルやマテリアル、ブループリント、入力設定、ソースコードといった制作物のすべてが1つのプロジェクトフォルダの中に収められ、UE5で何かを作り始めるときは、まずこのプロジェクトを作成することから始まります。プロジェクトの中心には拡張子 .uproject を持つファイルがあり、エディタはこのファイルを開くことで対象のプロジェクトを読み込みます。

この記事の要点
  • プロジェクトは、1本のゲーム/アプリを構成するアセット・設定・コードをまとめた作業単位です。
  • 中心となる .uproject ファイルと、Content(アセット)・Config(設定)・Source(C++コード)などのフォルダで構成されます。
  • 新規作成時にテンプレートを選び、ブループリント中心とするかC++を含めるかを選択します。
  • 細かな挙動は Project Settings(プロジェクト設定) から調整でき、その内容は主に Config フォルダに保存されます。
  • 使用したエンジンのバージョン管理や、プロジェクトの移行・容量に注意すると、後々のトラブルを避けやすくなります。

プロジェクトとは

プロジェクトは、1つの作品(ゲームやアプリケーション)を作るために必要な要素を1か所に集めたコンテナです。プロジェクトを作成すると、専用のフォルダがディスク上に生成され、その中にアセットや設定ファイルが整理されて配置されます。複数の作品を並行して開発する場合は、それぞれ別のプロジェクトとして管理するのが基本です。

プロジェクトフォルダの中心にあるのが .uproject ファイルです。これはテキスト(JSON形式)で記述された小さなファイルで、対象のエンジンバージョンや、有効化しているプラグイン、含まれるコードモジュールなどの情報を保持します。エディタやランチャーは、この .uproject ファイルをダブルクリックすることでプロジェクトを開きます。

主要なファイルとフォルダ

プロジェクトフォルダは、いくつかの決まったファイルとサブフォルダで構成されています。代表的なものを以下にまとめます。フォルダによっては、エディタの操作やビルドの結果として自動生成されるものもあります。

名前種別役割
.uprojectファイルプロジェクトの入口。エンジンバージョン・有効なプラグイン・コードモジュールなどの情報を持ち、エディタはこれを開いて読み込みます。
Contentフォルダレベル、マテリアル、テクスチャ、メッシュ、ブループリントなど、エディタで扱うアセットが格納される中心的なフォルダです。
Configフォルダ入力やエンジン挙動などの設定を記述した .ini 形式のファイルが置かれます。Project Settings の多くはここへ保存されます。
SourceフォルダC++のソースコードを置く場所です。C++を含むプロジェクトで作成され、ブループリントのみの構成では存在しないことがあります。
Pluginsフォルダそのプロジェクト専用に追加したプラグインを置く場所です。配置されたプラグインはエディタ起動時に検出され、読み込まれます。
Saved / Intermediate / Binariesフォルダログ・自動保存・一時ファイル・ビルド成果物などが入る自動生成フォルダです。多くはバージョン管理の対象から外して扱われます。

上記のうち、自分で直接編集・整理することが多いのは ContentSource、設定を確認したいときの Config です。Saved や Intermediate、Binaries は再生成が可能なため、バックアップや共有の際には含めなくてよい場合が一般的です。

プロジェクトの新規作成

新しいプロジェクトは、Epic Games ランチャーや起動直後に表示されるプロジェクトブラウザから作成します。大まかな流れは次のとおりです。具体的な画面構成はエンジンのバージョンによって異なる場合があるため、詳細は使用中のバージョンの表示に従ってください。

  • 用途に近いテンプレート(カテゴリ)を選びます。ゲーム向けには、一人称視点(First Person)、三人称視点(Third Person)、トップダウン(Top Down)、空のプロジェクト(Blank)などが用意されています。
  • プロジェクトの種類として、ブループリント中心か、C++を含む構成かを選択します。
  • ターゲットとなるプラットフォームや品質、初期コンテンツの有無といった初期設定を必要に応じて指定します。
  • プロジェクト名と保存先を決め、作成を実行します。

ブループリント中心とC++を含む構成

作成時の「種類」の選択は、初期状態でC++のソースコード(Sourceフォルダ)を含めるかどうかに関係します。ブループリントはノードをつないでロジックを組む視覚的な仕組みで、コードを書かずに動作を作れるためプロトタイピングに向きます。C++は処理速度や低レベルなカスタマイズの面で有利で、エンジンの一部機能はC++から扱う前提のものもあります。

なお、これは排他的な選択ではありません。ブループリントのみで作り始めたプロジェクトに後からC++を追加することもでき、Epic は両者を組み合わせて使うことを推奨しています。最初の選択に迷う場合は、まずブループリントで始め、必要になった時点でC++を加えるという進め方も可能です。

プロジェクト設定(Project Settings)

プロジェクト全体の挙動は、エディタの Project Settings(プロジェクト設定) からまとめて調整できます。ここでは、プロジェクト名やバージョンといった基本情報のほか、入力(キー割り当て)、レンダリング、起動時に読み込むマップ(デフォルトマップ)、対応プラットフォームごとの設定などを変更できます。

これらの設定は、おもに Config フォルダ内の .ini ファイルへ保存されます。そのため、Project Settings での変更は最終的にテキストファイルとして記録され、バージョン管理ツールで差分を追跡することも可能です。エンジン全体に関わる設定(Editor Preferences)とは別物である点に注意してください。Project Settings はそのプロジェクトに固有の設定を扱います。

関連する操作・テクニック

プロジェクトを扱ううえで役立つ、より具体的なトピックを個別に解説しています。目的に応じて参照してください。

落とし穴・注意点

注意点内容
エンジンバージョンの取り扱いプロジェクトは作成時のエンジンバージョンに紐づきます。新しいバージョンで開くとプロジェクトが変換され、元のバージョンでは開けなくなる場合があります。バージョンを上げる前にバックアップを取ることが推奨されます。
移行・共有時のフォルダプロジェクトをコピーや共有する際、Saved・Intermediate・Binaries などの自動生成フォルダは再生成できるため、含めなくてよい場合が多いです。一方で .uproject・Content・Config・Source は基本的に必要です。
容量の肥大化高解像度テクスチャや一時キャッシュにより、プロジェクトの容量は時間とともに増えがちです。不要アセットの整理や、自動生成キャッシュの扱いに気を配ると、容量と取り回しを管理しやすくなります。

よくある質問(FAQ)

Q. .uproject ファイルを直接削除してもよいですか?
A. .uproject はプロジェクトを開くための入口となるファイルです。これだけを削除するとエディタからプロジェクトを開けなくなります。プロジェクト自体を整理したい場合は、フォルダ全体を対象に扱うのが基本です。手順はプロジェクトの削除方法を参照してください。

Q. ブループリントで作り始めましたが、後からC++を追加できますか?
A. 可能です。後からC++のクラスを追加すると、必要に応じて Source フォルダなどが生成されます。ブループリントとC++は併用が前提として設計されており、用途に応じて使い分けたり組み合わせたりできます。

Q. Project Settings で変更した内容はどこに保存されますか?
A. 多くは Config フォルダ内の .ini 形式のファイルに保存されます。そのため設定変更はテキストとして記録され、バージョン管理ツールで差分を確認することもできます。

編集
Post Share
子ページ
  1. プロジェクトの削除方法
  2. Blueprintでプロジェクト全体で共有できるStatic定数の定義方法
  3. プロジェクトを多言語化する方法
同階層のページ
  1. ノード・コンポーネント・関数・クラス一覧
  2. Tips
  3. エラー一覧
  4. ブループリント (Blueprint)
  5. プロジェクト (Project)
  6. レベル (Level)
  7. ウィジェット (Widget)
  8. データテーブル (DataTable)
  9. アセット
  10. アウトライナー
  11. ビュー
  12. レイヤー
  13. レイアウト
  14. ビルド
  15. ライティング
  16. ジオメトリ
  17. アクタ
  18. トランスフォーム
  19. スナップ
  20. ピボット
  21. コンテンツドロワー
  22. コンポーネント
  23. メッシュ
  24. マテリアル
  25. World Composition
  26. World Partition
  27. Unreal Insights
  28. セーブ&ロード

最近更新/作成されたページ