このページでは、Unreal Engine GitHub リポジトリから Unreal Engine (UE) のソース コードをダウンロードして、コードを使い始めるまでの手順を詳しく説明します。
https://github.com/EpicGames/UnrealEngine にあるリポジトリにアクセスする前に、以下を実行する必要があります。
Epic Games アカウントを取得する
GitHub アカウントを作成する
「GitHub で Unreal Engine のソースコードにアクセス」の説明に従って GitHub アカウントを Epic Games アカウントに連携する
ソース コードのダウンロードは Unreal Engine での作業に必ずしも必要というわけではありません。 Unreal のバイナリ バージョンのみダウンロードおよびインストールしたい場合は、「Unreal Engine をインストールする」で Unreal Engine を取得する方法を確認してください。 ただし、ソース コードへアクセスできると、ユーザーやプロジェクトにとって非常に価値があります。 たとえば、次のようになります。
Epic のエンジニアが毎日 (実際には毎分) 行っている最新機能およびバグ修正にすべてアクセスすることができます。
Epic による修正待ちのバグがプロジェクトにとって非常に重要な場合、ソース コードを自分のバージョンにして修正を行い、自分のバイナリを再ビルドすることでプロジェクトを守ることができます。
修正や機能を Epic にサブミットすることにより、エンジンを改善し Unreal コミュニティ全体を支援することができます。
Unreal Engine ライセンシーは、公開されている GitHub リポジトリではなく Perforce サーバーからソース コードにアクセスできます。
GitHub で Unreal Engine のソース コードにアクセスする
Unreal Engine では完全な C++ のソースコードにアクセスできるため、Unreal Engine 全体の研究 / カスタマイズ / 拡張 / デバッグが可能であり、プロジェクトをスムーズに完成できます。
GitHub のソースコードのリポジトリは、メインラインで Epic が機能を開発されることに合わせて継続的に更新されます。そのため、次回の製品リリースまで待つことなく、最新のコードを入手できます。
Unreal Engine のソース コードにアクセスするには、次の手順を実行します。
GitHub に移動してアカウントを登録 (Sign Up) しましょう。
UnrealEngine.com にあなたの認証済みの Epic Games アカウントでサインインします。 ユーザー名表示の上にマウスをホバーさせて、ドロップダウン メニューから [Personal (開発者情報)] を選択し、アカウント ダッシュボードを開きます。
アカウント ダッシュボードが開いたら、サイドバーから [Connections (接続済みアカウント)] タブを選択します。 [Accounts (アカウント)] タブで、GitHub アイコンの下の [Connect (接続)] ボタンをクリックします。
Unreal Engine エンド ユーザー ライセンス (EULA) にまだ署名していない場合は、条件を読んでチェックボックスにチェックする必要があります。次に、[Link Account (アカウントを接続する)] を選択します。 アカウントを接続するボタンをクリックすると、GitHub アカウントからサインアウトしている場合、GitHub ページに転送され、サインインを求められます。
[Authorize EpicGames] ボタンをクリックして、OAuth App Authorization プロセスを完了します。 詳細については、GitHub の「OAuth アプリの承認」をご覧ください。
GitHub はあなたに GitHub の @EpicGames organization に参加するための招待メールを送信します。 メール内の Join @EpicGames ボタンを 7 日以内にクリックすることで、GitHub アカウントと Epic Games アカウントの接続プロセスが完了します。
最後に、GitHub アカウントと Epic Games アカウントの接続に成功した、という確認のメールが Epic Games からあなたのところへ送信されます。 確認メールが届かない、またはアカウントで問題があった場合は、カスタマー サービスからご連絡ください。 これで Epic Games の GitHub ページ (ログインが必要) からフル ソース コードをダウンロードできるようになりました。
ソース コードのブランチ
UE のソース コードはいくつかのブランチで発行されていることが分かります。
名前に dev、staging、test が含まれているブランチは、通常、内部 Epic プロセス用であり、エンドユーザーにはほとんど役立ちません。新しいリリースやホットフィックスが安定すると、他の短期間のブランチがポップアップすることがあります。
リリース ブランチ
リリース ブランチは、現在の公式リリースを反映します。 弊社 QA チームが十分なテストを行っており、ここから Unreal Engine の学習やプロジェクト作成を開始すると良いと思います。 弊社はリリースの安定性と信頼性を高めるために懸命に取り組んでおり、数か月ごとに新しいリリースの公開を目指しています。
メイン ブランチ
UE のアクティブな開発のほとんどは ue5-main ブランチで行われます。 このブランチには、エンジンの最新リリースが反映されるため、バグがあったりコンパイルされていない場合があります。 このブランチは、新機能のテストやロックステップ開発に積極的なデベロッパーが利用できるようにしています。
このブランチで作業する場合は、現在の公式リリースと次のリリースのブランチよりも進んでいる可能性があることに注意してください。 したがって、ue5-main ブランチで動作するように作成したコンテンツとコードは、将来の公式リリース向けに ue5-main から直接新しいブランチを作成するまでの間、公式リリースとの互換性がない可能性があります。
「Visual Studio をセットアップする」を参照し、Unreal Engine の希望のバージョンとの互換性があるバージョンの Visual Studio がインストール済みであることを確認します。
GitHub for Windows をインストールしてから、Epic Games のリポジトリをフォークして、クローンします。
コマンド ラインから Git を使用するには、「Git のセットアップ」記事と「リポジトリをフォークする」記事を参照してください。
Git を使用しない場合は、右側の [Download ZIP] ボタンを使ってソースを取得してください。 ビルトインされている Windows zip ユーティリティがインターネットからダウンロードされた zip ファイルのコンテンツの実行を安全でないとマーク付けするので、解凍前にこの zip ファイルを右クリックして [Properties...] および [Unblock] を選択します。 サードパーティ zip ユーティリティではこの作業は通常行われません。
Visual Studio をインストールします。
Visual Studio のすべてのデスクトップ エディションは、Visual Studio Community を含めて UE をビルドします。小規模チームおよびインディー デベロッパーは、Visual Studio Community を無料で利用できます。 「Visual Studio を設定する」を参照して、UE で作業するために必要な VS コンポーネントをすべて確実にダウンロードしてください。
エクスプローラでソース フォルダを開き
Setup.batを実行します。これにより、エンジン用バイナリ コンテンツのダウンロード、前提条件のインストール、Unreal Engine ファイルの関連付けの設定が実行されます。 Windows では SmartScreen からの警告が表示される場合があります。 続行するには、[More info]、[Run anyway] の順にクリックします。
エンジン バイナリの一からのダウンロードには、時間がかかる場合があります。 その後のチェックアウトは増分のみのダウンロードであるため、ダウンロードにかかる時間がかなり短縮されます。
GenerateProjectFiles.batを実行してエンジン用のプロジェクト ファイルを作成します。 1 分未満で完了します。「
UE5.sln」ファイルをダブルクリックして、プロジェクトを Visual Studio にロードします。 ソリューション コンフィギュレーションを [Development Editor]、ソリューション プラットフォームを [Win64] にそれぞれ設定し、UE ターゲットを右クリックして [Build] を選択します。 システム仕様によっては、コンパイル完了に 10 ～ 40 分程度かかることがあります。コンパイルが完了したら、スタートアップ プロジェクトを [UE5] に設定し、F5 を押してデバッグし、Visual Studio からエディタをロードします。
この このページでは、ライセンシーが GitHub 上のソース コード リポジトリから Unreal Engine をダウンロードおよび ビルドする方法を説明します。 Unreal Engine のバイナリ バージョンを ダウンロードしたい場合は、「Unreal Engine をインストールする」で Unreal Engine を取得する方法を確認してください。
追加のターゲット プラットフォーム
Android サポートは、Android NDK がインストールされている場合、セットアップ スクリプトによってダウンロードされます。 「Android クイックスタート ガイド」を参照してください。
iOS 開発には Mac が必要です。 手順については、「iOS クイックスタート ガイド」を参照してください。
デベロップメント コンソールや、Sony PlayStation、Microsoft Xbox、Nintendo Switch など、 アクセス制限のあるその他のプラットフォームの開発の場合は、 これらのサードパーティ ベンダーに登録済みのデベロッパー アカウントを持っている場合にのみ可能です。
プラットフォームによっては、 追加のドキュメントやガイダンスが Epic Pro Support サイトで 提供されている可能性や、 そのプラットフォーム専用の Unreal Engine フォーラム セクションでダウンロード可能なアーカイブとして入手できる可能性があります。
新規 これらのリソースにアクセスできない場合は、 まず、デベロッパー アカウントをサードパーティ ベンダーに登録してください。 その後、担当の Epic Games アカウント マネージャーに 問い合わせます。または、担当マネージャーがいない場合は、Unreal Engine のコンソール開発リクエスト フォームに記入して ご提出ください。 Epic から正式な契約書への デジタル署名を求める連絡があります。 これが承認されると、 そのプラットフォームのソース コード、バイナリ、 追加指示にアクセスする方法の説明が提供されます。
ライセンス契約と貢献
GitHub 上の Unreal Engine へのアクセス、使用は、Unreal Engine エンド ユーザー ライセンス契約によって規定されます。 随時修正される、EULA の条件に従わない場合は、Unreal Engine へのアクセスや使用は許可されません。
GitHub のプル リクエストを用いた Unreal Engine の開発に対する貢献を歓迎します。 Epic Games の進行中の開発のほとんどは、Master ブランチにあります。
そのため、そこからプル リクエストを行ってください (特に
新機能の場合)。 すべての新規コードは、
次のステップ
Unreal Engine のダウンロードとセットアップが終了しました。次は、ソースからエンジンをビルドします。
脚注
新しいソース ビルドから初めてエディタを起動すると、ロードに時間がかかる場合があります。 Unreal Engine は使用するプラットフォームのコンテンツを「派生データ キャッシュ」に最適化します。これは 1 回だけ行われます。
Unreal Engine のコードのプライベートのフォークは、GitHub アカウントの許可に関連付いています。 サブスクライブの解除または GitHub のユーザー名を切り替える場合は、再度フォークし、ローカル コピーから変更をアップロードする必要があります。