ブループリント クイックスタートガイド

ブループリントを作成して使用する方法を説明します。

このクイックスタートガイドでは、さまざまなコンポーネントを使ってレベル内にアクタを作成します。キャラクターがレベル内で飛行できるように、起動ビヘイビアの追加が可能な Blueprint クラスへの変換方法を説明します。Blueprint クラスへ変換することで、コンテンツ ブラウザ からレベルへのドラッグのみで数多くのジャンプ台 (Launchpad) を作成することでできるようになります。

1 - 必要なプロジェクト設定

  1. Unreal Project ブラウザの [New Project] タブから、以下の設定で Games カテゴリから プロジェクトを新規作成 します。

    • サイドスクローラー

    • ブループリント

    • スターターコンテンツを有効

  2. スケーラビリティと品質は最適なものを設定できます。

    どの設定にすれば良いか分からない場合は、「プロジェクト設定」セクションを参照してください。

  3. プロジェクトに名前を付けたら、[Create Project (プロジェクトを作成)] ボタンをクリックして作成します。

表示されたサイド スクローラ レベルの追加を開始する準備ができました。

BPQS_1_FinalResult.png

2 - ジャンプ台を構成する

レベル エディタでジャンプ台 (Launchpad) をビルドして、ゲームプレイ ビヘイビアを追加するためにその後 Blueprint クラスに変換します。

  1. まず、レベルの一番上のプラットフォームが見えるまで、ビューポートを移動します。

    TopPlatforms.png

    Empty Actor (空のアクタ) を使用して、ジャンプ台の要素すべてを保持するコンテナを作成します。必要な 2 つのパート (またはコンポーネント) は、ジャンプ台を表現するための形状とキャラクターがオーバーラップした時のトリガーです。

  2. メイン ツールバーで [Modes] ボタンを押し、ドロップダウン メニューで [Select] をクリックして [Place Actors] パネルを表示します。

  3. [Place Actors] パネルで [Basic] をクリックして Empty Actor を探します。

    EmptyActor.png

  4. アクタをレベルへドラッグして、表示されているプラットフォームのどれかに配置します。

    BPQS_2_Step3.png

  5. レベルでアクタを選択すると、アクタのプロパティが [Details (詳細)] パネルに表示されます。[Details (詳細)] パネルの一番上でアクタの名前を変更することができます。ボックス内をクリックして、「ジャンプ台」など名前を付けてください。

    NameLaunchpad.png

  6. [Components] パネルで、 [Add Component (コンポーネントを追加)] ボタンをクリックして [Common] の中から [Cube] を選択します。

    BPQS_2_Step5.png

  7. 新しく追加した キューブ を DefaultSceneRoot にドラッグして キューブ を新しいルートにします。

    BPQS_2_Step6.png

  8. Cube コンポーネントを選択して [Scale (スケール)] を (X:1.0, Y:1.0, Z:0.1) に設定します。

    BPQS_2_Step7.png

  9. ここで、何かとオーバーラップすると必ずイベントを発行するBox Collision コンポーネントを追加します。[Details] パネルで、 [Add Component (コンポーネントを追加)] ボタンをクリックして ([Collision] から) [Box Collision] を選択します。

    BPQS_2_Step8.png

  10. [Box Collision (ボックス コリジョン)] [Scale (スケール)] を ( X:1.25, Y:1.25, Z:9.75)、[Location (位置)] を ( X:0, Y:0, Z:200) に変更して、ボックスがジャンプ台全体とその先へ延びるようにします。

    BPQS_2_Step9.png

例えば、ジャンプ台全体を拡張するなどアクタのプロパティを変更する時は、[Details (詳細)] パネルの [Add Components (コンポーネントを追加)] ボタンの下の [LaunchPad (Instance)] をクリックします。

設定通りにアクタを作成したので、これをブループリント クラスに変換します。ブループリントエディタ 内でコンポーネントをさらに追加して、これまでと同じ操作でレベルのコンポーネントを調整できます。

3 - アクタを Blueprint クラスへ変換する

ブループリント内部に変更を加えるということは、新規 Launchpad (ジャンプ台) を作成するたびに、ユーザーが ブループリント エディタ で作成したルック アンド フィールが設定されることを意味します。レベルの周囲に LaunchPad アクタを複製した場合、特定のジャンプ台に加えた変更はそのコピーのみに影響します。

  1. [Details (詳細)] パネルで [Blueprint/Add Script (ブループリント/スクリプトを追加)] ボタンをクリックします。

    BPButton.png

  2. [Create Blueprint from Selection] ダイアログ ボックスが表示されます。ブループリントのデフォルト パスを編集していきます。

    CreateBPFromSelection.png

  3. パスを Game/SideScrollerBP から Game/SideScrollerBP/Blueprints に変更します。

  4. この時点でブループリント名を変更するかデフォルト設定の LaunchPad_Blueprint のままにすることができます。

  5. [Create Blueprint (ブループリントを作成)] をクリックします。

コンテンツ ブラウザ にユーザーのブループリントが表示されます。コンテンツ ブラウザ からレベルへドラッグ アンド ドロップ操作で、プラットフォームメッシュとトリガーのコピーを多数作成できますが、コピーにはビヘイビアはまだ付いていません。次の手順で、ジャンプ台と交差した時にキャラクターを起動させるために、ブループリント内にグラフノードを設定します。

BPQS_3_FinalResult.png

4 - 開始地点を作成する

Blueprint クラスを追加するには、ブループリント エディタ 内でそれを開く必要があります。

  1. コンテンツ ブラウザ で Blueprint クラスを ダブルクリック します。

  2. ブループリント エディタ が開いて、ビューポートに Cube コンポーネントと Box コンポーネントが表示されます。この時点で Box コンポーネントの配置を調整すると、この Blueprint クラスから作成するすべてのジャンプ台 (Launchpad) にも変更が適用されます。LaunchPad アクタ上でコンポーネントを動かす場合と同様に、[Components (コンポーネント)] リストから Box コンポーネントを選択して位置を修正できます。[Location (位置)] を (X:0, Y:0, Z:350) にします。

    BPQS_4_Step2.png

  3. [Viewport (ビューポート)] タブの横にドッキングされているのは [Construction Script (コンストラクション スクリプト)] タブと [Event Graph (イベントグラフ)] タブです。これからゲームプレイ ビヘイビアを作成するので、イベントグラフ から開始します。[Event Graph (イベントグラフ)] タブをクリックします。

    EventGraphStart.png

    イベントはブループリント グラフ実行の開始点であり、様々なゲームプレイ シチュエーションと関連付けることができます。最もよく使用するイベントの選択肢が、透明な Event ノードとしてすぐに表示されます。ほとんどのブループリント グラフで役立ちますが、1 つだけ作成します。

  4. Box コンポーネントに何かがオーバーラップすると実行するイベントを作成します。[Components] タブで Box コンポーネントを追加します。

  5. グラフに追加するノードのコンテキスト メニューを呼び出すために、グラフの空の領域を 右クリック します。

    グラフ内で動かすには、右クリックしてドラッグします。この時点で、グラフを左へ移動しておくと良いです。あらかじめ配置したイベント ノードをスクリーンの左側へ移動させて、ジャンプ台のロジックを作成するための余白を作ります。

    RightClickContext.png

  6. このコンポーネントにイベントを追加するには、[Add Event for Box (Box にイベントを追加)] ドロップダウン メニューを展開して [Collision (コリジョン)] を選択します。検索ボックスに「Component Begin Overlap」と入力するとメニューにフィルタを設定します。

  7. [On Component Begin Overlap] を選択します。

    BPQS_4_Step7.png

グラフに OnComponentBeginOverlap ノードが表示されます。このイベントに接続したすべてのノードは、ジャンプ台の Box コンポーネントと何かがオーバーラップすると実行します。

EventNode.png

次のガイドで、このノードの出力ピンへノードを接続して、ブループリント上のノードと連携させる方法について学んでいきます。

5 - オーバーラップしているアクタをテストする

現時点では、何かが Box トリガーにオーバーラップすると OnComponentBeginOverlap イベントが実行されます。ただし、対象のアバターまたはポーンのみがオーバーラップした場合に、ジャンプするビヘイビアを実行します。「Box トリガーにオーバーラップしているアクタは、ポーンと同じアクタか？」と考えてみてください。

OnComponentBeginOverlap イベントの Other Actor 出力を使用して設定していきます。

  1. OnComponentBeginOverlap イベントの Other Actor ピンをクリック、グラフの空のスペースにドラッグ、最後にピンをリリースするとコンテクストメニューが開きます。

    OtherActorContext.png

    互換性のあるノードのみを表示するために、コンテキスト メニューはユーザーが現在作業しているピンでフィルタが設定されています。

  2. 検索ボックスに「=」を入力して利用できるノードにフィルタをかけます。そして [Equals (Object)] を選択します。

    BPQS_5_Step2.png

    別の入力として Equals ノードに Side Scroller Character を設定することもできますが、使用している Character を変更した場合は、このブループリントで再び開いて手動で更新しなくてはいけません。そうではなくて、現在使用しているポーンへの参照を取得します。

  3. グラフの空のスペースを 右クリック してコンテキスト メニューを開きます。

  4. メニューの検索ボックスに「Player Pawn」と入力して、(Game の) [Get Player Pawn (プレイヤーポーンを取得)] を選択します。

    GetPlayerPawnMenu.png

  5. Get Player Pawn の Return Value 出力を Equals ノードの 2 番目の入力と接続します。

    BPQS_5_Step5.png

    Other Actor がプレイヤーがコントロールするポーンの場合はこれを示すノードを作成したので、応答に基づいてグラフの実行フローを変更します。つまり、On Component Begin Overlap ノードを去る時に直接実行フローへ指示を出します。従って Flow Control ノード、具体的には Branch ノードを使用します。

  6. OnComponentBeginOverlap ノードから実行ピンをドラッグして、グラフの空きスペースでリリースします。

    BPQS_5_Step6.png

  7. 検索ボックスに「Branch」と入力して、コンテキスト メニューから [Branch] を選択します。

    BPQS_5_Step7.png

  8. Equals ノードの出力ピンを Condition ノードの入力ピン Boolean につなぎます。

    BPQS_5_Step8.png

オーバーラップしているアクタがユーザーのアクタかどうかに合わせて、グラフに別のビヘイビアを設定して実行する準備ができました。次のステップでこれを実行します。等値 比較の結果が True の場合、キャラクターが起動するようにブループリント ノードを設定します。

6 - キャラクターを起動する

アンリアルのジャンプ台 (Launchpad) は Launch Character という関数を使用すると機能します。Launch Character 関数は、キャラクターの現在のベロシティに指定したベロシティを追加して、好きな方向に飛ばすことができます。この設定はキャラクターのみ有効です。必ずポーン (アバター) をキャラクター (人間そっくりのアバター) になるように設定してください。

設定はキャストで行います。キャスティングはユーザー入力を別タイプの入力に変換します。これにより特定タイプのみに有効な特殊機能へのアクセスが可能になります。入力がそのタイプに基づいていれば成功します。

後から追加が可能な特殊ビヘイビアも含めて、レベルに配置できるものはすべてアクタです。つまり、レベル内にあるすべてのものに対して参照を取得して、それを Actor にキャストすると成功します。ただし、ポーンは必ずしもゲーム内でキャラクターを表現するわけではないので、ポーン にキャストできない場合もあります。

  1. Get Player Pawn ノードから Return Value ピンを引き出します。

  2. コンテキスト メニューの検索欄に「Cast to Character」と入力して同じ名前のノードを検索します。

    CasttoCharacterMenu.png

  3. Cast To Character ノードから As Character を引き出します。

  4. 検索ボックスに「Launch」と入力して、コンテキスト メニューから [Launch Character (キャラクターを起動)] を選択します。

    BPQS_6_Step4.png

    クリックしてフルサイズ表示。

    正常にキャストするための出力実行ピンが Launch Character の入力実行ピンと自動接続することに注目してください。

  5. Launch Character ノードの Z フィールドに「3000」と入力します。

  6. 最後に、オーバーラップしているアクタが Pawn の場合のみ Cast to Character と Launch Character が発生するように Branch ノードの True 実行ピンを Cast to Character ノードの入力実行ピンと接続します。

    BPQS_6_Step6.png

    クリックしてフルサイズ表示。

    ここでツールバーのボタンで コンパイル と 保存 を行って、ブループリント エディタを閉じます。

  7. コンテンツ ブラウザ からジャンプ台をいくつかレベルへドラッグします。

    BPQS_6_Step7.png

  8. ツールバーの [Play (再生)] ボタンをを押すと、レベルを走り回ったり (WASD キー) ジャンプ (スペース バー) することができます。プラットフォームに着陸したり、飛行する様子を確認します。

7 - 応用編

クイックスタートガイドを通じて学んだ知識を活かして、以下の操作をしてみましょう。

  1. キャラクターを起動時に Audio コンポーネント を使用してサウンドを再生します。

  2. Launch Velocity を格納する 変数 を作成して、レベル内の各コピーにこの変数を設定できるように公開します。

  3. ブループリントに

    [パーティクルシステムのコンポーネント](designing-visuals-rendering-and-graphics/general-rendering-features/rendering-componentsコンポーネント)
    を追加して、スターター コンテンツ から パーティクルシステム を1つ使用します。

  4. Arrow コンポーネント を追加して、キャラクターを起動する方向を定義するためにコンポーネントの回転を使用します。

  5. タイムライン を使用して、キャラクターの起動を表現するために Box Mesh にアニメーションをいくつか追加します。

ブループリント ビジュアル スクリプティングに関する詳細は、「ブループリント」を参照してください。

クイック スタートガイドで取り扱った内容の詳細は、以下を参照してください。

  1. 各種 Blueprint クラスの概要は「ブループリント入門」を参照してください。

  2. ブループリントの詳細は、「Blueprint クラス」を参照してください。

  3. Blueprint クラスの作成と作業に関する簡単なチュートリアルは、「ブループリントの操作ガイド」を参照してください。

  4. ブループリント エディタに関する詳細は、「ブループリント エディタ」を参照してください。

タグ
Blueprints
Unreal Engine のドキュメントを改善するために協力をお願いします！どのような改善を望んでいるかご意見をお聞かせください。
調査に参加する
キャンセル